Skip to content

Commit

Permalink
chore(readme): updated to m4b v4 instructions with legacy v3 sections
Browse files Browse the repository at this point in the history
  • Loading branch information
MRColorR committed Sep 19, 2024
1 parent f67bbd8 commit 1f4bdb8
Show file tree
Hide file tree
Showing 2 changed files with 235 additions and 65 deletions.
298 changes: 234 additions & 64 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,124 +1,294 @@
# Money4Band
<img src="./.resources/.assets/M4B_logo_small.png?raw=true" width="96"> - **Leave a star ⭐ if you like this project 🙂 thank you.**

**|Easy automatic multi app passive income project with Webdasboard, Auto Updater and Proxy Support :dollar::satisfied::+1:|**
# Money4Band

<img src="./.resources/.assets/M4B_logo_small.png?raw=true" width="96"> - **Leave a star ⭐ if you like this project 🙂 thank you.**



**|Easy automatic multi-app passive income project with Web Dashboard, Auto Updater, and Proxy Support :dollar::satisfied::+1:|**



## Quick Overview 🚀
**Money4Band** leverages unused internet bandwidth allowing you to make money with something you have and would otherwise be wasted.** It utilizes containerized version of apps like EarnApp, Honeygain, IPRoyal Pawns, PacketStream, Peer2Profit, Repocket, Earnfm, Proxyrack, Proxylite, Bitping and so on but it's also safer than installing and using these native apps on your host system.

**Money4Band** leverages unused internet bandwidth, allowing you to make money with something you have and would otherwise be wasted. It utilizes containerized versions of apps like EarnApp, Honeygain, IPRoyal Pawns, PacketStream, Peer2Profit, Repocket, Earnfm, Proxyrack, Proxylite, Bitping, and more. It's also safer than installing and using these native apps on your host system.



**Key Features:**
- **Multiplatform** and lightweight docker stack.
- **Automatic Updates** to keep your applications up-to-date.
- **Web Dashboard** for easy monitoring.
- **Proxy Support** for enhanced flexibility.

- **Multiplatform** and lightweight Docker stack.

- **Automatic Updates** to keep your applications up-to-date.

- **Web Dashboard** for easy monitoring.

- **Proxy Support** for enhanced flexibility.



