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.
- Replaced
tmi.jswith@twitchapis/twitch.js. - Replaced
Configuration/config.jsonwith environment variables loaded from.env. - Split client setup and event handlers into separate files.
- 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/
git clone https://github.com/josephistired/Auto-Lurk.git
cd Auto-Lurk
npm installCreate a .env file in the project root:
TOKEN=your_twitch_oauth_tokenThen edit the channel list in config/client.js:
const client = new Client({
channels: ["channel_one", "channel_two"],
});Use Twitch channel names without #.
Run locally:
npm testOr run the entry file directly:
node index.jsWhen connected, the bot logs Twitch chat messages to the console.
Build and run with Docker Compose:
docker compose up --buildStop the bot:
docker compose downAuto-Lurk works best on a device that stays online, such as a Raspberry Pi or always-on desktop.
On Windows:
- Open
bot.batin File Explorer. - Right-click it and select
Create shortcut. - Press
Windows + R, typeshell:startup, and select OK. - Move the shortcut into the Startup folder.
On Linux or Raspberry Pi:
nohup node index.js &This project is licensed under the MIT License. See LICENSE for details.