Main

🤖 AUTO
Initializing...
Connected
—
Drops Today
—
Drops Total
—
Points Today

Campaign Progress

No active drop

Channel Points

— not watching

Logs

Channels

Wanted Drop Queue

No wanted drops queued...

No campaigns loaded yet...

System

General

Leave empty to disable. Supports HTTP/HTTPS/SOCKS.

Login & Password

System

Instances

Each instance runs a separate TDM process with its own Twitch session.

Already running an instance yourself (custom port, another host/container)? Register it here — nothing is started, stopped, or reconfigured.

Diagnostics

Reporting a bug? Download the log file and attach it — makes it far easier to pin down what happened.

Saves deidentified miner state and recent sanitized API responses to the diagnostics folder in this account's data directory.

Twitch Accounts

Switch between saved Twitch logins within this instance.

Miner

Reload campaigns and restart the mining loop.

Restart

Stop the miner process. PM2 will restart it automatically.

Session

Log out of the web interface.

Twitch Account

Forget the saved Twitch session and log in again. Your dashboard password and other settings are kept.

Notifications

Browser

Discord Webhooks

Fires when a Twitch drop is successfully claimed. Fires when a bonus channel point chest is claimed. Fires when the Twitch login has been waiting for 30+ minutes or mining stalls, and again when it recovers. Empty: uses the drop webhook.

Discord Bot

Pair a Discord bot to control TwitchDropsMiner via chat commands.

Invite bot
Mining

Mining Benefits

Select which types of drops you want to mine.

Drop Name Blacklist

Comma-separated keywords. Drops whose name contains any keyword are ignored. Useful for regional/exclusive drops (e.g. JP, Korea, (KR)).

Blacklisted Drop IDs

Specific drops excluded by exact ID — added via the đŸšĢ button next to an active drop, or manually below. Unlike the keyword blacklist above, this matches one exact drop; other drops for the same game keep mining.

Blacklisted Games

Games listed here are never auto-added to Games to Watch by "Auto-add linked games", even if Twitch links a drop campaign for them. Removing a game from Games to Watch already does this automatically — use this list to blacklist a game directly, without adding it first.

Scheduler

Automatically pause and resume mining based on time of day.

Mining runs only within this window. Outside it, mining is automatically paused.

Games to Watch

Select games to watch. Order matters - drag to reorder priority (top = highest priority). Games are auto-removed once every drop is claimed or unearnable (e.g. sub-only tiers) — for games you always want tracked, use ⭐ Preferred Games below instead.

Selected Games (drag to reorder)

Available Games

Idle & Points

Idle Watch

Channels to watch when no drops are available. Add in priority order.

⭐ Preferred Games

Games that are always watched — even without active drop campaigns. Auto-connects when a campaign appears. Never auto-removed.

Channel Points

Automatically claims the bonus chest when it appears on watched channels.
Predictions

đŸŽ¯ Auto-Bet

Automatically bet channel points on predictions.

📋 Channel Whitelist

Only bet on predictions in these channels. Leave empty to bet on all channels.

⚙ī¸ Per-Channel Overrides

Override global prediction settings per channel. Leave a field empty to use the global value.

Drop Statistics

—
Total Claims
—
Games
—
Channel Points

Claims by Game

Drop History

No drops claimed yet.

Channel Points

No channel points data yet. Points are recorded while watching channels.

📈 Points Over Time

Predictions History

Time Channel Prediction Selection Bet Result Won
🚀

Getting Started

Twitch Drops Miner automatically earns timed Twitch drops without downloading any stream video — saving bandwidth while collecting rewards 24/7.

1
Log in with Twitch

If TDM runs on this computer, a normal browser window opens on the Twitch login page — log in there. If TDM runs on a server, the Login panel in the Main tab shows a command: run it on your PC and log in in the browser window it opens. Your Twitch password is never stored.

2
Link game accounts

Visit twitch.tv/drops/campaigns and connect each game's account (Steam, Epic, etc.) to your Twitch profile. Drops won't be delivered without this step.

3
Configure priority games (optional)

Open Settings → Priority Games and add games you want to target first. The miner works all campaigns by default if no priority list is set.

4
Watch it run

The Main tab shows the active channel, current drop progress, and live channel points balance. The Inventory tab tracks all claimed drops.

ℹī¸
No stream video is downloaded. The miner sends only the minimal Twitch API heartbeats needed to accumulate watch time — bandwidth usage is negligible.
⛏ī¸

Drop Mining

How It Works

The miner discovers all active drop campaigns via the Twitch API, picks a live channel that qualifies for each drop, and sends periodic watch-time signals. No video is ever buffered or downloaded.

Auto Channel Switching

If the current channel goes offline, ends the drop window, or loses drop eligibility, the miner automatically switches to the next best channel — no intervention needed.

