This project is a Python-based Discord bot designed to remotely manage and monitor an XMRig miner on Windows machines. It allows for seamless control through a dedicated Discord channel, providing real-time status updates and command execution. I have a few old pcs in my house, and i thought, why let them dust? so i made this script which helped me mine XMR on my pcs in the fastest setup and the most practical way there is.
This software is created strictly for educational and research purposes. Unauthorized use of this code on computers you do not own or have explicit permission to manage (Cryptojacking) is illegal and unethical. The author assumes no responsibility for any misuse or damage caused by this software.
- Automated Setup: Automatically downloads and configures the latest XMRig release if not present.
- Remote Discord Commands: Control the miner (Start, Stop, Restart) directly from your Discord client.
- Dynamic Worker Channels: Automatically creates a unique text channel for every worker/node in your server.
- System Persistence: Includes a keep_awake function to prevent the system from entering sleep or standby mode.
- Stealthy Execution: Runs the miner process in the background without a visible console window on Windows.
- Python 3.8+ installed.
- A Discord Bot Token (obtainable via the Discord Developer Portal).
- A Monero (XMR) Wallet Address.
Clone this repository and install the required dependencies: pip install discord.py requests
Open the script and edit the CONFIGURATION section with your specific details: DISCORD_BOT_TOKEN = "Your_Token" WALLET_ADDRESS = "Your_Wallet_Adress" DISCORD_SERVER_ID = 123456789 # Your Server ID OWNER_USER_ID = 123456789 # Your User ID (for permissions)
Execute the script to begin: python main.py
The bot will log into Discord, create a category named "Miner Farm Control", and open a channel named after your computer's node.
Interact with your worker by typing these commands in its dedicated channel:
- !start – Launches the mining process.
- !stop – Safely terminates the miner.
- !restart – Stops and immediately restarts the miner.
- !status – Displays an embed with current worker stats and node info.
- !help – Shows the list of available commands.
- Download Location: %LOCALAPPDATA%\MinerRuntime
- Executable Name: xmrig.exe
- Miner Source: Official XMRig GitHub Releases.