🖥️ Salim — Control Your Laptop from Telegram

Type a message on your phone. Your laptop does it.
Screenshots · Files · Shell · Processes · Power · Mouse & Keyboard · AI

🤔 What Is This?

Salim turns your laptop into a bot you can control from anywhere in the world using Telegram — the free messaging app.

Left your laptop at home? Left a download running? Want to check if your computer is overheating? Need to grab a file from your machine while you're out?

Just text your bot. That's it.

You can use plain English thanks to built-in AI — or use quick /commands if you prefer.

You:    "take a screenshot"
Salim:  📸 [sends screenshot to Telegram]

You:    "how much RAM am I using?"
Salim:  🧠 RAM: 8.2 GB / 16 GB (51%)

You:    "find my day 3 recording"
Salim:  🔍 Found 3 results:
        1️⃣ 🎬 day3_recording.mp4 — ~/Videos — 2.1 GB
        [⬇️ Send] [🗑️ Delete]

⚡ Get Started in 3 Minutes

Step 1 — Install

pip install salim

That's the only command needed. Python 3.9 or newer required.

Don't have Python? Download it free from python.org. After installing, open Terminal (Mac/Linux) or Command Prompt (Windows) and run the command above.

Step 2 — Run Setup

salim setup

A friendly wizard will walk you through everything:

1. Get a Telegram bot token — instructions are shown on screen
2. Add your Telegram user ID — so only you can control your laptop
3. Optionally configure one Groq API key — lets you type in plain English instead of commands
4. Choose a current Groq free-plan model — the wizard lists the supported choices

Step 3 — Start

salim start

Open Telegram, find your bot, send /start — and you're in control.

🤖 AI Mode — Just Type Naturally

When you set up the optional Groq AI integration, you don't need to remember any commands. Just talk normally:

Groq is the only AI API configured by onboarding. Get a key from Groq Console.

Current Groq free-plan model choices

The setup wizard lists these current models from Groq's supported free-plan catalog:

Availability and limits are controlled by Groq. See the official supported models and rate limits.

📱 All Commands

You can also use slash commands directly — no AI needed.

🖥️ System Info

⚙️ Processes

💻 Shell (Run Commands)

📂 Files

📸 Screen & Input

📋 Clipboard

🔔 Notifications & Media

🔋 Power

📄 Document Writer

All documents are saved to your Desktop and sent directly to Telegram.

Formatting standards applied automatically:

• Font: Calibri 11pt (professional docs) · Times New Roman 12pt (formal/legal)
• Margins: 1 inch all sides, US Letter page size
• Color-coded headers, justified body text, bold section titles
• Excel files use live formulas (not hardcoded values)

⚙️ Bot Settings

🔒 Security — Only You Can Control It

Salim is built so that no one else can touch your laptop through the bot:

• User whitelist — Only Telegram accounts you approve can send commands
• Silent rejection — Strangers get zero response (no hints that a bot even exists)
• Confirmation dialogs — Dangerous actions (shutdown, delete) require you to tap "Yes" in Telegram
• Audit log — Every command is recorded with timestamp and who sent it
• Secure storage — Your credentials are stored locally with strict file permissions (chmod 600)
• Token privacy — Your bot token is never shown in full or written to logs

Adding trusted users

salim adduser    # Interactive — shows you step-by-step

Or add multiple user IDs directly in ~/.salim/config.env:

SALIM_ALLOWED_IDS=111222333,444555666

Finding your Telegram user ID: Message @userinfobot on Telegram and send /start. It will reply with your numeric ID.

🛠️ CLI Commands

salim setup      # Run the setup wizard (first-time or to change settings)
salim start      # Start your bot
salim start -v   # Start with detailed logging
salim status     # Check configuration and installed features
salim config     # View or edit settings interactively
salim logs       # View the command history
salim test       # Test your Telegram connection
salim adduser    # Add a new authorized user
salim stop       # Stop the bot (if running in background)
salim uninstall  # Remove all Salim data from your computer

🔧 Configuration File

Settings are saved in ~/.salim/config.env. You can edit this file directly or use salim config.

SALIM_BOT_TOKEN=1234567890:ABCdef...        # Your Telegram bot token
SALIM_ALLOWED_IDS=123456789                  # Comma-separated user IDs
SALIM_DOWNLOAD_DIR=/Users/you/Downloads      # Where to look for downloadable files
SALIM_UPLOAD_DIR=/Users/you/Desktop         # Where to save uploaded files
SALIM_MAX_FILE_MB=50                         # Max size of files to send via Telegram
SALIM_SCREENSHOT_QUALITY=85                 # JPEG quality for screenshots (1-100)
SALIM_LOG_COMMANDS=true                     # Keep an audit log of all commands

# Groq AI integration (optional — set during setup or add manually)
SALIM_GROQ_API_KEY=gsk_...
SALIM_GROQ_MODEL=openai/gpt-oss-120b

You can also change settings from inside Telegram:

/config set max_file_mb 200
/config set screenshot_quality 95

🚀 Run Automatically at Startup

Want Salim to start every time your computer boots?

macOS

# Save this as ~/Library/LaunchAgents/com.salim.plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>             <string>com.salim</string>
    <key>ProgramArguments</key>  <array><string>/usr/local/bin/salim</string><string>start</string><string>--no-banner</string></array>
    <key>RunAtLoad</key>         <true/>
    <key>KeepAlive</key>         <true/>
    <key>StandardErrorPath</key> <string>/tmp/salim.err</string>
</dict>
</plist>

launchctl load ~/Library/LaunchAgents/com.salim.plist

Linux (systemd)

# /etc/systemd/system/salim.service
[Unit]
Description=Salim Laptop Control Bot
After=network.target

[Service]
Type=simple
User=youruser
ExecStart=/usr/local/bin/salim start --no-banner
Restart=always
RestartSec=10
Environment=DISPLAY=:0

[Install]
WantedBy=multi-user.target

sudo systemctl enable --now salim

Windows (Task Scheduler)

$action  = New-ScheduledTaskAction -Execute "salim" -Argument "start --no-banner"
$trigger = New-ScheduledTaskTrigger -AtLogOn
Register-ScheduledTask -TaskName "Salim" -Action $action -Trigger $trigger -RunLevel Highest

📦 Optional Features

Some features require extra packages. Install them for the full experience:

pip install pyautogui Pillow pyperclip aiofiles

If these aren't installed, Salim will tell you which commands need them and how to get them.

❓ Common Questions

Do I need technical knowledge to use this? Not at all. Run pip install salim then salim setup — the wizard explains every step clearly with examples.

Is it safe to leave running? Yes. Only your approved Telegram accounts can send commands. All others are completely ignored.

What if I lose internet / Telegram goes down? Salim will automatically reconnect. The bot just waits patiently.

Can multiple people control one laptop? Yes — add multiple Telegram user IDs with salim adduser. Each person's commands are logged separately.

Do I need to pay for the AI features? Groq provides free-plan access to the supported models, subject to its published rate limits. Paid plans may provide higher limits.

Does this work on Windows? Yes — macOS, Linux, and Windows are all supported.

What if a command fails? Salim tells you exactly what went wrong in plain English. For AI key problems, it tells you the exact error (like "401 Unauthorized") so you know whether it's a wrong key or a network issue.

📄 License

MIT — free to use, modify, and share. See LICENSE.

Made with ❤️ — Control your world from your pocket.