🌐 For a detailed overview and FAQ, visit the [Wiki](https://github.com/MRColorR/money4band/wiki) or join our [Discord Community](#-join-the-money4band-community-on-discord).



## Getting Started 🚥



### Prerequisites
- Ensure that you have a 64-bit operating system, virtualization functions are enabled and Docker is installed and able to auto start up on system boot.
- (Optional) For ARM devices like Raspberry Pi, installing an emulation layer for non-ARM native Docker images is recommended. Even though the script can assist with the installation, we recommend users to install an emulation layer by themselves following the [Wiki](https://github.com/MRColorR/money4band/wiki) guide.
- (Optional) On Windows, ensure the Virtualization platform and Windows Subsystem for Linux are active as Docker requires these features. Even though the script can assist with the installation, we recommend users to enable these windows functions by themselves following the [Wiki](https://github.com/MRColorR/money4band/wiki) guide.

- Ensure that you have a 64-bit operating system, virtualization functions are enabled, and Docker is installed and able to auto-start on system boot.

- (Optional) For ARM devices like Raspberry Pi, installing an emulation layer for non-ARM native Docker images is recommended. Even though the script can assist with the installation, we recommend users install an emulation layer by themselves following the [Wiki](https://github.com/MRColorR/money4band/wiki) guide.

- (Optional) On Windows, ensure the Virtualization Platform and Windows Subsystem for Linux are active as Docker requires these features. Even though the script can assist with the installation, we recommend users enable these Windows functions by themselves following the [Wiki](https://github.com/MRColorR/money4band/wiki) guide.



### Quick Setup Guide
1. **Download** the latest version of Money4Band from the [Releases](https://github.com/MRColorR/money4band/releases) or git clone the project.
- OR you can also use on Linux/MacOS a bash command like: `wget https://github.com/MRColorR/money4band/archive/refs/heads/main.zip && unzip main.zip`
- OR on Windows use a pwsh command like:`Invoke-WebRequest -Uri https://github.com/MRColorR/money4band/archive/refs/heads/main.zip -OutFile main.zip; Expand-Archive -Path main.zip -DestinationPath .\ `
3. **Register** accounts on the application websites. [Here's a list of availabe apps](#app-compatibility-and-sign-up-links-)
4. **Run** the guided setup:
- **Linux:**
```bash
sudo chmod +x runme.sh && ./runme.sh
```
- **Windows:**
```powershell
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Bypass -Force; .\runme.ps1
```
5. **Start Earning** passively and monitor your performance through the web dashboard.



#### Preferred Method: Using Release Artifacts



1. **Download** the latest release of Money4Band for your operating system from the [Releases Page](https://github.com/MRColorR/money4band/releases).

- **Windows Users:**

- Download the `Money4Band-windows-latest-x64-<version>.zip` file.

- Extract the ZIP file to a folder of your choice.

- Navigate to the extracted folder and run `money4band.exe`.

- **Note:** If Windows SmartScreen appears, click on **More info** and then select **Run anyway** to proceed.

- **Linux Users:**

- Download the `Money4Band-ubuntu-latest-x64-<version>.tar.gz` file.

- Extract the tar.gz file:```tar -xvzf Money4Band-ubuntu-latest-x64-<version>.tar.gz```

- Navigate to the extracted folder and run the script:```./money4bandchmod +x money4band```
- **Note:** You can make sure it is executable on your OS with ```chmod +x money4band```

- **macOS Users:**

- Download the `Money4Band-macos-latest-x64-<version>.tar.gz` file.

- Extract the tar.gz file:```tar -xvzf Money4Band-macos-latest-x64-<version>.tar.gz```

- Navigate to the extracted folder and run the script:```./money4bandchmod +x money4band```
- **Note:** You can make sure it is executable on your OS with ```chmod +x money4band```

- **ARM Devices (e.g., Raspberry Pi):**

- Download the appropriate ARM release from the [Releases Page](https://github.com/MRColorR/money4band/releases) (e.g., `arm64` or `armv7`).

- Follow the same steps as Linux users.



2. **Register** accounts on the application websites. [Here's a list of available apps](#app-compatibility-and-sign-up-links-).



3. **Run** the guided setup through the Money4Band application:

- Follow the on-screen instructions to configure and start the services.



4. **Start Earning** passively and monitor your performance through the web dashboard.



#### Alternative Method: Cloning the Repository



If you prefer to clone the repository or contribute to the project:



1. **Clone** the project:```git clone https://github.com/MRColorR/money4band.git && cd money4band```

- **OR** download the ZIP and extract it using one of the options below:
- ```wget https://github.com/MRColorR/money4band/archive/refs/heads/main.zip && unzip main.zip && cd money4band-main```
- ```Invoke-WebRequest -Uri https://github.com/MRColorR/money4band/archive/refs/heads/main.zip -OutFile main.zip; Expand-Archive -Path main.zip -DestinationPath .\ ; cd money4band*```





### M4B v3 legacy Setup Guide

1. **Download** the latest version of Money4Band from the [Releases](https://github.com/MRColorR/money4band/releases) or git clone the project.
2. **Register** accounts on the application websites. [Here's a list of availabe apps](#app-compatibility-and-sign-up-links-)
3. **Access the Money4Band v3 Folder**: The legacy code of M4B v3 is included with the new releases and is located in a subfolder. To run the old M4B v3 bash or PowerShell scripts, navigate to this subfolder and use one of the following options:
- **(Linux/Mac):** ```sudo chmod +x runme.sh && ./runme.sh```
- **(Windows):**```Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Bypass -Force; .\runme.ps1```


4. **Follow the remaining standard steps until completion**



## App Compatibility and Sign Up Links 📋

Register an account on the app's sites clicking each apps' names in the following compatibility matrix

- :moneybag: Registering trough these links on the apps' sites, you should also receive a welcome bonus and at the same time you will effortlessly show that you appreciate my work, thank you so much :slightly_smiling_face:.


- :moneybag: Registering trough these links on the apps' sites, you should also receive a welcome bonus and at the same time you will effortlessly show that you appreciate my work, thank you so much :slightly_smiling_face:.



- :key: If you are using login with google, remember to set also a password for your app account!

| App Name & Link | Residential/Home/Mobile IP or equivalent Proxy's IP | VPS/Datacenter/Hosting/Cloud IP or equivalent Proxy's IP | Max devices per Account | Max Devices per IP |
| :--- | :---: | :---: | :---: | :---: |
| Go to [Earnapp](https://earnapp.com/i/3zulx7k) | :white_check_mark: | :x: | 15|1|
| Go to [HoneyGain](https://r.honeygain.me/MINDL15721) | :white_check_mark: | :x: |10|1|
| Go to [IPROYAL](https://pawns.app?r=MiNe) | :white_check_mark: | :x: |Unlimited|1|
| Go to [PEER2PROFIT](https://t.me/peer2profit_app_bot?start=165849012262da8d0aa13c8) | :white_check_mark: | :white_check_mark: | Unlimited|Unlimited|
| Go to [PACKETSTREAM](https://packetstream.io/?psr=3zSD) | :white_check_mark: | :x: |Unlimited|1|
| Go to [TRAFFMONETIZER](https://traffmonetizer.com/?aff=366499) | :white_check_mark: | :white_check_mark: |Unlimited|Unlimited|
| Go to [REPOCKET](https://link.repocket.co/hr8i) | :white_check_mark: | :white_check_mark: |Unlimited|2|
| Go to [EARNFM](https://earn.fm/ref/MATTTAV6) | :white_check_mark: | :x: |Unlimited|1|
| Go to [PROXYRACK](https://peer.proxyrack.com/ref/myoas6qttvhuvkzh8ffx90ns1ouhwgilfgamo5ex) | :white_check_mark: | :white_check_mark: |500|1|
| Go to [PROXYLITE](https://proxylite.ru/?r=PJTKXWN3) | :white_check_mark: | :white_check_mark: |Unlimited|1|
| Go to [BITPING](https://app.bitping.com?r=qm7mIuX3) | :white_check_mark: | :white_check_mark: |Unlimited|1|


| App Name & Link | Residential/Home/Mobile IP or equivalent Proxy's IP | VPS/Datacenter/Hosting/Cloud IP or equivalent Proxy's IP | Max devices per Account | Max Devices per IP |

| :--- | :---: | :---: | :---: | :---: |

| Go to [Earnapp](https://earnapp.com/i/3zulx7k) | :white_check_mark: | :x: | 15|1|

| Go to [HoneyGain](https://r.honeygain.me/MINDL15721) | :white_check_mark: | :x: |10|1|

| Go to [IPROYAL](https://pawns.app?r=MiNe) | :white_check_mark: | :x: |Unlimited|1|

| Go to [PEER2PROFIT](https://t.me/peer2profit_app_bot?start=165849012262da8d0aa13c8) | :white_check_mark: | :white_check_mark: | Unlimited|Unlimited|

| Go to [PACKETSTREAM](https://packetstream.io/?psr=3zSD) | :white_check_mark: | :x: |Unlimited|1|

| Go to [TRAFFMONETIZER](https://traffmonetizer.com/?aff=366499) | :white_check_mark: | :white_check_mark: |Unlimited|Unlimited|

| Go to [REPOCKET](https://link.repocket.co/hr8i) | :white_check_mark: | :white_check_mark: |Unlimited|2|

| Go to [EARNFM](https://earn.fm/ref/MATTTAV6) | :white_check_mark: | :x: |Unlimited|1|

| Go to [PROXYRACK](https://peer.proxyrack.com/ref/myoas6qttvhuvkzh8ffx90ns1ouhwgilfgamo5ex) | :white_check_mark: | :white_check_mark: |500|1|

| Go to [PROXYLITE](https://proxylite.ru/?r=PJTKXWN3) | :white_check_mark: | :white_check_mark: |Unlimited|1|

| Go to [BITPING](https://app.bitping.com?r=qm7mIuX3) | :white_check_mark: | :white_check_mark: |Unlimited|1|

| Go to [SPEEDSHARE](https://speedshare.app/?ref=mindlessnerd) | :white_check_mark: | :x: | Unlimited | 1 |

| Go to [GRASS](https://app.getgrass.io/register/?referralCode=qyvJmxgNUhcLo2f) | :white_check_mark: | :x: | Unlimited | 1 |
| Go to [MYSTNODE](https://mystnodes.co/?referral_code=Tc7RaS7Fm12K3Xun6mlU9q9hbnjojjl9aRBW8ZA9) | :white_check_mark: | :white_check_mark: |Unlimited|Unlimited|

| Go to [MYSTNODE](https://mystnodes.co/?referral_code=Tc7RaS7Fm12K3Xun6mlU9q9hbnjojjl9aRBW8ZA9) | :white_check_mark: | :white_check_mark: |Unlimited|Unlimited|



## Scale Up with Multi-Proxy Support 🌐



**Money4Band** has the ability to create multiple instances also using a proxy list, ideal for scaling up your setup. Quickly set up numerous instances each linked to a different proxy with ease.



### Getting Started with Multi-Proxy
- **Initial Setup**: First, set up the main instance using `runme.sh` with a proxy.
- **Prepare Proxies**: Create a `proxies.txt` in the root folder, listing each remaning proxy on a separate line and ending with a new line.

### Launching Multiple Instances
1. **Run the Script**: Use the "Setup and manage multiproxy instances by list" in the M4B menu or execute `runmproxies` script in the terminal. This script intelligently handles existing instances by offering to:
- Clear and recreate all instances.
- Update proxies for existing setups (if sufficient proxies are available).
- Exit without changes.
1. **Prepare Proxies**: Create a `proxies.txt` file in the root folder of M4B, listing each proxy on a separate line and ending with a new line.
2. **Start M4B and do the Setup**: During the setup Money4Band will ask you if you want to setup mutiplroxy, reply yes and follow the steps.

2. **Automated Setup**: For each proxy in `proxies.txt`, the script sets up a new instance with appropriate configurations.
### Getting Started with Multi-Proxy (Legacy M4B v3)
1. **Initial Setup**: First, set up the main instance using `runme.sh` with a proxy.
2. **Prepare Proxies**: Create a `proxies.txt` in the root folder, listing each remaning proxy on a separate line and ending with a new line.
3. **Run the multiproxy instances**: Use the "Setup and manage multiproxy instances by list" in the M4B menu or execute `runmproxies` script in the terminal.

> **Notice**: While using multiple proxies, be aware that only certain apps permit proxy usage per their ToS. We recommend using personal, private proxies with IPs not flagged as proxies and always respecting the ToS of each app.
> **Notice:** While using multiple proxies, be aware that only certain apps permit proxy usage per their Terms of Service. We recommend using personal, private proxies with IPs not flagged as proxies and always respecting the ToS of each app.


## Compatibility and tested environments
This Docker Stack should work on anything that may have docker installed. In particular, it has been tested on:
| | Windows 11 x86_64\amd64 | Linux Ubuntu x86_64\amd64 | Raspbian OS arm64 | MacOS Intel x86_64 | MacOS silicon arm64 |
| :---: | :---: | :---: | :---: | :---: | :---: |

This Docker Stack should work on anything that may have docker installed. In particular, it has been tested on:

| | Windows 11 x86_64\amd64 | Linux Ubuntu x86_64\amd64 | Raspbian OS arm64 | MacOS Intel x86_64 | MacOS silicon arm64 |

| :---: | :---: | :---: | :---: | :---: | :---: |

| Tested | :green_circle: | :green_circle: | :green_circle: | :green_circle: | :green_circle:|

| on device | Desktop/Laptop PC | Desktop/Laptop PC | Raspberry Pi3/Pi4 | MacBook Pro | MacBook Air |



:green_circle:: All functions supported, Auto/manual setup supported

:yellow_circle:: All functions supported but not tested, Auto/manual setup supported



## Need Help or Found an Issue? ❓

- For discussions, info, and feature requests, use the [Discussion tab](https://github.com/MRColorR/money4band/discussions) or join our [Discord Community](#-join-the-money4band-community-on-discord).

- F.A.Q., Alternatve Manual Setup, How To Update, other useful guides and more details inside the [Wiki](https://github.com/MRColorR/money4band/wiki)



- For issues and bug reporting, use the [Issue tab](https://github.com/MRColorR/money4band/issues).

## 🚀 Join the Money4Band Community on Discord!
We've launched a Discord server! It's a space for you to share your experiences, ask questions, and discuss everything related to Money4Band and its related projects like custom docker images created for M4B and so on.


## 🚀 Join the Money4Band Community on Discord!

Join our Discord server! It's a space for you to share your experiences, ask questions, and discuss everything related to Money4Band and its related projects like custom docker images created for M4B and so on.

[Join the Money4Band Discord Community](https://discord.com/invite/Fq8eeazBAD)



## Support the Projects 🫶



Your contributions are vital in helping to sustain the development of open-source projects and tools made freely available to everyone. If you find value in my work and wish to show your support, kindly consider making a donation:



### Cryptocurrency Wallets

- **Bitcoin (BTC):** `1EzBrKjKyXzxydSUNagAP8XLeRzBTxfHcg`
- **Ethereum (ETH):** `0xE65c32004b968cd1b4084bC3484C0dA051eeD3ee`
- **Solana (SOL):** `6kUAWW8q5169qnUJdxxLsNMPpaKPvbUSmryKDYTb9epn`
- **Polygon (MATIC):** `0xE65c32004b968cd1b4084bC3484C0dA051eeD3ee`
- **BNB (Binance Smart Chain):** `0xE65c32004b968cd1b4084bC3484C0dA051eeD3ee`


- **Bitcoin (BTC):** `1EzBrKjKyXzxydSUNagAP8XLeRzBTxfHcg`

- **Ethereum (ETH):** `0xE65c32004b968cd1b4084bC3484C0dA051eeD3ee`

- **Solana (SOL):** `6kUAWW8q5169qnUJdxxLsNMPpaKPvbUSmryKDYTb9epn`

- **Polygon (MATIC):** `0xE65c32004b968cd1b4084bC3484C0dA051eeD3ee`

- **BNB (Binance Smart Chain):** `0xE65c32004b968cd1b4084bC3484C0dA051eeD3ee`



Your support, no matter how small, is enormously appreciated and directly fuels ongoing and future developments. Thank you for your generosity! 🙏



---

### :warning: Disclaimer
Always check that the laws of your country and the contractual terms of your internet plan allow the use of such applications. In any case, I do not take any responsibility for any consequences deriving from the use of such apps. This stack proposed by me simply brings these apps together, allows easy configuration even for the less experienced and updates the apps' images automatically.
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 check that the laws of your country and the contractual terms of your internet plan allow the use of such applications. In any case, I do not take any responsibility for any consequences deriving from the use of such apps. This stack proposed by me simply brings these apps together, allows easy configuration even for the less experienced, and updates the apps' images automatically.

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 held 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.



## :hash: License
[GPL 3.0](https://www.gnu.org/licenses/gpl-3.0.html)

[GPL 3.0](https://www.gnu.org/licenses/gpl-3.0.html)
2 changes: 1 addition & 1 deletion config/m4b-config.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"project": {
"project_version": "4.3.6",
"project_version": "4.3.7",
"compose_project_name": "money4band",
"ds_project_server_url": "https://discord.com/invite/Fq8eeazBAD"
},
Expand Down

0 comments on commit 1f4bdb8

Please sign in to comment.