Farms automatically Twitch Drops, Points & Subscriptions for you!

Twitch has recently updated their drop claiming system, now including anti-bot detection. In the meantime, while the community finds a way to bypass it or new methods to claim them efficiently, we suggest you disable AutoClaim.

Don't worry, the bot will still farm the watch time; you will just need to manually claim them!

❗ UPDATE: We found a workaround!

🩹 🡢 Follow these steps carefully to bypass all issues

🤔 What is this Twitch Bot all about?

• Makes your twitch drop experience as easy as possible.
• No need to watch the stream in a browser, fully uses twitch inner gql.
• No need to care about who is online and when.
• Farm gifted subscriptions on any channel.
• Saves your twitch session providing you autologin.
• Collect endless points on your favorite channels.
• Can watch every Twitch Drop / Campaign available.
• Automatically claims your Drops.
• Switches automatically to other games or drops if drop is claimed/claimable or offline.
• Send Discord Webhooks to your server.
• Host 24/7 on heroku.

🔎 What is new in this enhanced version?

• Added argument & flags for skipping channel points
• Better designs, information and cooler readme 😎
• Attached bypasses for automatic drop claiming & log-in errors below
• New logs, webhook messages and removed useless ones causing cooldowns
• Fixed the drop claiming crashes, now the bot will move to a new game instead
• Modified the point claiming system slightly to mitigate some crashes

1️⃣🛠️ Bypass anti-bot for autoclaim

• How to automatically claim drops
  • Install Automatic Twitch on your browser
  • Goto twitch drops dashboard, Here
  • Make sure no extensions is able to kill the tab.
  • Leave the twitch tab open while TTVDropBot is running.
  
  

2️⃣🛠️ Work Around for Unable to log in

• Follow these steps
  • Create a file called twitch-session.json under the same directory of the application
  • Paste this inside the file [{"name":"auth-token","value":"replaceme"}]
  • Goto twitch drops dashboard, Here
  • Get a browser addon that can look at cookies, ( Addons: Opera, Chrome, Firefox, Edge )
  • Copy the auth-token and replace replaceme from above with your token
  
  
  • Save and close the editor you used then relaunch the bot.

## ⚡ **Installation**

1. Get the bot started ```bash docker run --rm -it ghcr.io/pockysweet/ttvdropbot/ttvdropbot:latest node ./build/index.js --displayless ``` 2. Get your token and then exit the bot with `Ctrl + C`

Go to twitch drops dashboard, Here

Get a browser addon that can look at cookies, ( Addons: Opera, Chrome, Firefox, Edge )

Copy the auth-token and replace TokenFromStep2 in step 3 with your token

3. Create the container ```bash docker run -d --name ttvdropbot \ -e ttvdropbot_displayless=true \ -e ttvdropbot_token=TokenFromStep2 \ -e ttvdropbot_games="Sea_of_Thieves Rust Lost_Ark No_Man's_Sky" \ -e ttvdropbot_autoclaim=true \ -e ttvdropbot_autopoints=false \ ghcr.io/Giingu/ttvdropbot/ttvdropbot:latest ``` ------------

