# SC-SysInfo — ScreenConnect Toolbox → Telegram

Drops a full system report to your Telegram in under a second when run on a customer's machine via ScreenConnect Toolbox.

## What it reports

| Category | Details |
|---|---|
| Network | Public IP, all local IPs (per adapter), MAC addresses |
| Connections | Top 10 active TCP/UDP sockets (ESTABLISHED) |
| Identity | Hostname, logged-in users, uptime |
| OS | Windows version, architecture, processor name |
| CPU | Core count, frequency, live usage % |
| RAM | Used / Total / % |
| Disks | Every drive: used / total / % |

---

## Setup (one-time, on your machine)

### Step 1 — Create a Telegram Bot
1. Open Telegram → message **@BotFather**
2. Send `/newbot`, follow prompts, copy the **Bot Token**
3. Message your new bot once, then open:  
   `https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates`  
   Copy the `"id"` value from `"chat"` — that's your **Chat ID**

### Step 2 — Edit the script
Open `sysinfo_bot.py` and replace the two placeholders at the top:

```python
BOT_TOKEN = "123456789:ABCdefGHI..."   # paste your bot token
CHAT_ID   = "987654321"                # paste your chat ID
```

### Step 3 — Build the .exe
Requirements: **Python 3.9+** must be installed on your machine.

Open PowerShell in the `sc-sysinfo-bot` folder and run:

```powershell
.\build.ps1
```

The finished executable will be at:
```
sc-sysinfo-bot\dist\SC-SysInfo.exe
```

---

## Adding to ScreenConnect Toolbox

1. In your ConnectWise ScreenConnect admin panel go to  
   **Admin → Toolbox**
2. Click **Upload Tool**
3. Upload `SC-SysInfo.exe`
4. Set the display name to something like `Get System Info → Telegram`
5. Run it on any session — no arguments needed, no console window appears

---

## Notes

- The `.exe` is fully self-contained (~15 MB), no Python needed on the customer machine.
- No data is stored anywhere — info goes directly to Telegram and nowhere else.
- The exe runs silently (no console window) and exits after sending.
- If the machine has no internet access the exe will exit quietly without crashing.
