telegram-bot-control-computer

KO | EN

gitlite — search

#react #python #reactjs #typescript #javascript #automation #java #security #pytorch #hacktoberfest #nodejs #tailwindcss

telegram-bot-control-computer

★ 57 Open GitHub ↗

A powerful Telegram bot built with Python. Features include system commands, file management, browser automation, and video control using Selenium and browser.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">🤖 Advanced Computer Control Telegram Bot 🖥️</h1>

<p align="center">
  <em>Remote control your computer with an elegant, feature-rich Telegram bot</em>
</p>

<div align="center">
  <a href="#-key-features">Features</a> •
  <a href="#-requirements">Requirements</a> •
  <a href="#-usage">Usage</a> •
  <a href="#%EF%B8%8F-packaging-as-executable">Packaging</a>
</div>

---

## ✨ Key Features

### 🖥️ System Control
- Shutdown, restart, and sleep commands
- Cancel pending shutdown/restart operations

### 📸 Screen Capture
- High-quality screenshots with OpenCV
- Screen recording with customizable quality
- Real-time transmission to Telegram

### 📁 File Management
- Upload files from Telegram to your computer
- Download files from your computer to Telegram
- Delete files from specified paths

### 🌐 Browser Control
- Launch and control web browsers (Chrome, Brave, Edge, Opera)
- Play YouTube videos with playback controls
- Navigate websites with forward/back/refresh controls

### 🔍 System Information
- View running processes list
- System hardware & software information
- Network configuration and user accounts
- IP management (release/renew)

### 🖱️ Remote Control Interfaces
- Virtual touchpad with Ngrok public URL
- Volume control interface with interactive slider
- Virtual keyboard for text input and hotkeys

---

## 📋 Requirements

### System Requirements
- Windows OS (primary target, most features supported)
- Linux/Mac (limited functionality for some features)
- Python 3.10.11
- Admin privileges (recommended for full functionality)

### Ngrok Setup
1. Visit [ngrok.com](https://ngrok.com) and create an account
2. Download ngrok from the website
3. Extract ngrok.exe to a folder
4. Get your Auth Token from the ngrok dashboard
5. Open command prompt in the folder containing ngrok.exe
6. Run the command: `ngrok config add-authtoken $YOUR_AUTHTOKEN`

### Required Python Packages
Install all dependencies with this command:
```bash
pip install oscpy regex pyautogui nest_asyncio numpy opencv-python comtypes pynput playwright python-telegram-bot python-dotenv flask pyngrok pycaw pyinstaller
```

Then install the Playwright browsers:
```bash
playwright install
```

### API Keys/Tokens
- Telegram Bot Token (from [@BotFather](https://t.me/BotFather))

---

## 🚀 Usage

### Starting the Bot
1. Create a `.env` file with the following content:
```
TOKEN=REPLACE-YOUR-TOKEN
ALLOWED_USERS=REPLACE-YOUR-ID-CHAT
NGROK_AUTH_TOKEN=REPLACE-YOUR-NGROK-AUTH-TOKEN
```

2. Run the bot:
```bash
python Bot_Control_Computer.py
```

---

### Available Commands

#### ⚡️ Introduction Commands

| Command | Description |
|---------|-------------|
| `/introduce` | Introduction about the author |
| `/menu` | Display list of all commands |

#### ⚡️ System Control Commands

| Command | Description |
|---------|-------------|
| `/shutdown` | Shutdown the computer |
| `/restart` | Restart the computer |
| `/sleep` | Put computer to sleep mode |
| `/cancel` | Cancel all shutdown/restart commands |

#### ⚡️ Image Commands

| Command | Description |
|---------|-------------|
| `/screen_shot` | Take a screenshot and send it |
| `/record_video` | Record screen and send the video |

#### ⚡️ File Management Commands

| Command | Description |
|---------|-------------|
| `/upload_file` | Upload a file from Telegram to your PC |
| `/download_file` | Download a file from your PC to Telegram |
| `/deletefile` | Delete a file at the specified path |

#### ⚡️ System Information Commands

| Command | Description |
|---------|-------------|
| `/tasklist` | List of running processes |
| `/systeminfo` | System information |
| `/netuser` | List of users on the computer |
| `/whoami` | Current logged-in user |
| `/hostname` | Display computer name |

#### ⚡️ Network Commands

| Command | Description |
|---------|-------------|
| `/ipconfig` | Network configuration information |
| `/release` | Release current IP address |
| `/renew` | Renew IP address |

#### ⚡️ Browser Commands

| Command | Description |
|---------|-------------|
| `/playvideo` | Play YouTube video from link |
| `/openweb` | Open websites |
| `/setbrowser` | Set default browser (chrome, brave, edge, opera) |

#### ⚡️ Utility Commands

| Command | Description |
|---------|-------------|
| `/mouse_virtual_system` | Control mouse with virtual touchpad |
| `/volume_virtual_system` | Control volume with virtual touchpad |
| `/keyboard_emulator` | Control with virtual keyboard |
| `/set_language` | Change display language |

---

## 🔧 Packaging as Executable

You can package this bot into a standalone Windows executable using PyInstaller:

```bash
python -m PyInstaller --onefile --noconsole Bot_Control_Computer.py
```

---

## 👨‍💻 Author & Contact

---

<p align="center">
  Made with ❤️ by <a href="https://github.com/LePhiAnhDev" target="_blank">LePhiAnhDev</a>
</p>

telegram-bot-control-computer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README