Share2Earn (Multi-proxy support)

Share2Earn - Earn passive income by sharing your spare Internet bandwidth with a user-friendly web dashboard. ⭐️ Star this repo if you enjoy it! |

📚 Table of Contents

• 🚀 Quick Start
• ✨ Running on a Server?
• ⚙️ Configuration
• ✨ Features
• 🖥️ Usage
• 🧩 Supported Apps
• 📘 Setup Made Simple
• 📸 Screenshots
• ✅ Tested On
• 🤝 Contributing
• 💖 Support the Project
• ⚖️ License

🚀 Quick Start

Get up and running in a few simple steps:

1. 🛠️ Prerequisites

   • Docker Engine & Docker Compose
   • Python 3.7+

2. 📥 Clone & Enter the Repo

   git clone https://github.com/vanhbakaa/share2earn.git
   cd share2earn

3. 📦 Install Dependencies

   pip install -r requirements.txt

4. ▶️ Launch the Dashboard

   python main.py

   • Open your browser at http://localhost:5000 or your chosen port in dashboard_config.json.
   • First run auto-generates data/ files and configurations.

---

✨ Running on a Server

If you're hosting this on a remote server (e.g. VPS or Raspberry Pi), and want to keep the app running after your SSH session ends:

1. Install screen (if not already installed):

   sudo apt install screen
   

2. Start a screen session:

   screen -S share2earn

3. Run the app inside that session:

   python main.py

4. Detach from the screen session:

   Press Ctrl+A, then D

5. Reattach later with:

   screen -r share2earn

🧠 This keeps your dashboard running 24/7 even after you disconnect from the server.

---

⚙️ Configuration

All settings live under data/ as JSON files:

File	Purpose
dashboard_config.json	Web UI port & admin credentials
app_config.json	Memory profiles & default apps
user_config.json	Your service accounts & global settings

🔒 Tip: Update your admin username/password in dashboard_config.json before first use.

No extra environment variables needed. Ensure the data/ folder is writable.

---

✨ Features

Feature	Description
🔁 Auto-Restart	Containers automatically restart if they stop unexpectedly.
🔄 Auto-Update	Built-in support to keep containers and dependencies up to date.
🌐 Multi-Proxy Support	Easily bind and manage multiple proxies per container or app.
💻 Multi-Platform	Runs smoothly on Windows, macOS, Linux, and even Raspberry Pi.

---

🖥️ Usage

1. 🔑 Login: Navigate to http://localhost:5000 and sign in.
2. 🛠️ Enable Apps: Go to Apps / Settings, toggle services, and save your credentials.
3. 🚀 Manage Containers: In Manage Containers, Start/Stop each service—Docker images will download and run automatically.
4. 📊 View Stats: Check Stats for bandwidth usage and earnings.

💡 All actions are handled via the UI—no need for manual Docker commands.

---

🧩 Supported Apps

Share2Earn supports a variety of passive income and bandwidth-sharing platforms out of the box, including:

• 🧠 EarnApp
• 🐝 Honeygain
• 📦 PacketStream
• 🌐 Mysterium
• 💰 Traffmonetizer
• ⚡ Peer2Profit
• 🌟 Ebesucher
• 📊 Uprock
• 🌿 Grass
• ➕ ...and more!

---

📘 Setup Made Simple

All app instructions and registration links are integrated directly into the dashboard UI.

🚀 To set up any app:

1. Launch Share2Earn and open the dashboard.
2. Navigate to the Apps section.
3. Click on any app to view:
   • Setup steps
   • Sign-up link
   • Required credentials
   • Helpful tips

There’s no need to search for guides — everything is built right into the dashboard for a smooth onboarding experience.

---

📸 Screenshots

Here’s a preview of the Share2Earn web interface in action:

🏠 Dashboard	⚙️ App Configuration	📊 Stats	🌐 Proxy Management

✅ Tested On

Platform	Example Devices	Status	Notes
🖥️ Desktop/Laptop PC	Windows 10/11, Ubuntu 20.04+	✅ Working	Docker Desktop or native Docker
🍓 Raspberry Pi	Pi 4B / Pi 5 (64-bit OS)	✅ Working	Use lightweight containers
🍎 MacBook Pro	macOS 12+ (Intel & Apple Silicon)	✅ Working	Docker Desktop required

💡 Tested with Python 3.7 - 3.11 and Docker Engine 20.10+. If your system works and isn’t listed, feel free to contribute!

---

🤝 Contributing

Contributions are warmly welcome!

• 🐛 Report issues or request features via GitHub Issues.
• 🍴 Fork the repo, create a branch, and submit a PR.
• 📐 Keep code style consistent and update this README for any new features.

---

💖 Support This Project

If you find this project helpful and would like to support its continued development, please consider making a donation. Every contribution helps keep the project alive and growing!

💰 How to Donate:

You can donate via the following platforms:

1. PayPal
   Donate via PayPal

2. Crypto

   • Ton: UQABOtzug-KWStTEAYYJhaVL0SaLgHtoCWIQzZ4IqaSaA1ue

Your donations help:

• Support further development and bug fixes.
• Add new features and improve existing ones.
• Keep the project free and open-source for everyone!

Thank you for your generosity and support! 🙏

---

⚖️ License

Distributed under the MIT License. See LICENSE for details.

⚠️ Disclaimer: Use at your own risk. Monitor your bandwidth and earnings when running multiple services.

---