A Node.js bot that uses Puppeteer to automatically watch Twitch streams and claim drop rewards.
The recommended way of using this bot is to use Docker.
latest - The latest development version. This includes all commits from the dev branch.
latest-release - The latest release version. This includes all commits from the master branch.
vX.X.X - Specific release versions.
Pull the latest release image with docker pull ghcr.io/tychothetaco/twitch-drops-bot:latest-release.
Use one of the following commands to start the container. Make sure you run this command in the same directory as config.json, since it will map the current directory to the /app/data directory in the container. If this is the first
time running the bot, a default config.json file will be created in the current directory.
Windows (Command Prompt): docker run --rm -v "%cd%":/app/data -i -t --sig-proxy=false ghcr.io/tychothetaco/twitch-drops-bot:latest-release
Windows (PowerShell): docker run --rm -v "${PWD}":/app/data -i -t --sig-proxy=false ghcr.io/tychothetaco/twitch-drops-bot:latest-release
Linux: docker run --rm -v "${PWD}":/app/data -i -t --sig-proxy=false ghcr.io/tychothetaco/twitch-drops-bot:latest-release
To detach from the docker session without terminating it, use CTRL-P CTRL-Q.
docker: Error response from daemon: create %cd%: "%cd%" includes invalid characters for a local volume name, only "[a-zA-Z0-9][a-zA-Z0-9_.-]" are allowed. If you intended to pass a host directory, use absolute path.
You are using the Command Prompt command above, but are not using Command Prompt as your terminal. Make sure to use the correct command for your OS/terminal.
- By default, the bot will attempt to watch all games. You can change which games that the bot watches by specifying game names or IDs in the config file. See
games.csvfor the game IDs. - Add your username to the config so that the bot can reuse the correct cookies, so you don't have to log in again everytime the bot is restarted.
- Install Node.js (Requires version 16+)
- Install Google Chrome
- Install this package:
npm install . - Build the app:
npm run build - Start the bot with
node dist/index.jsornpm run start. If there is no configuration file, a default one will be created. - Customize your config.json. (Restart the bot for changes to be applied)
- By default, the bot will attempt to watch all games. You can change which games that the bot watches by specifying game names or IDs in the config file. See
games.csvfor the game IDs. - Add your username to the config so that the bot can reuse the correct cookies, so you don't have to log in again everytime the bot is restarted.
- By default, the bot will attempt to watch all games. You can change which games that the bot watches by specifying game names or IDs in the config file. See
After updating your install, re-run npm install . and npm run build.
Make sure to install the latest version of Node.js, look at this link.
To install Node.js 16 use the following commands:
$ sudo curl -sL https://deb.nodesource.com/setup_16.x | bash -
$ sudo sudo apt-get update && apt-get install -y nodejsSee Options for a list of all available options.
If you want to update the list of games found in games.csv, just run npm run updateGames or npm run u.
Error watching stream
When this happens, its usually because the stream page did not load fast enough. It's normal for this to happen occasionally, but if it happens often, it might be due to a slow or unstable network connection. This can also happen if you're using a low-power system such as a Raspberry Pi.
Try increasing load_timeout_secs to 60 or 90.
Yes, you can use this bot for any game! The games.csv file is provided for convenience and might be missing some games, but you can find a game's ID yourself by following these steps.
Open the game's main page on Twitch, for example, Rocket League: https://www.twitch.tv/directory/game/Rocket%20League. Right-click the game's image. Click Inspect Element. You should see something like this:
<img alt="Rocket League" class="tw-image" src="https://static-cdn.jtvnw.net/ttv-boxart/30921-144x192.jpg">
The number in between ttv-boxart/ and -144x192.jpg is the game ID. In this example it is 30921.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent