Skip to content

Getting Started

Jump to bottom
SimpliAj edited this page Jun 12, 2026 · 1 revision

Getting Started

Prerequisites

  • Python 3.8+ installed
  • PM2 (optional, for background running)
  • A Twitch account with drop campaigns linked

Installation

From Source (Recommended)

git clone https://github.com/SimpliAj/twitchdropsminer.git
cd twitchdropsminer
pip install -r requirements.txt

Run

# Single account
python main.py

# With custom port
TDM_PORT=8080 python main.py

# With PM2 (background)
pm2 start "python main.py" --name twitchdrops

First Login

  1. Open the dashboard at http://localhost:8080
  2. Click Login — a device code appears (e.g. ABCD-1234)
  3. Go to twitch.tv/activate and enter the code
  4. Authorize the app — you'll be redirected back
  5. Dashboard shows ● Connected when login succeeds

The session is saved to cookies.jar. As long as this file exists, you won't need to log in again.

Link Your Game Accounts

Before drops can be earned, you must link the game account to your Twitch account:

  1. Go to twitch.tv/drops/campaigns
  2. Find a campaign for a game you want
  3. Click Connect and follow the game's linking flow
  4. Return to the dashboard — the campaign will appear in the Main tab

Configure Priority Games

The miner follows a priority queue. Games listed higher are mined first.

  1. Go to Settings → Priority
  2. Add game names in order of preference
  3. The miner will focus on the highest-priority game that has active drops

Monitor Progress

Tab What you see
Main Current game, channel, drop progress
Inventory All campaigns + drop status
Channel Points Balance history per channel
History All claimed drops
Settings All configuration
System Restart, reload, logout, accounts
Help This documentation, in-app

Next Steps

Clone this wiki locally