Game Priority Queue

Add games to Settings → Priority Games. Games appear in order — the miner finishes the first game's drops before moving to the next. Unlisted games are queued after all priority games.

Drop Name Blacklist

In Settings → Blacklist you can exclude specific drop names (e.g. duplicates you already own). The miner skips any drop whose name matches an entry in the list.

Manual Controls

ControlWhereEffect
Manual ModeMain tab togglePause automatic game selection; you choose which campaign to watch
Skip GameMain tab buttonSkip all remaining drops for the current game and move to the next in queue
Check for DropsMain tab buttonManually refresh campaign list (equivalent to page reload)
Reload CampaignsSystem tabForce a full campaign reload and restart the mining loop

Inventory & Campaign Drops

The Inventory tab shows all campaigns as cards in a 3-column grid.

  • Click a campaign name → popup showing all drops with images, progress bars, and status
  • Click ▸ N drops left → same popup filtered to unclaimed drops only (only shown for linked campaigns)
  • ⛏ Farming / ⊘ Skip toggle → add or remove the game from your watch list without going to Settings
  • Expired or fully-claimed games are automatically removed from the Wanted Queue
⚠ī¸
Do not watch streams on the same Twitch account while mining. Twitch only counts watch time from one source at a time.
đŸ‘Ĩ

Multi-Account

Run unlimited Twitch accounts simultaneously, each with fully isolated data, settings, and sessions.

➕
Go to System → Instances to add or remove accounts from the dashboard — no config files needed. Nginx updates automatically.
InstancePortURL
Account 18080/
Account 28082/acc2/
Account N8080+(N-1)×2/accN/

The account buttons in the top header show the actual Twitch username once logged in. Each instance has its own:

  • Cookie/session storage
  • Priority games and blacklist
  • Discord bot/webhook settings
  • Channel Points history
  • Idle watch channel list
⚠ī¸
Running 3+ instances on one IP may cause Twitch to flag the accounts. Use proxies if you run more than 2 accounts.
💡
To rename an account label shown in the header and Discord bot footer, go to System → Accounts and click the ✏ī¸ edit button next to the account.
💰

Channel Points

While the miner watches a channel, it also earns and tracks Channel Points automatically.

Auto-Claim Bonus Chests

When a bonus chest appears on a watched channel, the miner claims it immediately. No manual interaction required.

Live Balance

Your current point balance for the active channel is shown in real time at the top of the Main tab.

Full History

The Channel Points tab lists every earn/spend event across all watched channels with timestamps and amounts.

Idle Watch Points

Points are also earned while Idle Watch is active (even when no drops are available), so watching keeps accumulating value.

đŸŽ¯

Auto-Betting

The miner can automatically place bets on Twitch Predictions using your Channel Points, picking an outcome with one of four selectable strategies. Configure it in Settings → Predictions → Auto-Bet.

⚠ī¸
Auto-Bet is disabled by default. Enable it explicitly if you want the miner to risk your channel points automatically — it isn't on unless you turn it on.

Betting Strategies

StrategyHow it picks an outcome
SMARTCompares the vote share of the top two outcomes. Bets on whichever has more voters, but only if the gap between them is at least the configured Bet Gap % — if the vote is too close to call, the prediction is skipped entirely.
PERCENTAGEAlways bets, choosing the outcome that already has the most points wagered by others (the current crowd favorite by points).
HIGH_ODDSAlways bets on the underdog — the outcome with the fewest points wagered, which pays out at the highest odds if it wins.
MOST_VOTEDAlways bets on whichever outcome the most individual users picked, regardless of how many points they wagered.

Configuration

SettingDescription
Enable Auto-BetGlobal on/off switch. Predictions are ignored entirely while off.
StrategyWhich of the four strategies above to use.
Bet Gap % (SMART)Minimum vote-share gap between the top two outcomes required for SMART to place a bet. Only applies to the SMART strategy.
Bet % of balanceWhat percentage of your current point balance on that channel to wager.
Max points per betHard cap on any single bet, regardless of the percentage above.
Min balance to betThe miner sits out predictions entirely if your balance on that channel is below this floor.
Delay before lock (s)How long to wait after a prediction opens before betting, so more votes accumulate first. Automatically shortened if the prediction's own voting window would lock sooner.

Channel Whitelist & Overrides

By default Auto-Bet applies to every channel you watch. Add channels to the Channel Whitelist to restrict betting to only those, or use Per-Channel Overrides to give a specific channel its own strategy, percentages, or delay — any field left empty falls back to the global setting.

Result Tracking

Every bet is logged to the Predictions History table on the Analytics tab, showing the channel, prediction, your selection, the amount wagered, and the result once it resolves.

