SyncMe

SyncMe is a lightweight tool that connects your Android, Linux, and Windows devices so they can work together seamlessly. Control, sync, and manage everything from one simple web interface.

---

✨ Key Features

🖥️ Central Server (Flask + Socket.IO)

• Modern Web Dashboard: Tactical UI for managing all connected devices. 📊
• REST API & WebSockets: Low-latency communication and real-time updates. ⚡
• MJPEG Streaming: Live camera feed from Android devices directly in the browser. 🎥
• File Management: Centralized file transfers and storage. 📂
• Discovery: Automatic device discovery via UDP and mDNS. 🔍
• PWA Support: Install the dashboard as a standalone app. 📱

📱 Android Agent (Native & Termux)

• Full Control: Torch, vibration, volume, brightness, TTS, and toasts. 🔦📳🔊
• Media: On-demand photos, microphone recording, and MJPEG live stream. 📷🎙️
• Data Sync: Bidirectional clipboard, notification mirroring, SMS inbox/send, contacts, and call logs. 📋✉️☎️
• Tracking: Continuous and on-demand GPS location tracking. 📍
• Remote Shell: Execute commands remotely on your Android device. 🐚
• Smart Fallback: Works in both "Full API" (Termux:API) and "No-API" modes. 🧠

🐧 Linux & 🪟 Windows Agents

• Clipboard Sync: Bidirectional clipboard sharing across your mesh. 📋
• Notifications: Mirror server-side notifications to your desktop. 🔔
• Remote Shell: Securely execute shell commands from the dashboard. 🐚
• Heartbeat: Real-time status reporting. ❤️

---

🛠️ Installation & Setup

1. 🌐 Server Setup (Linux/Kali/VPS)

The server acts as the central hub.

# Clone the repository
git clone https://github.com/h9zdev/SyncME.git
cd SyncME

# Install dependencies
pip install -r requirements.txt

# Start the server
python server.py

Open http://localhost:5000 in your browser. Default token is syncbridge-token-2024.

Tip

If you are running locally, use your local IP address. You can also use port forwarding to expose your server to the internet. 🌍

2. 📱 Android Native App Setup

Download the SyncME Android app to easily connect your device.

• For Android 8 to Android 11: Download APK 📥
• For Android 12, 13, and 14+: Download APK 📥
• Build your own: Syncme-droid Repository 🏗️

Once installed:

1. Open the app.
2. Enter your Server URL, Token, and Device Name.
3. Click Connect. 🚀

3. 🐚 Android Termux Setup

For advanced users, run the agent within Termux.

Download Termux and Addons:

• Termux: F-Droid | Play Store
• Termux:API: F-Droid
• Termux:Widget: F-Droid
• Termux:Boot: F-Droid

Setup Steps:

# Open Termux and download the setup script and agent
curl -O https://raw.githubusercontent.com/h9zdev/SyncME/main/termux_setup.sh
curl -O https://raw.githubusercontent.com/h9zdev/SyncME/main/agent_android.py

# Run the setup script
chmod +x termux_setup.sh
./termux_setup.sh

# Start the agent
python agent_android.py --server [YOUR_SERVER_URL] --token [YOUR_TOKEN]

4. 🐧 Linux Agent

export SYNCBRIDGE_SERVER="http://YOUR_SERVER_IP:5000"
export SYNCBRIDGE_TOKEN="your-secret-token"
python agent_linux.py

5. 🪟 Windows Agent

# Install dependencies
pip install requests pywin32 plyer

# Set environment and run
$env:SYNCBRIDGE_SERVER="http://YOUR_SERVER_IP:5000"
$env:SYNCBRIDGE_TOKEN="your-secret-token"
python agent_windows.py

---

🛰️ How it Works

1. The Hub: server.py runs a Flask web server and a Socket.IO hub. It stores device states and queues commands.
2. The Agents: Agents connect to the server via REST (polling for commands) and push data (heartbeats, clipboard, stats).
3. The Tunnel: If your server is behind a NAT, use a tunnel like Ngrok or Cloudflare Tunnel to expose the port.
4. Live Stream: Android agents capture frames using termux-camera-photo and POST them to the server, which then streams them to the dashboard using MJPEG.

---

❓ Troubleshooting

• Termux:API calls fail: Ensure you have both the termux-api package (pkg install termux-api) and the Termux:API app installed from F-Droid.
• Device shows as Offline: Check if the agent is running and the SYNCBRIDGE_SERVER URL is correct.
• MJPEG Lag: Streaming performance depends on network latency and device CPU. Lower the FPS in the dashboard if needed.

---

🔒 Security

SyncBridge uses a simple token-based authentication (X-Auth-Token). It is highly recommended to run the server behind a reverse proxy with HTTPS and use a strong, unique token. 🛡️

export SYNCBRIDGE_TOKEN="a-very-strong-random-token"
export SECRET_KEY="your-flask-secret"
python server.py

📸 Screenshots

Login Screen

Dashboard

Device Control

Settings / Interface

📜 License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) License. See the LICENSE file for more details.

Unauthorized use is strictly prohibited.

📧 Contact: singularat@protn.me

☕ Support

Donate via Monero: 45PU6txuLxtFFcVP95qT2xXdg7eZzPsqFfbtZp5HTjLbPquDAugBKNSh1bJ76qmAWNGMBCKk4R1UCYqXxYwYfP2wTggZNhq

👥 Contributors and Developers