This is just a compiled version of Twitch Channel Points Miner v2 (forked)
Note
The original version of Twitch Channel Points Miner v2 is currently unmaintained. Instead, this project uses an up-to-date fork by rdavydov.
-
✅ Intended to use without installing python
-
✅ Out-of-the-box usage
-
✅ Easy JSON configuration
-
❌ Replacement of the original project
-
❌ Up-to-date version: The python dependency needs to be manually updated and fixes incompatibilities and re-compile it again manually.
-
❌ 1:1 with the actual project: Even though the configuration follows the project examples, some manual changes need to be done to allow JSON configuration.
-
❌ Error-free: The
settings.json
keys need to follow the project configuration. The user is responsible for setting this error-free. -
❌ Python-less version: Under the hood, the executable is extracting and using python inside the Temporary folder of your OS.
You can compile it by yourself or use the precompiled binaries listed below on the releases page:
-
After downloading it, on the first run, a
settings.json
will be created so you can configure it. -
Go to the
settings.json
file, and configure your username (replaceyour-}twitch-username
value ofminer_settings.username
) and password (replaceyour-twitch-password
value ofminer_settings.password
)- You can remove the password key:value pair if you want to write it manually on the console.
-
Configure the rest to your liking (see #Configuration differences to avoid errors)
-
Open the executable and follow the instructions if needed.
Warning Pasting your password does not work as intended, please write it manually or set up in
settings.json
as indicated in the second step.
The /settings.json
file contains all the available configurations that are supported but, not limited to newer ones.
If you want to use pre-configured basic templates, you can hop and take a look into the /examples
folder and copy any of them.
To install an update, just replace the executable file with the newer executable version downloaded.
If an error occurs with your old settings and you are not sure how to solve it, you can always delete the settings.json
file so the executable can generate a valid version automatically.
The main difference between the settings.json
file with the actual python-written configuration of the original project is how functions and mapped values are handled:
Note You can compare the code of How to use section and the settings.json file to better understand these differences!
-
Mapped values
- Priority like
Priority.STREAK
, colorsFore.GREEN
, discord/telegram events likeEvents.STREAMER_ONLINE
, etc are written as strings without the event (e.g.STREAK
,GREEN
,STREAMER_ONLINE
, etc)
- Priority like
-
Functions
- Functions are written as objects with the key being their variable name and, inside that object, their arguments as key-value pairs. E.g.
color_palette=ColorPalette(...)
is wrote ascolor_palette: { "streamer_offline": "red", ... }
- Functions can nest other functions, just follow the same logic as above.
- Reminder: new functions need to be manually added.
- Functions are written as objects with the key being their variable name and, inside that object, their arguments as key-value pairs. E.g.
-
Logger
- The log level (used in
file_level
,console_level
, etc) is written as an integer. For example,logging.DEBUG
becomes10
,logging.INFO
becomes20
, etc. - Logging will always follow the logging module of python:
CRITICAL
: 50ERROR
: 40WARNING
: 30INFO
: 20DEBUG
: 10NOTSET
: 0
- The log level (used in
Before starting, you will need to have Git and Python3 installed.
# Clone this project
$ git clone https://github.com/ZEBAS204/twitch-miner-compiled
# Access
$ cd twitch-miner-compiled
# Create virtual environment (use the one you wish)
$ python -m venv venv
# Activate virtual environment
$ source venv/bin/activate
# Install dependencies
$ python -m pip install -r requirements.txt
# Download TwitchChannelPointsMiner's scripts
$ ./download_directory.sh
# Run the script locally
$ python TwitchFarm.py
# To compile the python script
$ ./compile.sh
# To clean the files left when testing and allow to start over
$ ./clean.sh
# If Analytics server is enabled, will initialize in the <http://localhost:5000>
Compiling the script into an executable will only produce an executable for your current platform and architecture. For more information, please refer to PyInstaller's "Building the Bootloader" documentation.
The executable name will follow as TwitchFarm-{OS_name_and_architecture}.{OS_exec_extension}
.
For more information about the OS name and architecture used, please refer to the Python sysconfig documentation.
# * Using a virtual environment is recommended *
# Compiling the python script
$ ./compile.sh
# Or without the help of the bash script
$ pyinstaller TwitchFarm.spec
# The executable will be placed inside the ./dist folder
The project follows the GNU V3 license and no modifications have been made to the original code. Instead, the project is a wrapper for the original code. This means that the project provides an interface for accessing and utilizing the functionality of the original code, without modifying its underlying implementation.