Tostapunk / PC-Control-telegram-bot

Control your PC directly from Telegram!
MIT License
67 stars 14 forks source link
pc-control python remote-control telegram telegram-bot windows
logo logo

PC Control bot

Through this bot you can execute actions on your PC directly from Telegram!

Getting Started

Prerequisites

GNU/Linux users: to use UI features (setup with UI and memo) you need to install the python-tk package

Install the requirements

Execute python -m pip install -r requirements.txt

Setup the bot

UI

Launch the setup with python bot/bot_setup.py

Add your BotFather token and start it!

setup

Command line

You can also setup the bot from the command line by using python bot/bot_setup.py followed by a valid option.\ To see all the available options use python bot/bot_setup.py -h

Set the permissions

The first user registered into the database will have admin permissions by default. \ You can add or remove a user from the admin group by using the UI or the command line.\ Note: you need to use a Telegram username (write it without '@')

UI example:

privs

Available commands

Command Description Note
/shutdown Shutdown your PC
/reboot Reboot your PC
/logout Log out from your current account Currently not working on Linux
/hibernate Hibernate your PC
/lock Lock your PC Currently not working on Linux
/cancel Annul the previous command It work with the first two commands_t
/check Check the PC status
/launch Launch a program Example: /launch notepad
/link Open a web link Example: /link http://google.com (don't use "www")
/memo Show a memo on your pc Tkinter needed
/task Check if a process is currently running or kill it Example: /task chrome
/screen Take a screenshot and receive it
/menu Shows the inline menu
/kb or /keyboard Brings the normal keyboard up

You can set a delay time for the execution of the first four commands by using _t + time in minutes after a command.\ Example: /shutdown_t 2

Contributors

Thanks to Jasoc for the awesome logo!