Discord Alerts

If a Discord webhook is configured for points, a win/loss embed with your profit or loss is posted automatically for every resolved bet.

💡
Twitch's own minimum bet is 10 points, so the miner never wagers below that even if your percentage setting would round lower. Bets also only fire on channels the miner is actively watching (drop-farming or Idle Watch) — it won't bet on channels it isn't currently mining.
đŸ“ē

Idle Watch

When no active drop campaigns are running, Idle Watch keeps the miner watching channels so you continue earning Channel Points.

Configuration

SettingDescription
Manual channel list Add specific channel names in Settings → Idle Watch. The miner rotates through these when idle.
Auto: use followed channels Enable this toggle to automatically fetch your live followed channels from Twitch and watch whichever are currently streaming.

Quick Controls

The Quick Controls panel in the Main tab shows Start Idle and Switch Channel buttons when Idle Watch is active, letting you manage it without navigating to Settings.

💡
Idle Watch is automatically paused when a drop campaign becomes available and resumes when mining finishes.
🤖

Discord Bot

Control your miner and receive live notifications directly from Discord. Supports multiple servers simultaneously.

Setup

1
Generate a pairing code

Go to Settings → Discord Bot and click Generate code. A code like DROPS-A1B2C3D4 is shown (valid for 10 minutes).

2
Link from Discord

In any Discord server or DM where the bot is present, run:

/link http://your-server:8080 DROPS-A1B2C3D4

The bot replies with ✅ Connected when the link is established.

3
Set notification channels (optional)

Run /setchannel drops and/or /setchannel points in the channels where you want alerts sent.

Commands

CommandDescription
/link <url> <code>Connect this Discord server to your dashboard instance
/unlinkDisconnect the bot from this server
/setchannel dropsSend drop claim notifications to the current channel
/setchannel pointsSend Channel Points notifications to the current channel
/dashboardPost a live embed showing miner status (auto-updates every 30 s)
ℹī¸
The account name shown in the bot embed footer comes from System → Accounts. Use the ✏ī¸ button to rename it. The pairing code expires in 10 minutes — generate a new one if it times out.
🔔

Discord Webhook

A simpler alternative to the bot — paste a webhook URL and get push notifications for drops and/or channel points without any bot setup.

1
Create a webhook in Discord

Server Settings → Integrations → Webhooks → New Webhook. Copy the URL.

2
Paste the URL in Settings

Go to Settings → Discord Notifications. There are separate URL fields for Drop notifications and Channel Points notifications — you can use the same or different webhooks.

3
Test it

Click Test Webhook to send a sample message and confirm delivery.

ℹī¸
Webhook notifications include the account name in the footer so you can tell which instance claimed a drop when running multiple accounts.
🌐

Remote Access

To use the Discord Bot or access the dashboard from outside your network, your TDM instance needs a public URL. Choose the method that fits your setup.

Ports

InstancePort
Account 18080
Account 28082

Works on any machine — home PC, VPS, laptop. No router config, no open ports. Cloudflare gives you a free HTTPS URL instantly.

1 — Install cloudflared
curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb -o cloudflared.deb && sudo dpkg -i cloudflared.deb
2 — Start tunnel (Account 1)
cloudflared tunnel --url http://localhost:8080

Cloudflare prints a URL like https://random-name.trycloudflare.com — use that as your public URL.

3 — Link Discord Bot

In your Discord server, run:
/link https://random-name.trycloudflare.com YOUR_CODE

⚠ Free Cloudflare URLs change every restart. For a permanent URL, create a free Cloudflare account and set up a named tunnel.

💡

Tips & Tricks

Force a campaign refresh

Click Check for Drops in the Main tab to immediately re-fetch campaigns from Twitch without restarting the process.

Restart safely

Use System → Restart Miner. If you're using PM2, it will restart automatically and resume mining within seconds.

Linked accounts required

Drops are only delivered if your game account is linked at twitch.tv/drops/campaigns. Check this first if drops aren't appearing in-game.

Account management

Add, remove, or rename accounts in System → Accounts. Labels appear in the header buttons, Discord bot footer, and webhook notifications.

📁 GitHub Repository 🔗 Twitch Campaigns
🔔

Notifications

Configure notification settings in Settings → Notifications.

SettingDescription
Notification SoundPlay a sound when a drop is claimed.
Campaign End AlertsGet notified via Discord webhook when a campaign ends in less than 24 hours and you still have unclaimed drops.
📊

Stats Tab

The Stats tab shows an overview of all your claimed drops across both accounts.

Summary

Total claims, number of different games, and date of your last claim.

Claims by Game

Horizontal bar chart showing your top 10 games ranked by total claims.

Recent Claims

Your 10 most recent drop claims with reward images where available.