🛡️ TwitchDropSentry

Automatically watches Twitch streams and farms Time-Based Drops for your chosen game.

TwitchDropSentry is a lightweight, reliable Rust CLI tool that logs into your Twitch account and emulates stream viewing via the official Twitch GQL API - so you can collect drops completely hands-free.

Inspired by popular solutions like DevilXD/TwitchDropsMiner and similar Python-based farmers, this project focuses on being minimal, headless, and resource-efficient - no GUI, no browser, pure GQL emulation with optional proxy support.

✨ Key Features

• ✅ Automatic login - saves your session to data/save.json
• ✅ Smart campaign selection - groups active Twitch Drops by game
• ✅ Priority streams - finds and connects to the best live stream for the campaign
• ✅ Real viewing simulation - sends proper GQL events (powered by twitch-gql-rs)
• ✅ Live progress - beautiful real-time terminal progress bar
• ✅ Auto-claim - instantly claims drops with robust retry logic
• ✅ Progress tracking - saves claimed drops to data/cash.json
• ✅ Autostart - launches with your OS via data/settings.json
• ✅ Proxy support - HTTP/SOCKS5 proxies via data/settings.json (new in 0.3.6)
• ✅ Cross-platform - ready-to-use binaries for Windows & Linux + Docker support

🚀 Quick Start

1. Download the latest release from Releases
2. Run the executable
3. Log in to your Twitch account
4. (Optional) Edit data/settings.json for fully automatic operation, including proxy

📥 Installation

Prebuilt Binaries

Docker 🐳 (Community)

Maintained by @Addison-Usc: → Addison-Usc/TwitchDropBot

Build from Source

git clone https://github.com/this-is-really/TwitchDropSentry.git
cd TwitchDropSentry
cargo build --release

(Rust toolchain required)

⚙️ Settings (data/settings.json)

Since version 0.3.6 you can fully automate the tool, including proxy support:

{
  "game": "",
  "autostart": false,
  "proxy": ""
}

• "game" - game name (empty string "" = interactive selection)

• "autostart" - start automatically on system boot

• "proxy" - Proxy URL for all HTTP/GQL requests (new in 0.3.6).
  If empty (""), no proxy is used.
  Supported formats:

  Type	Example	Description
  HTTP	http://192.168.0.1:8080	Simple HTTP proxy
  HTTP + Auth	http://user:pass@192.168.0.1:8080	HTTP with username/password
  SOCKS5	socks5://192.168.0.1:1080	SOCKS5 proxy
  SOCKS5 + Auth	socks5://user:pass@192.168.0.1:1080	SOCKS5 with credentials

  Example with your provided format:

  "proxy": "socks5://2esfs:323e@192.168.0.1:8000"
  

Note: Proxy support was added in 0.3.6 (RC 6). Older versions ignore the "proxy" field.

🔍 How It Works

1. Logs into Twitch and stores credentials in data/save.json
2. Fetches all active Drop campaigns via GQL and groups them by game
3. Finds the best eligible live stream
4. Simulates watching by sending GQL events (uses proxy if configured)
5. Shows real-time progress in the terminal
6. Automatically claims the drop when time is reached
7. Saves claimed drops to data/cash.json

⚠️ Security Notice

Your credentials are stored in plain text in data/save.json (username + token).

• Use the tool only on trusted devices.
• We strongly recommend creating a dedicated Twitch account just for farming drops.
• The developer is not responsible for any account issues.
• Proxy usage can help hide your real IP - highly recommended for extra privacy.

🐞 Found a Bug?

The project is in Release Candidate stage and very stable.
If anything breaks, please open an Issue with your OS, version, and logs.

⭐ Support the Project

If you like the tool, please give it a star on GitHub!
It’s the best motivation to keep improving it.

❤️ Support the Developer

Your support helps bring new features faster and ensures long-term maintenance.

Made with ❤️ for the Twitch community
License: MIT
Version: 0.3.6 (Release Candidate 6)