4 releases (2 stable)
| 1.0.3 | Feb 2, 2026 |
|---|---|
| 0.1.1 | Feb 1, 2026 |
| 0.1.0 | Feb 1, 2026 |
#1825 in Command line utilities
23KB
290 lines
Snap Coin MacOS CPU Miner
High-performance Snapcoin CPU miner for macOS, optimized for RandomX and designed to run under Rosetta (x86_64) on Apple Silicon for maximum hashrate and stability.
Features
- Full MacOS compatibility (Apple Silicon and Intel Mac)
- High Performance
- Fully Open-Source, built by miner for miners.
Requirements
macOS version: 11.0 (Big Sur)
Rosetta (Only for Apple Silicon Macs):
softwareupdate --install-rosetta
Rust (It can be installed by running this command):
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Node Preparation (Skip this step if on Intel Mac)
Important ⚠️
Snap Coin Node currently only works on Linux and Windows device, so you will need an pc for this to work. How to install an Node is described in this github repository:
https://github.com/snap-coin/snap-coin-node
Snap Coin needs an local node that is connected to the network for the miner to work. Unfortunately the node won't work on Macs, so we will need to do an port tunneling to windows or linux pc. This way the miner will see the port on the wifi not only localhost (User needs to be on the same network, otherwise it won't work)
Step 1 Windows: Install and enable OpenSSH Server
Install an OpenSSH Server
On Windows 10/11:
Open settings with:
Win + I
Then search:
Optional Features
and click on:
View Features
then on:
See Available Features
and there search for:
OpenSSH Server
and click install.
When the install is compleated open powershell as administrator and type:
Start-Service sshd
Set-Service -Name sshd -StartupType Automatic
check if it is running by:
Get-Service sshd
Step 2 Windows: Allow SSH through the firewall
Next you will need to allow SSH through the firewall Powershell as Admin:
New-NetFirewallRule -Name "OpenSSH-Server-In-TCP" -DisplayName "OpenSSH Server (sshd)" -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22
Step 3 Windows: Confirm you can log in via SSH
Now in cmd type this:
ipconfig
You will need to find something like this:
IPv4 Address . . . : 192.168.0.0
Write down the whole IPv4 adress, it will be needed later.
Also in cmd type this:
whoami
Example result:
DESKTOP-XXXX\<username>
Write down the username after the backslash , it will be needed later.
Step 4 Windows: Run the Snapcoin node
Now confirm the API is listenning locally (on Windows in powershell):
netstat -ano | findstr :3003
You should see it listening on 127.0.0.1:3003 or 0.0.0.0:3003. If it listens ONLY on 127.0.0.1:3003, tunneling is perfect.
Step 5 Mac: Verify you can SSH into Windows
First in terminal try connecting with the windows pc: (change the WINDOWS_USER and WINDOWS_IP with your username and ip)
ssh WINDOWS_USER@WINDOWS_IP
If you get a host key warning (changed), fix it:
ssh-keygen -R WINDOWS_IP
If everything works, go to the next step, if not check if you done everything step by step.
Step 6 Mac: Create the SSH tunnel (very important ⚠️)
On Mac in terminal paste this :
ssh -L 4003:127.0.0.1:3003 WINDOWS_USER@WINDOWS_IP
After running this you will need to keep the terminal opened at all times you want to mine. What it does:
- Local Mac port 4003
- Forwards to Windows localhost port 3003
Step 7 Mac: Confirm the tunnel works
Open a new terminal on Mac and run:
nc -vz 127.0.0.1 4003
If it says succeeded, congratulations tunnel works and you are ready to mine!
Node API you should use is:
"api": "127.0.0.1:4003"
Instalation
Download via Cargo
Download via cargo by using this command:
cargo install snapcoin-cpu-miner-macos
Download via Github (Manually)
First download the latest release on Github (It will be an zip file) or by running:
curl -L \
-o snapcoin-cpu-miner-macos.zip \
https://github.com/MansyonDev/snapcoin-cpuminer-macos/releases/latest/download/snapcoin-cpu-miner-macos.zip
Then extract it:
unzip snapcoin-cpu-miner-macos.zip
Make a folder (ex. snapcoin) and move the miner to the folder
mkdir snapcoin
mv snapcoin-cpu-miner-macos /snapcoin
And the installation is compleated.
Running the miner
Via Cargo (Intel and Apple Silicon)
After installing the miner, you can run it by running
snapcoin-cpu-miner-macos
You will be prompted with an error that says
config.json was not found.
A default config.json has been created.
Please edit it and put your SnapCoin wallet address inside.
An config.json file will be made where you will need to put an Snap Coin wallet address.
How to install an Snap Coin wallet is described in this github repository: (Wallet currently works only on Linux and Windows, so you will need an pc for this to work)
https://github.com/snap-coin/snap-coin-wallet
After getting an public key, enter it in the config.json in the "miner" space. (Double check if you entered the wallet key correctly otherwise you will not earn any SNAP)
Via Github (Manually)
Intel Macs
On Intel Macs in order to run the miner run this command:
./snapcoin-cpu-miner-macos
You will be prompted with an error that says
config.json was not found.
A default config.json has been created.
Please edit it and put your SnapCoin wallet address inside.
An config.json file will be made where you will need to put an Snap Coin wallet address. and also you will need to change the API port from 4003 to 3003 for the miner to correctly see the node. ("api": "127.0.0.1:3003") Only if you ran the node on the same laptop. Otherwise don't change it if running through windows.
How to install an Snap Coin wallet is described in this github repository: (Wallet currently works only on Linux and Windows, so you will need an pc for this to work)
https://github.com/snap-coin/snap-coin-wallet
After getting an public key, enter it in the config.json in the "miner" space. (Double check if you entered the wallet key correctly otherwise you will not earn any SNAP)
Apple Silicon Macs
On Apple Silicon Macs in order to run the miner you will need to have Rosetta installed on your system (Install by pasting this into terminal):
softwareupdate --install-rosetta
After the install run the miner by running this command:
arch -x86_64 ./snapcoin-cpu-miner-macos
You will be prompted with an error that says
config.json was not found.
A default config.json has been created.
Please edit it and put your SnapCoin wallet address inside.
An config.json file will be made where you will need to put an Snap Coin wallet address. Also make sure the API is pointing at ("api": "127.0.0.1:4003") and the node port tunneling is running, if not check the NODE PREPARATION to prepare.
How to install an Snap Coin wallet is described in this github repository: (Wallet currently works only on Linux and Windows, so you will need an pc for this to work)
https://github.com/snap-coin/snap-coin-wallet
After getting an public key, enter it in the config.json in the "miner" space. (Double check if you entered the wallet key correctly otherwise you will not earn any SNAP).
Disclaimer
This software is provided “as is”, without warranty of any kind, express or implied.
I am not the creator, owner, or maintainer of Snapcoin, and I am not affiliated with, endorsed by, or associated with the Snapcoin project or its developers in any way.
This project is an independent, third-party CPU miner that communicates with a Snapcoin node using publicly available interfaces.
I do not take responsibility for any loss of funds, loss of data, system instability, hardware damage, increased power usage, or any other issues that may arise from using this software.
Use this miner at your own risk.
Dev Fee
I implemeted an 1% dev fee from each block mined using this software, it really supports the development and keeps the motivation up. The fee is calculated by 1 block goes to developer (me ;) per 100 blocks mined by the miner so 99 blocks stay with the miner If you don't agree with the 1% dev fee, feel free to just go down to 0%.
Snap Coin Website: https://snap-coin.net/
Donate
You can buy the dev a coffee and support further development:
Bitcoin: bc1ql2qvl40qwrlrr4f6lrtmlkut4gmnhz3svm6ssq
Ethereum: 0xe4937cEf33F76644e9099CC9f89cC2f019AA95e1
Solana: FnFmo1826UdUhivzw871Tgu4MWUaLvn4fzy8eoJDRf89
Thank You!
Dependencies
~11–25MB
~304K SLoC