https://github.com/xeintdm/telegramrat
Telegram Remote Access Tool
https://github.com/xeintdm/telegramrat
administration csharp dotnet rat remote-access remote-control telegram telegram-bot telegram-rat tg-rat windows
Last synced: about 2 months ago
JSON representation
Telegram Remote Access Tool
- Host: GitHub
- URL: https://github.com/xeintdm/telegramrat
- Owner: XeinTDM
- License: unlicense
- Created: 2025-01-21T14:20:14.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-21T14:33:11.000Z (over 1 year ago)
- Last Synced: 2025-03-22T02:13:28.699Z (over 1 year ago)
- Topics: administration, csharp, dotnet, rat, remote-access, remote-control, telegram, telegram-bot, telegram-rat, tg-rat, windows
- Language: C#
- Homepage: https://guns.lol/xein
- Size: 36.1 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TelegramRAT
**Telegram Remote Access Tool**
A modern and optimized administration tool for Windows, accessible via your personal Telegram bot. Built for educational and administrative purposes, this tool offers robust features to interact with and control Windows systems remotely.
## Features
- **Keyboard and Mouse Input Simulation**
- **File System Access**
- Upload, download, delete, and manage files.
- **CMD Command Execution**
- **Python Scripting**
- Execute Python scripts directly.
- **Audio and Video**
- Record audio and capture webcam photos.
- **System Control**
- Shutdown, restart, logoff, monitor power control, etc.
- **Monitoring**
- Keylogging (educational use only).
- **Miscellaneous**
- Screenshot capturing, URL opening, and more.
For a full list of available commands, use the `/commands` bot command or click on the `Show All Commands` button.
## Requirements
- **Platform:** Windows 7+
- **Framework:** .NET 8
- **Telegram Bot:** Create one [here](https://core.telegram.org/bots).
## Improvements Over the Original
This version is based on the [Garneg's TelegramRAT](https://github.com/Garneg/TelegramRAT), with significant enhancements:
- Updated to **.NET 8** for better performance and support.
- Optimized and refactored the entire codebase.
- Improved stability and error handling.
- Enhanced security practices.
- Streamlined the command architecture for easier extension.
- Updated all the third-party libraries.
## Setup
1. Clone the repository:
```bash
git clone https://github.com/XeinTDM/TelegramRAT.git
```
2. Configure your bot token and owner ID (see [Configuration](#configuration)).
3. Build the project using Visual Studio or any compatible IDE.
4. Deploy the compiled binary on the target system.
5. Start the application and control it through your Telegram bot.
## Runtime behavior
`TelegramRAT` supervises the polling loop and automatically recreates the Telegram client if an unexpected error occurs. Each retry clears any cached command state, notifies the configured owner about the failure, and waits with an exponential backoff (up to 60 seconds) before reconnecting. Pressing Ctrl + C requests a graceful shutdown so the bot can stop polling without forcing another restart.
## Configuration
`TelegramRAT` reads its runtime configuration from **environment variables** or an optional `appsettings.json` file located next to the executable. Environment variables have priority; any value that is missing falls back to `appsettings.json`.
| Setting | Environment variable | `appsettings.json` key |
|-----------|----------------------------|------------------------|
| Bot token | `TELEGRAMRAT_BOT_TOKEN` | `BotToken` |
| Owner ID | `TELEGRAMRAT_OWNER_ID` | `OwnerId` |
### Example `appsettings.json`
```json
{
"BotToken": "123456789:telegram-bot-token",
"OwnerId": "123456789"
}
```
> ⚠️ **Never commit secrets.** Keep your production `appsettings.json` outside of source control and distribute it securely alongside the compiled binary when deploying.
### Setting secrets via environment variables
Environment variables are the recommended option for CI/CD or server deployments because they keep secrets out of the file system.
- **PowerShell**
```powershell
$env:TELEGRAMRAT_BOT_TOKEN = '123456789:telegram-bot-token'
$env:TELEGRAMRAT_OWNER_ID = '123456789'
```
- **Windows Command Prompt**
```cmd
set TELEGRAMRAT_BOT_TOKEN=123456789:telegram-bot-token
set TELEGRAMRAT_OWNER_ID=123456789
```
- **Linux / macOS (Bash/Zsh)**
```bash
export TELEGRAMRAT_BOT_TOKEN=123456789:telegram-bot-token
export TELEGRAMRAT_OWNER_ID=123456789
```
For long-running deployments (e.g., systemd services, container images), store the variables in the service definition or secret manager provided by your hosting environment.
## License
This project is licensed under the [The Unlicense](LICENSE), granting you the freedom to use, modify, and distribute the code as you see fit.
## Disclaimer
> **This tool is for educational and ethical purposes only.**
> Using this software maliciously or in violation of any laws is strictly prohibited.
> **The author is not responsible for any misuse or damage caused by this code.**
> Ensure you have proper authorization before using this tool on any system.
By using this tool, you agree to take full responsibility for your actions.