Repository navigation
Home
Published from docs/README.md. To change this page, edit the source guide and open a pull request.
Twitch Drops Miner discovers eligible timed Twitch Drops, chooses live channels, and tracks and claims rewards without downloading stream video or audio. Use its web dashboard to choose games, follow progress, and manage settings.
Start with Installation, then Twitch login and Using the dashboard.
| Guide | What you will find |
|---|---|
| Installation | Docker, Compose, source setup, persistent data, and upgrades |
| Twitch login | Dashboard browser login, existing sessions, logout, and automatic renewal |
| Using the dashboard | Game priorities, campaigns, inventory, ignored rewards, and drop history |
| Dashboard access | Optional password protection, reverse proxies, and password recovery |
| Telegram notifications | Bot setup, testing, saved credentials, and disabling alerts |
| Troubleshooting | Login, renewal, progress, connection, and cache problems |
| Credits | Upstream authors, translators, contributors, and project support |
These guides describe the current source tree. Published versions may differ; check the release notes and available assets for your version. The installation guide explains how to use an unreleased source revision without mixing incompatible downloads.
This is a hobby project for personal use on your own hardware and home network. Support is best-effort and limited to that setup. VPS, cloud, other third-party hosting, and services operated for other users are outside the support scope. Continued compatibility with Twitch is not guaranteed.
Link the correct game account to receive in-game rewards. TDM skips campaigns reported as Not Linked by default; the optional override permits mining attempts without guaranteeing progress or delivery. The reward must be available to you and earned by watching. Review your Twitch Drops campaigns before mining. Avoid watching Twitch manually with the same account while the miner is running, because simultaneous viewing can disrupt drop progress.
For bug reports, translations, and other contributions, read CONTRIBUTING.md. Return to the project overview for the quick start and current contributors.