Omegle-API
About
Omegle-API is a single-depency wrapper around the 'chat roulette' website Omegle, allowing for easy automation & botting for the platform. There's some other libraries that do the same, but this one is built from the ground up using the javascript source with built in Proxy Support
Usage:
Events
| Event | Content | Description |
|---|---|---|
| status | OmegleStatusObject | Fired when Omegle sends status information, usually at the end or start of a session. |
| connect | None | When the client successfully starts a session. |
| message | String | When the user sends a message to the bot. |
| captcha | String | When Omegle requests a captcha to be solved. |
| digest | String[] | An array containing hashed common interests between the two users. |
| disconnect | None | When a session ends. |
| typing | None | When a user starts typing. |
| blocked | None | When an IP address is blocked from creating sessions. |
| raw | string[] | The raw form of any event. |
Examples
Chat Bot
const Omegle = require("omegle-api");
const client = new Omegle.TextClient();
client.on("message", async (message) => {
client.send("You said: " + message);
})
client.connect();Specific Topics
const Omegle = require("omegle-api");
const client = new Omegle.TextClient();
client.connect(["applebees", "programming"]);Proxy Support
const Omegle = require("omegle-api");
const HttpProxyAgent = require("http-proxy-agent");
const client = new Omegle.TextClient();
// All requests will be routed through this proxy now.
client.setAgent(
new HttpProxyAgent("http://proxy.example.com:8080")
);
// And this will remove the proxy agent.
client.setAgent();Recaptcha Support
Omegle throws recaptcha requirements when you do too many new sessions. To get around this, using proxies is advised but you can alternatively use services like 2captcha to solve them automatically, though this costs money.
const Omegle = require("omegle-api");
const TwoCaptcha = require("2captcha");
const solver = new TwoCaptcha.Solver("<2captcha token here>");
const client = new Omegle.TextClient();
client.on("disconnect", async () => {
await client.connect();
})
client.on("message", async () => {
await client.send("Hiya!")
})
// Once you start getting captchas, you will get them every time you try to connect for 12-24 hours.
client.on("captcha", async (token) => {
const solution = await solver.recaptcha(token, "https://omegle.com/");
await client.sendCaptcha(solution);
await client.connect();
})Commit Guidelines
The latest version of the code base will always be under the 'next' branch!
- All pull requiests must provide a valid reason for the change or implementation
- All CORE CHANGES require an issue with reasoning made before a PR will even be addressed.
- All PR's must follow the general structure of the code base
- If you have questions, feel free to make an issue and i'll get to it right away!
