Skip to content
josephistiredPublic

About

Auto Lurk is a Twitch bot that connects to the channels you choose and keeps your account present in chat for lurking. It uses twitch.js with a simple event-based setup, making it easy to configure, run, and keep online.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Latest commit

 

History

31 Commits

Folders and files

Repository files navigation

Auto-Lurk

Auto-Lurk is a Twitch chat bot that joins the channels you configure and keeps the account connected for lurking. The project has been restructured to use @twitchapis/twitch.js, and a small event-based layout instead of the old tmi.js setup.

What's Changed

  • Replaced tmi.js with @twitchapis/twitch.js.
  • Replaced Configuration/config.json with environment variables loaded from .env.
  • Split client setup and event handlers into separate files.

Prerequisites

  • Node.js 18.18 or newer
  • A Twitch OAuth token

You can generate a Twitch chat OAuth token from: Select Bot Chat Token

https://twitchtokengenerator.com/

Installation

git clone https://github.com/josephistired/Auto-Lurk.git
cd Auto-Lurk
npm install

Configuration

Create a .env file in the project root:

TOKEN=your_twitch_oauth_token

Then edit the channel list in config/client.js:

const client = new Client({
  channels: ["channel_one", "channel_two"],
});

Use Twitch channel names without #.

Starting The Bot

Run locally:

npm test

Or run the entry file directly:

node index.js

When connected, the bot logs Twitch chat messages to the console.

Docker

Build and run with Docker Compose:

docker compose up --build

Stop the bot:

docker compose down

Run On Startup

Auto-Lurk works best on a device that stays online, such as a Raspberry Pi or always-on desktop.

On Windows:

  1. Open bot.bat in File Explorer.
  2. Right-click it and select Create shortcut.
  3. Press Windows + R, type shell:startup, and select OK.
  4. Move the shortcut into the Startup folder.

On Linux or Raspberry Pi:

nohup node index.js &

License

This project is licensed under the MIT License. See LICENSE for details.

About

Auto Lurk is a Twitch bot that connects to the channels you choose and keeps your account present in chat for lurking. It uses twitch.js with a simple event-based setup, making it easy to configure, run, and keep online.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages