🚀 TeleShift

Premium Remote PC Controller Desktop Agent & Telegram Bot

---

🌟 Overview

TeleShift is a high-end, secure, and distributed remote PC control system. It empowers you to manage your desktop computers remotely using a centralized Telegram Bot acting as the command center, and a lightweight, background Electron-based agent installed on your machines.

With real-time commands bridged through Supabase or your own PostgreSQL database, TeleShift offers instant execution with high security and minimal latency. Just spin up a database — and go.

✨ Features

• 📱 Telegram Bot Interface: Control your PC from anywhere right from your Telegram app.
• ⚡ Real-Time Execution: Powered by Supabase Realtime or PostgreSQL LISTEN/NOTIFY for instant command delivery.
• 🐘 Flexible Backend: Use managed Supabase or your own self-hosted PostgreSQL — your choice.
• 🖥️ Agent: Built with Electron & React for Windows.
• 🔒 Secure Connection: Devices are linked securely via per-user unique database hashes.
• 👻 Stealth Mode: The desktop agent starts automatically on boot and runs hidden in the system tray.

🎮 Supported Commands

• 🛑 Shutdown / Reboot - Manage system power state.
• 🔒 Lock Screen - Secure your workstation instantly.
• 📸 Take Screenshots - View your PC's current screen remotely.
• 🔊 Volume Control - Mute, increase, or decrease system volume.
• 📊 System Status - Monitor battery level and disk space.
• 🚀 Launch Apps - Start specific executables or files remotely.

---

🛠️ Tech Stack

Desktop Agent (Host)

• 
• 
• 
• 

Control Center (Bot)

• 
• 

Backend Bridge

• 
• 

---

🚀 Getting Started

1. Database Setup

You have two options:

Option A: Supabase (managed, zero-config)

1. Create a new Supabase project.
2. Run supabase/schema.sql in the SQL editor to create tables.
3. Note your SUPABASE_URL and SUPABASE_ANON_KEY.

Option B: Raw PostgreSQL (self-hosted)

1. Set up a PostgreSQL 14+ database.
2. Run supabase/schema.sql to create tables + LISTEN/NOTIFY triggers.
3. Note your DATABASE_URL (e.g. postgresql://user:pass@host:5432/dbname).

When DATABASE_URL is set, it takes priority over Supabase credentials.

2. Telegram Bot Setup

1. Clone the repository and navigate to the bot directory.
2. Copy .env.example to .env and fill in your credentials:
3. Install Python dependencies:

   pip install -r requirements.txt

4. Run the bot:

   python main.py

3. Desktop Agent Setup

1. Navigate to the electron-app directory.
2. Install Node dependencies:

   npm install

3. To test in development:

   npm run dev

4. To build the production executable (NSIS Installer for Windows):

   npm run build:exe

---

🔒 Code Signing

This application uses a self-signed certificate for code signing. As an open-source project without a paid EV certificate ($400+/year), Windows SmartScreen may display a warning during the first launch.

How to run:

1. Click "More info" in the warning window.
2. Click "Run anyway".

This is standard practice for independent developers. You can always audit the source code in this repository.

🛡️ Security & Privacy

TeleShift does not expose your local PC to the public internet via port forwarding. It securely listens for authorized commands pushed to the database real-time channel (Supabase WebSocket or PostgreSQL NOTIFY), preventing external attacks.

---

Built with ❤️ for seamless remote management.