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.

Stars Forks Issues Android Linux Windows Kotlin Python Support My Work

• 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. 📱

• 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. 🧠

• 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. ❤️

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.

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

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]

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

# 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

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.

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

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

Login Screen

Dashboard

Device Control

Settings

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

Donate via Monero: 45PU6txuLxtFFcVP95qT2xXdg7eZzPsqFfbtZp5HTjLbPquDAugBKNSh1bJ76qmAWNGMBCKk4R1UCYqXxYwYfP2wTggZNhq

haybnzz H9yzz VaradScript