How clowdyyy/pc-control works
PC Control is an administrator-only Telegram bot for monitoring and remotely controlling a Windows PC. The workflow starts at main.py, which registers handler routers and polls Telegram; an administrator’s request is dispatched to a feature handler, which reads system state or performs a local action, then replies through Telegram. The README also documents sleep/shutdown and other controls whose detailed handler implementations are present in the tree but were not sampled. Edges follow sampled calls or explicit README claims; unsampled relationships are omitted.
Main entry points: __init__.py Handler registration · config.py Bot configuration · main.py Polling entry · media.py Media controls
Components 17
Bot entry
- Bot configuration
config.py - Polling entry
main.py - Handler registration
handlers/__init__.py
System monitoring
- Status and system info
handlers/system.py - System metrics
utils/system_info.py - Process management
handlers/processes.py
Device controls
- Clipboard
handlers/clipboard.py - Media controls
handlers/media.py - Sleep and shutdown
handlers/power.py - Work mode
handlers/workmode.py
Media capture
- Screen capture
handlers/screenshot.py - Webcam capture
handlers/webcam.py
User interaction
- Bot keyboards
keyboards.py - Text to speech
handlers/tts.py - Start command
handlers/start.py
Other components
- Administrator
- Telegram
Connections 32
- Polling entry → Bot configuration: loads settings
main.py - Polling entry → Bot keyboards: sends startup keyboard
main.py - Polling entry → Handler registration: registers routers
main.py - Polling entry → Media controls: starts monitor
main.py - Polling entry → Telegram: polls updates
main.py - Administrator → Telegram: sends commands
README.md - Telegram → Polling entry: delivers updates
main.py - Handler registration → Start command: registers
handlers/__init__.py - Handler registration → Status and system info: registers
handlers/__init__.py - Handler registration → Clipboard: registers
handlers/__init__.py - Handler registration → Media controls: registers
handlers/__init__.py - Handler registration → Process management: registers
handlers/__init__.py - Handler registration → Sleep and shutdown: registers
handlers/__init__.py - Handler registration → Screen capture: registers
handlers/__init__.py - Handler registration → Text to speech: registers
handlers/__init__.py - Handler registration → Webcam capture: registers
handlers/__init__.py - Handler registration → Work mode: registers
handlers/__init__.py - Status and system info → Bot configuration: checks admin
handlers/system.py - Status and system info → System metrics: reads metrics
handlers/system.py - Process management → Bot configuration: checks admin
handlers/processes.py - Clipboard → Bot configuration: checks admin
handlers/clipboard.py - Media controls → Bot configuration: checks admin
handlers/media.py - Media controls → Bot keyboards: builds controls
handlers/media.py - Media controls → Telegram: updates panel
handlers/media.py - Sleep and shutdown → Bot configuration: checks admin
handlers/power.py - Work mode → Bot configuration: checks admin
handlers/workmode.py - Screen capture → Bot configuration: checks admin
handlers/screenshot.py - Webcam capture → Bot configuration: checks admin
handlers/webcam.py - Text to speech → Bot configuration: checks admin
handlers/tts.py - Start command → Bot configuration: checks admin
handlers/start.py - Start command → Bot keyboards: builds menu
handlers/start.py - Administrator → Telegram: receives results
README.md