Watch a Twitch channel with Twitch-Channel-Points-Miner-v2, keep IRC presence while the stream is live, and stop when the stream ends.
+-------------------+
| cli.py setup |
+---------+---------+
|
v
local .env
|
v
+-------------+ +----+-----+ +-----------------------------+
| Twitch API +<--+ run.py +-->+ Twitch-Channel-Points-Miner |
+-------------+ +----+-----+ +-----------------------------+
|
v
Twitch IRC chat
- Waits until the configured stream goes live.
- Joins Twitch IRC for chat presence.
- Runs channel-points mining for watch streaks.
- Exits when the stream ends.
- Keeps credentials in a local
.envfile.
py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txtRun the setup wizard:
py -3 cli.py setupIt writes a local .env file:
TWITCH_AUTH_TOKEN=
TWITCH_USERNAME=
TWITCH_CHANNEL=
TWITCH_CLIENT_ID=TWITCH_AUTH_TOKEN may include the oauth: prefix. The saved value is normalized before use.
Check the config without printing secrets:
py -3 cli.py validatepy -3 cli.py runDirect runtime entrypoint:
py -3 run.pypy -3 cli.py setup create or update .env step by step
py -3 cli.py validate check required values, mask the token
py -3 cli.py run start the watcher
docker build -t twitch-watcher .
docker run --rm --env-file .env twitch-watcherRun PowerShell as Administrator:
py -3 setup_autostart.pyRemove the scheduled task:
py -3 remove_autostart.py.
|-- cli.py interactive setup, validation, launcher
|-- config_helpers.py .env parser and writer
|-- run.py watcher runtime
|-- setup_autostart.py Windows Task Scheduler registration
|-- remove_autostart.py Windows Task Scheduler cleanup
|-- requirements.txt Python dependencies
|-- Dockerfile container runtime
`-- .env.example config template
These paths are ignored and should stay local:
.env
.env.*
analytics/
cookies/
logs/
*.exe
Check before pushing:
git status --short --ignored