0. Install **[GIT](https://github.com/git-guides/install-git)** on your computer
Learn how to install it [here](https://github.com/git-guides/install-git) 1. Open a terminal (CMD, PowerShell, Shell)
1.5 Clone the **[Repository](https://github.com/Giingu/Enhanced-TTVDropBot)** using the following command. ```bash git clone https://github.com/Giingu/Enhanced-TTVDropBot ``` 2. Install NPM packages. ```bash cd TTVDropBot/ npm install ``` 3. Run the bot via npm scripts. ```bash npm run start:production OR npm run start:dev ``` ------------

0. Download the **[Repository](https://github.com/Giingu/Enhanced-TTVDropBot/releases/download/v1.4.0/Enhanced-TTVDropBot.zip)** & extract it on a folder
You can download the latest version with the instructions on the image
Or through our releases by [clicking here](https://github.com/Giingu/Enhanced-TTVDropBot/releases/download/v1.4.0/Enhanced-TTVDropBot.zip) 1. Open a console / terminal (CMD, PowerShell, Shell) and go to the location of the extracted folder. ```bash cd ``` 2. Install NPM packages by using the following command. ```bash npm install ``` 3. Run the bot via npm scripts with these commands. ```bash npm run start:production OR npm run start:dev ``` ## 📚 **How to use the Bot?**

Step by Step Usage: Twitch Drops

**1. Step**

Select the way you want to Log in into your twitch account.

⚠️ If you cant login directly because of CAPTCHA use the browser method. ⚠️
⚠️ Only Chromium Browsers are supported like Brave and Chrome . ⚠️

 **2. Step**

Select Twitch Drops to watch a Twitch Campaign or Custom Channels if you want to add your own channels. Refer to Step by Step Usage: Custom Channels for those.

 **3. Step**

Select the campaign you want to start watching. If you want to only watch certain campaign and not all refer to Settings: Priority list

 **4. Step**

Select the Drop you want to start watching.

 **5. Step**

🎉 Enjoy! You are successfully watching your drop.


Step by Step Usage: Custom Channels

**1. Step**

Select Custom Channels to start watching them.

 **2. Step**

Fill in the needed information to add a Channel. They can always be modified in the customchannel.json

 **3. Step**

Select the Channel you want to start. The bot will switch between the Custom Channels, if one goes offline.

 **4. Step**

🎉 Enjoy! You are successfully watching your Custom Channel.


Step by Step Usage: Heroku

⚠️ Only Recommended for advanced users. ⚠️

**1. Step**

Click on the Deploy to Heroku Button at the top of the Readme

 **2. Step**

Login if necessary, and choose any app name you want, select your region and click Deploy app
After that let Heroku go through the build process and then click on Manage App

 **3. Step**

Go to the Resources tab and disable the web dyno and enable the worker instead

 **4. Step**

Click on more in the top right corner and then on Run console.
Type in bash and click Run.

 **5. Step**

Now run the command node ./build/index.js --showtoken in the Terminal.
Login Directly via command Line, until you see your auth token and copy it.

 **6. Step**

Close the Terminal and go to Settings then Reveal Config Vars
Now type in as key ttvdropbot_token and as value your copied token and click add
You can find more environment variables here

 **7. Step**

🎉 Thats it Enjoy! You are successfully watching.
To check if its working click on more in the top right corner then view logs.
Give it some time to start up, and you should see the bot working.

 --- ## 📝 **Settings** Down below you can find the settings Variables and what they do. ### Chromeexe - The path of your Browser: Linux: google-chrome | Windows: C:\Program Files\Google\Chrome\Application\chrome.exe ### UserDataPath - Providing a userdatapath, will give the loginpage the option to use cookies out of your browser. Option not really needed anymore. - You can find the UserdataPath under chrome://version then under Profile Path ### Webhook - The Discord Webhook URL: https://discord.com/api/webhooks/... ### WebHookEvents - Set what events should be send via webhook. - Defaults to: ["requestretry", "claim", "newdrop", "offline", "newgame", "get", "getresult", "progress", "start", "error", "warn", "info"] ### Debug - Will log important values to the console for debugging. ### Displayless - Give the ability to use the bot fully automated with no user input needed. Especially useful for gui-less systems. See [Ubuntu - No Gui](https://github.com/Giingu/Enhanced-TTVDropBot/#ubuntu) ### ForceCustomChannel - Force the bot to watch Custom Channels, only useful for display-less mode. ### ProgressCheckInterval - The time in ms, in what interval the progress should be checked. Recommended is `60000 ms - 60 s` anything under could cause twitch blocking your request. ### RetryDelay - The time in ms, in what interval failed requests should be retried. Recommended is `60000 ms - 60 s` anything under could cause twitch blocking your request. ### WaitforChannels - If set to false the Bot will no longer wait 5 Minutes for new Channels to come online. It will switch to another game instead. ### Prioritylist - A list of Games the bot should watch / prioritize. Only Provide games with active Drop Campaigns in this Format: `["Rust","Fortnite", "Elite: Dangerous"]` - You can get the valid name from: `https://www.twitch.tv/directory` - If provided the bot will only watch the games listed. ### AutoClaim - Allow the bot to autoClaim or not ### AutoPoints - Allow the bot to autoClaim points or not ### LogToFile - Log the Console to a file. ### UseKeepAlive - If activated uses Express to the keepalive the bot useful for stuff like Replit.
--- ## ✏️ **Start Arguments** All available start Arguments, basically everything which is also in the [settings.json](https://github.com/Giingu/Enhanced-TTVDropBot#-settings) file. ```bash ./Enhanced-TTVDropBot.exe --help Usage: ./Enhanced-TTVDropBot or index.js --arg... Options: --help Show help. [boolean] --version Show version number. [boolean] -c, --chrome The path to your Chrome executable. [string] -u, --userdata The path to your userdata folder location. [string] --webhook, --wh The Discord Webhook URL. [string] --webhookevents Set what events should be send via webhook. [array] -i, --interval The progress interval in ms. [number] --retryinterval, --retry The retry interval in ms. [number] -g, --games The Games the bot should watch. [array] --token Your twitch auth_token. [string] -d, --debug Enable Debug logging. [boolean] --displayless, --dl Enable Displayless mode. [boolean] --forcecustomchannel Force Custom Channels. Only useful for display-less mode. [boolean] --waitforchannels, --waitonline Disable waitforchannels, forcing the bot to not wait for other channels with drops instead switch the game. [boolean] --autoclaim Enable auto claiming drops. [boolean] --autopoints Enable auto collection of points. [boolean] --log Enable logging to file. [boolean] --usekeepalive Enable Express KeepAlive. [boolean] --tray Start app in the tray. [boolean] Examples: --chrome C:path:to:chrome.exe Sets your chrome path. --userdata C:path:to:userdata-folder Sets your userdata path. --webhook https:discord.com:api:webh.... Sets your webhook url. --webhookevents requestretry claim Defaults to the events in this newdrop offline newgame get getresult example provided. progress start error warn info --interval 30000 Sets the progress interval to 30s. --retryinterval 30000 Sets the retry interval to 30s. --games Rust Krunker 'Elite: Dangerous' Sets the Prioritylist to Rust, Krunker and Elite: Dangerous. --token yourkindalongtoken Sets the your current twitch auth token, overwriting any in twitch-session.json. ``` ## ✏️ **Environment variables** All these Start Arguments also work as environment variable: ```bash ttvdropbot_chrome = YourPath ttvdropbot_userdata = YourPath ttvdropbot_webhook = DiscordWebhookURL ttvdropbot_interval = 60000 ttvdropbot_games = Game1 Game2 Game3... ⚠️ Black Desert -> Black_Desert ⚠️ ttvdropbot_debug = true || false ttvdropbot_displayless = true || false ttvdropbot_forcecustomchannel = true || false ttvdropbot_waitforchannels = true || false ttvdropbot_autoclaim = true || false ttvdropbot_log = true || false ttvdropbot_usekeepalive = true || false ttvdropbot_retryinterval = 60000 ttvdropbot_webhookevents = Event1 Event2 Event3... ttvdropbot_showtoken = true || false Usefull for System were you cant access your twitch-session.json ttvdropbot_token = YourToken ttvdropbot_autopoints = true || false ``` ## 📘 Adding Custom Channels
 ### Name - The Name can be any String like `Rainbow Six, Best Ch ever etc...` ### Twitch Url - The Url is very important, never use the same Url twice, it has to be a valid Channel link and has always to start with `https://www.twitch.tv/`. Example for a Valid Url: `https://www.twitch.tv/rainbow6tw` ### How the Channel should be Watched `Watch until the time runs out:` - Watches the channel until the left time reaches 0 then switches to other custom channel. `Watch indefinitely:` - Watches the channel until it goes offline, then switches. ### Auto Points - Pretty simple, should the bot farm Points or not. ### Editing already Added Channel's - You can always edit Channel's which are already added in the [CustomChannels.json]('https://github.com/Giingu/Enhanced-TTVDropBot/#example-customchannelsjson'). --- ## 📄 Json Files Examples ### Example Settings.json ```json { "Chromeexe": "", "UserDataPath": "", "WebHookURL": "", "WebHookEvents": [], "debug": false, "displayless": false, "ProgressCheckInterval": 60000, "RetryDelay": 60000, "WaitforChannels": true, "Prioritylist": [], "AutoClaim": true, "LogToFile": true, "ForceCustomChannel": false, "UseKeepAlive": false "AutoPoints": false, } ``` ### Example CustomChannels.json ```json [ { "Name": "tarik", "TTVLink": "https://www.twitch.tv/tarik", "WatchType": "Watch until time runs out", "Time": "50" } ] ``` ### Example Twitch Session ```json [ { "name": "auth-token", "value": "yourtoken" } ] ``` ⚠️ _Never share your **Token** with anyone, because it gives full access to your account_ ⚠️ --- ## 🎉 Enjoy the bot and hopefully its helpful! [](https://github.com/Giingu) [](https://github.com/Giingu/Enhanced-TTVDropBot/stargazers) [](https://github.com/Giingu/Enhanced-TTVDropBot/watchers) [](https://github.com/Giingu/Enhanced-TTVDropBot/network/members) If you like my work feel free to buy me a coffee. ☕ [](https://ko-fi.com/Giingu) Have fun and Enjoy! 😃 --- ## 🍰 Contact **_Quickest Response:_**
Discord Server: https://discord.gg/rV26FZ2upF **_Slow Response:_**
Discord: - Vyper#1964 > Distributed under the MIT License. See LICENSE for more information.⚠️ _Modified with a lot of ❤️❤️ by **[@Giingu](https://github.com/Giingu)**_
_Log-in tutorial & claim switch by **[@cyberofficial](https://github.com/cyberofficial)**_
_Originally made by **[@Zarg](https://github.com/Zaarrg)**_