A simple script that will watch a stream for you and earn the channel points.
It can wait for a streamer to go live (+450 points when the stream starts), it will automatically click the bonus button (+50 points), and it will follow raids (+250 points).
Read more about the channel points here.
Please read the getting started guide to get set up quickly. For more advanced usage please read the advanced usage guide.
If you want to help with this project, please leave a star 🌟 and share it with your friends! 😎
If you have any issues, or you want to contribute, you are welcome! But please read the CONTRIBUTING.md file.
Note
The following points are only the base amount you can get. If you are subscribed you will see a proportionally larger number depending on your subscription tier.
- Mines channel points for up to 2 channels at a time
- Earns progress for basic rewards (+10)
- Claims bonus rewards (+50)
- Follows raids (+250)
- Earns progress for watch streak rewards (+300, +350, +400, or +450 depending on the streak count)
- Automatically recovers Watch Streaks (where possible) by watching Clips or VODs
- Makes progress for Weekly Rewards (+200, +250, +300, +350, depending on the week, plus unique chat badges)
- Advances progress for drops
- Claims any earned drops
- Makes predictions using your channel points
- Contributes to community goals using your channel points
- Claims moments
- Joins live channel IRC
- Sends events to fully customisable endpoints (Discord, Telegram, Matrix, Custom, etc...), including events for:
- Channel points gains/losses
- Stream up/down
- Prediction start/end/result
- Moments
- Raids
- User mentions in chat
- Analytics site showing charts with information about the miner's performance
- Fully configurable and extensible (see the example)
- Optional log anonymiser and secret redactor
Twitch does not allow you to earn channel points on more than 2 channels at the same time. We watch the first two streamers that have the highest priority according to your configuration.
Twitch does not all you to earn progress towards more than 1 drops campaign at the same time. When using the DROPS
priority, only a single streamer will be selected.
Issues running on Windows. It is not recommended to run the miner on Windows, although you are welcome to try
run.py MUST be mounted as a volume (-v) when using Docker.
If you don't mount the volume(s) for the analytics (or cookies or logs) folder, data will not be persisted between docker/miner restarts.
If you don't have a cookie file, or it's your first time running the script, you will need to log in to Twitch. The miner startup logs will prompt you with a URL you can use to log in.
If you need to run multiple containers you will need to bind different ports per container (only if you need also use the analytics) and mount different run.py file.
The miner works best when used in isolation. If you're using the miner's account with Twitch services (website, app,
etc...) at the same time as the miner you may see discrepancies in the miner's logs. For example, if the miner has
decided to watch streamer1 and streamer2, but you're watching streamer3 on the website, you'll run into Twitch's 2
stream watch limit. Twitch will decide internally to award channel points on 2 of the 3 streams at any given time. The
result for the miner may be that you don't get as many points for streamer1 and streamer2.
This project comes with no guarantee or warranty. You are responsible for whatever happens from using this project. It is possible to get soft or hard banned by using this project if you are not careful. This is a personal project and is in no way affiliated with Twitch.