Money4Band

Earn passive income from your unused bandwidth - one command, all apps.

If you like this project, leave a . It helps more than you think.

---

Table of Contents

• What is Money4Band?
• Prerequisites
• Quick Start
• Key Features
• Supported Apps
• Release targets
• Documentation
• Community & Support
• Contributing

---

What is Money4Band?

Money4Band (M4B) turns your unused internet bandwidth into passive income. That bandwidth is there anyway whether you're using it or not. Why not put it to work? One command. All the bandwidth-sharing apps. Each one runs in its own isolated Docker container, so your system stays clean, your setup is safer than installing each app natively, and you earn more than any single app could deliver alone.

Our maintainers and community research every app, verify its background, track payout history, and monitor real-world behavior over time. You don't have to figure out which apps are legit and which are a waste of time. That work is already done.

Prerequisites

Requirement	Details
Docker	Docker Engine 20.10+ or Docker Desktop
OS	Windows 10/11 (WSL2), Linux, macOS
Architecture	amd64 or arm64
RAM	1 GB minimum (2 GB+ recommended)
Python	3.10+ (only for "from source" installs)

Quick Start

Option A: Download & Run (recommended)

1. Select the v5 release on the Releases Page.
2. Download the single-file binary for your OS and architecture (e.g. Money4Band-windows-amd64.exe, Money4Band-linux-arm64)
3. Run the downloaded executable directly. Choose the separate source ZIP if you want an archive.

Windows: double-click the .exe, or run it from PowerShell to pass CLI subcommands. Unsigned build, so SmartScreen asks: More info > Run anyway.

.\Money4Band-windows-amd64.exe

# Linux. Downloads arrive without the executable bit
chmod +x Money4Band-linux-arm64 && ./Money4Band-linux-arm64

# macOS. Unsigned build, clear the Gatekeeper quarantine flag first
xattr -d com.apple.quarantine Money4Band-macos-arm64
chmod +x Money4Band-macos-arm64 && ./Money4Band-macos-arm64

First run creates config/ and template/ next to the executable, so put it in a dedicated directory. Docker group setup, noexec mounts and checksum verification are covered in the Getting Started guide.

Option B: From source

git clone https://github.com/MRColorR/money4band.git && cd money4band
uv sync --locked && uv run --locked python main.py

No uv? pip install -r requirements.txt && python3 main.py also works.

Even simpler: python run.py auto-detects uv (or falls back to a local venv + pip) and starts the app in one step. run.bat / ./run.sh are one-click wrappers for Windows / macOS-Linux.

See the Full Setup Guide for details.

What Happens Next?

1. Follow the guided setup. M4B walks you through configuring each app.
2. Start the stack. One command launches everything.
3. Watch it work. Check your dashboard, see the earnings come in.

---

Key Features

• CLI + Guided Setup. Interactive wizard for beginners, m4b subcommands for power users - no Docker Compose files or manual configs needed.
• Safer than running apps natively. Every app runs in its own isolated Docker container - no host installs, no conflicts, no leftover junk.
• Encrypted credentials. All tokens, passwords, and API keys are encrypted at rest. Nothing is stored in plain text.
• Multi-proxy scaling. Multiple IPs, multiple instances, one unified configuration.
• Auto-updates. Watchtower keeps every app image fresh without you doing anything.
• Web dashboard. All your apps, one clean interface.
• Auto-claim sidecars. Daily rewards like Lucky Pot are claimed automatically for you.
• Resource limit profiles. Fine-tune CPU and RAM per app with simple presets.
• IP quality scoring. Know your IP reputation before deploying.
• Backup & restore. One command to back up or restore your encrypted config.
• Webhook notifications. Stack events pushed to Discord, Telegram, or anywhere Shoutrrr reaches.
• Cross-platform. Windows, Linux, macOS. amd64 and arm64.
• Self-update. m4b update keeps the CLI itself up to date.

---

Supported Apps

The table covers the built-in catalog. See the app directory for details and the community catalog for opt-in entries.

[ok] Built in. [x] Removed from default setup.

App links below include referral codes that support the project at no cost to you.

Type	App	Residential	VPS/DC	Payout
[ok]	AntGain	[ok]	-	-
[ok]	Bitping	[ok]	[ok]	BITPING token (crypto), USDC
[ok]	Earn.FM	[ok]	[ok]	PayPal, USDT, gift cards
[ok]	Honeygain	[ok]	[x]	JumpToken (crypto), PayPal (via JumpTask)
[ok]	Mysterium	[ok]	[ok]	MYST token, ETH, BNB
[ok]	PacketStream	[ok]	[x]	PayPal
[ok]	Pawns (IPRoyal)	[ok]	[x]	PayPal, crypto, gift cards
[ok]	ProxyLite	[ok]	[ok]	crypto
[ok]	Proxyrack Peer Program	[ok]	[ok]	PayPal, crypto
[ok]	Repocket	[ok]	[ok]	PayPal, crypto
[ok]	Titan Network	[ok]	-	-
[ok]	TraffMonetizer	[ok]	[x]	PayPal, crypto, wire transfer
[ok]	URnetwork	[ok]	-	-
[x]	BearShare	[ok]	-	-
[x]	PacketShare	[ok]	-	-

Registration links, earnings estimates, and full details

Apps you install yourself

Run EarnApp directly on an eligible personal device using the provider's installer. See the standalone apps list.

---

Release targets

Platform	Architecture	Devices
Windows (WSL2)	amd64	Desktop, Laptop
Linux (Debian/Ubuntu)	amd64, arm64	Desktop, Laptop, Raspberry Pi
macOS	amd64, arm64	MacBook Pro

---

Documentation

Getting Started	CLI Reference
Dashboard & API	Proxy & Multi-Proxy
App Management	Configuration
Security	Notifications
FAQ & Troubleshooting	App Directory

---

Community & Support

• Discord for chat, help, and shared experiences
• Discussions for feature requests and ideas
• Issues for bug reports

Contributing

Contributions are welcome! Please read the Contributing Guide and Code of Conduct before opening a pull request.

---

Support

Ko-fi supports Mattia / MrColorRain's work across projects.

Support ongoing development, testing and documentation through Ko-fi. One-time contributions and monthly memberships are welcome, and you can pledge above a tier's minimum. Technical decisions remain independent.

See the supporters and sponsors directory for acknowledgments.

---

Stargazers

---

[!] Disclaimer

This project and its artifacts are provided "as is" and without warranty of any kind. The author makes no warranties, express or implied, that this script is free of errors, defects, or suitable for any particular purpose. The author shall not be retained liable for any damages suffered by any user of this script, whether direct, indirect, incidental, consequential, or special, arising from the use of or inability to use this script or its documentation, even if the author has been advised of the possibility of such damages. Always verify that the laws of your country and your ISP's terms allow these applications.