twitchdrops_miner 0.3.6

Automatically watches Twitch streams and claims Time-Based Drops for selected games
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

# 🛡️ TwitchDropSentry
[![Discord](https://img.shields.io/discord/1437005378750775359?style=for-the-badge&logo=discord)](https://discord.gg/7H7n4RPtJG)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Rust](https://img.shields.io/badge/Rust-000000?style=for-the-badge&logo=rust&logoColor=white)](https://www.rust-lang.org)

**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](https://github.com/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**](https://github.com/this-is-really/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](https://github.com/this-is-really/TwitchDropSentry/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
| Platform | File              | Architecture |
|----------|-------------------|--------------|
| **Windows** | `TwitchDropSentry.exe` | x86_64      |
| **Linux**   | `TwitchDropSentry`     | x86_64 ELF  |

### Docker 🐳 (Community)
Maintained by [@Addison-Usc](https://github.com/Addison-Usc):
→ [Addison-Usc/TwitchDropBot](https://github.com/Addison-Usc/TwitchDropBot)

### Build from Source
```bash
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:

```json
{
  "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:**
  ```json
  "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](https://github.com/this-is-really/TwitchDropSentry/issues) 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
<div align="center">
  <a href="https://www.donationalerts.com/r/this_is_really">
    <img src="https://www.donationalerts.com/img/brand/donationalerts.svg" height="40">
  </a>
  <br><br>
  <a href="https://boosty.to/this-is-really">Boosty</a>
</div>

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

---
**Made with ❤️ for the Twitch community**  
**License:** [MIT](LICENSE)  
**Version:** 0.3.6 (Release Candidate 6)