TypeScript icon, indicating that this package has built-in type declarations

1.0.6 • Public • Published


Discord Banner 2

npm version


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



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.


Chat Bot

const Omegle = require("omegle-api");

const client = new Omegle.TextClient();

client.on("message", async (message) => {
    client.send("You said: " + message);


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.
    new HttpProxyAgent("")

// And this will remove the proxy agent.

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, "");
    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!

Buy Me A Coffee

Package Sidebar


npm i omegle-api

Weekly Downloads






Unpacked Size

25.6 kB

Total Files


Last publish


  • blairspalace