Reco PC Server
Reco PC Server is a cross platform PC Controller Discord Bot which is a modified and improved version of Chimera for Reco-Discord PC Remote Controller app & it's written in Python discord.py.
Using Reco you can easily control your computer remotely and have it do from simple tasks such as shutdown, sleep, and lock to opening a website or executing powershell commands.
Reco PC Server is a self hosted bot, which means that you have to run the bot on your computer - the machine you want to control via discord commands.
Installing Reco PC Server is an easy 3 minute process.
Quick Jumps
- Reco-Mobile App
-
🔸 Commands List - Commands Documentation
- Webhook Restricter
-
🔸 Installation Process - Installation Error-Help
- Setting up Task Scheduler for Reco-Startup
- For Contributing
- Donate
- Credits
- Contributors
Reco - Mobile App ↟
Reco: Discord PC Remote Controller-Mobile App is now available on Play Store
- Reco-Mobile App contain 4 tabs
- Home Screen
- Media Screen
- Command Screen
- Webhook Screen
Screenshots:
Requirements:
- Python 3
- discord.py
- mss
- opencv-python
- pynput
- requests
- python-dotenv
- pystray
- Pillow
- plyer
- pytube
Features List: ↟
- Abort
- App Quitter
- Battery Level
- Battery Report Generator
- Camera
- Cmd
- Clip
- Echo
- File
- Helpme
- Hibernate
- Launch
- Lock
- Log
- Logoff
- Media
- Music
- Notification
- Powershell
- Restart
- Say
- Screenshot
- Search (Google)
- Shutdown
- Sleep
- System Info
- URL Launcher
- Version Checker
- Wlan Signal
- WhatsApp (click to chat)
- YouTube (search)
Features Documentation: ↟
★ Abort ⇪
-
!abort
Aborts the Shutdown or Restart schedule.
e.g: !abort
★ AppQuitter ⇪
-
!appquitter Application_Name or !appquitter Application_Name minutes
Quits the specified application immediately or with a time delay in minutes.
e.g: !appquitter chrome 30
★ Battery Level ⇪
-
!batterylevel
To check the estimated battery charge remaining.
e.g: !batterylevel
★ Battery Report Generator ⇪
-
!batteryreport
Generates a detailed battery report for your PC. Screenshots
e.g: !batteryreport
★ Camera ⇪
-
!camera command or !camera command time
Controls computer camera for taking photo or filming for a given time in seconds (default is 5 seconds).
e.g: !camera video 10 list of commands: - video time - photo
★ Cmd ⇪
-
!cmd "command"
Executes command in cmd.exe.
e.g: !cmd shutdown -a
★ Clip ⇪
-
!clip text
Copy the message to your PC's Clipboard.
e.g: !clip Copy this text to PC's Clipboard
★ Echo ⇪
-
!echo status
Turns on or off !cmd and !powershell command echo in chat. When turned on, the command return will be sent to chat.
e.g: !echo on (or) !echo off
★ File ⇪
-
!file command or !file command path
Browses, saves and retrieves files from or to your computer.
e.g: !file relative .. list of commands: - absolute => sets an absolute path - relative => sets a relative path - list => lists current path - retrieve => uploads a file to the chat - save => saves a file to the HD from the chat - download => saves a file from a direct url to the HD
★ HelpMe ⇪
-
!helpme or !helpme command
Shows Reco help, listing commands of shows help for a specific command.
e.g: !helpme screenshot
★ Hibernate ⇪
-
!hibernate or !hibernate minutes
Hibernates your computer immediately or with a time delay in minutes.
e.g: !hibernate 30
★ Launch ⇪
-
!launch shortcut
Launches a custom shortcut you placed in the shortcuts folder.
e.g: !launch Application_Name_in_Shortcut_Folder
★ Lock ⇪
-
!lock or !lock minutes
Locks your computer immediately or with a time delay in minutes.
e.g: !lock 30
★ Log ⇪
-
!log param or !log param date
turns on or off chat logging or show log for given date (defaults to today).
e.g: !log show 2021-02-08
★ LogOff ⇪
-
!logoff or !logoff minutes
Logs off your user immediately or with a time delay in minutes.
e.g: !logoff 30
★ Media ⇪
-
!media command or !media command repeat_n_times
Controls computer media playback and volume once or repeatedly.
e.g: !media prev 2 list of commands: - vol-up - vol-down - vol-mute - next - prev - stop - play - pause - key-tab - key-space - key-enter - key-up - key-down - key-left - key-right - key-close - key-quit
★ Music ⇪
-
!music "query" or !m "query"
"query" can be a song name or video link or playlist link
Plays video music from YouTube in VLC Player.
⚠ To use this command you need to add VLC to the Path (Environmental Variables)Default path: C:\Program Files\VideoLAN\VLC
e.g: !music The Nights or !m The Nights !m quit - Quits the VLC Player. !m play - Play the paused song. !m pause - Pause the current playing song. !m stop - Stops the song. !m next - Play the next song if you have any queued song. !m prev - Play the previous song if you have any queued song.Advanced Music commands:
⚠ You can even download any video from YouTube using Reco into .mp3 or .mp4 file.⚠ ⚠ IMPORTANT: Sometimes Download feature won't work, maybe it's because of some changes made on YouTube's API and it will take time to get new some new update from Pytube package✌ .e.g: !music dm The Nights or !m dm The Nights !m dm *query* - Downloads music files. !m dv *query* - Downloads videos files. !m df - Shows Download folder.
★ Notification ⇪
-
!notification "message"
Sends a notification to the computer.
e.g: !notification who are you?
★ Powershell ⇪
-
!powershell "command"
Executes command in Powershell.
e.g: !powershell shutdown -s -t 300
★ Restart ⇪
-
!restart or !restart minutes
Restarts your computer immediately or with a time delay in minutes.
e.g: !restart 30
★ Say ⇪
-
!say "text"
Uses powershell commands and a TTS engine to make your computer say something.
e.g: !say Reco
★ ScreenShot ⇪
-
!screenshot or !screenshot seconds
Takes a screenshot of your computer and sends it back to you.
e.g: !screenshot 1
★ Google Search ⇪
-
!search or !search query
Helps you to search your query in Google very easily.
e.g: !search Reco Discord PC Remote Controller
★ Shutdown ⇪
-
!shutdown or !shutdown minutes
Shuts down your computer immediately or with a time delay in minutes.
e.g: !shutdown 30
★ Sleep ⇪
-
!sleep or !sleep minutes
Sleeps your computer immediately or with a time delay in minutes.
e.g: !sleep 30
★ System Info ⇪
-
!systeminfo
Shows your System Information.
e.g: !systeminfo
★ URL Launcher ⇪
-
!url website
Opens the website in your browser.
e.g: !url www.google.com
★ Version Checker ⇪
-
!version
Shows the current version of Reco PC Server.
e.g: !version
★ Wlan Signal ⇪
-
!wlansignal
To check the signal strength of a Wi-Fi Connection.
e.g: !wlansignal
★ Whatsapp ⇪
-
!whatsapp countryCode_MobileNumber
Opens chat screen for entered mobile number (Click to Chat feature).
e.g: !whatsapp 911234567890
★ YouTube Search ⇪
-
!youtube or !youtube search
Shows search result on YouTube.
e.g: !youtube Avicii - The Nights
Note:
- All above commands works best on Windows and some commands may not work on other platforms.
- And some commands may require elevated privileges on Linux.
Webhook Restricter: ↟
-
Using Reco mobile app you can easily control your PC using webhook. And if you want to share your webhooks with others and you want to restrict some commands.
-
You can restrict so easily by adding that webhook in webhook_restricter.py file.
-
Follow the commented instruction in that file.
Synatx for webhook restricter:
means Permission granted to use the command. # "False" => means Permission Denied to use the command. # ⚠ Powerfull Commands: (All powerfull commands will be "False" by default) '!abort':False, '!appquitter':False, '!cmd':False, '!file': False, '!hibernate':False, '!lock':False, '!logoff':False, 'media_Close&QuitKeys':False, # !media key-close, !media key-quit '!powershell':False, '!restart':False, '!shutdown':False, '!sleep':False, # Moderate Commands: '!camera':True, '!clip':True, '!launch':True, '!screenshot':True, # Media Commands: (!media) 'media_Function_Keys':True, # next, prev, stop, play, pause 'media_Volume_Keys':True, # vol-up, vol-down, vol-mute 'media_ArrowKeys':True, # key-up, key-down, key-left, key-right 'media_Tab,Space&EnterKeys':True, # key-tab, key-space, key-enter # Other Commands: '!batterylevel':True, '!batteryreport':True, '!echo':True, '!log':True, '!music':True, '!m':True, '!notification':True, '!say':True, '!search':True, '!systeminfo':True, '!url':True, '!version':True, '!whatsapp':True, '!wlansignal':True, '!youtube':True, } ">{ #1️⃣ Replace webhook Name 'webhookName':'Temp webhook', # Here you can enter the Webhook name, so you can identify easily in this file. #2️⃣ Replace webhook URL & ID 'webhookURL':'https://discord.com/api/webhooks/841227223729700866/aW4XpuFTUfweJIcQAqTSgikXZu6r5r6Q8MK_rOawf6qj_dyAUVQUCzbTm6Is0Bs8bQFG', 'webhookId':'841227223729700866', # You can obtain the "webhook id" by looking at the webhook URL, the number after https://discord.com/api/webhooks/ is the "id" , and the part after that is the token. #3️⃣ Before sharing your Webhook URL to others. you can set permission to each commands as you wish🥳 # "True" => means Permission granted to use the command. # "False" => means Permission Denied to use the command. # ⚠ Powerfull Commands: (All powerfull commands will be "False" by default) '!abort':False, '!appquitter':False, '!cmd':False, '!file': False, '!hibernate':False, '!lock':False, '!logoff':False, 'media_Close&QuitKeys':False, # !media key-close, !media key-quit '!powershell':False, '!restart':False, '!shutdown':False, '!sleep':False, # Moderate Commands: '!camera':True, '!clip':True, '!launch':True, '!screenshot':True, # Media Commands: (!media) 'media_Function_Keys':True, # next, prev, stop, play, pause 'media_Volume_Keys':True, # vol-up, vol-down, vol-mute 'media_ArrowKeys':True, # key-up, key-down, key-left, key-right 'media_Tab,Space&EnterKeys':True, # key-tab, key-space, key-enter # Other Commands: '!batterylevel':True, '!batteryreport':True, '!echo':True, '!log':True, '!music':True, '!m':True, '!notification':True, '!say':True, '!search':True, '!systeminfo':True, '!url':True, '!version':True, '!whatsapp':True, '!wlansignal':True, '!youtube':True, }
Installation: ↟
Text Instructions:
- Download & Install Python - Remember: Tick the Add to path checkBox during installation. -> https://www.python.org/
- Create a bot and get its token by following these instructions: https://youtu.be/-m-Z7Wav-fM
- Download the Reco PC Server Repository, run setup.bat on Windows or setup.sh on Linux and put your Bot Token in the newly created .env file.
- Get Webhook URL from your Channel and add it in your Webhook tab in your Reco mobile App. https://www.youtube.com/watch?v=2Fcvg-Bh7Oo&t=1s
- Launch reco.pyw, right click on the system tray icon and hit Connect to invite Reco Pc Server to your Discord server.
- Enjoy!
🥳
Video tutorial:
Click below GIF to see the video.
To Deal with any Error during Installation: ↟
Error 1: Building wheel for multidict (PEP 517) ... error
error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/
----------------------------------------
ERROR: Failed building wheel for multidict
Failed to build yarl multidict
ERROR: Could not build wheels for yarl, multidict which use PEP 517 and cannot be installed directly```
- Its an simple error and can easily solved by following below instrustion:
- We will Just Install and then Uninstall - Visual Studio C++ Build Tools.
- Now, just install Visual Studio Installer and then install Build Tools.
- And now try again to run setup.bat on Windows or setup.sh on Linux from Downloaded Reco Folder.
- After successfully installed Reco setup, Paste your Bot Token in the newly created .env file & continue following the instuction from the 4th Step
- And, now you can uninstall Visual Studio Installer from Controll Panel
Error 2: WARNING: The script chardetect.exe is installed in ........ which is not on PATH.
- To solve this issue just copy and paste the path which is given in the error in The Environmental variable.
-
eg:
WARNING: The script chardetect.exe is installed in 'C:\Users\USER_NAME\AppData\Roaming\Python\Python39\Scripts' which is not on PATH. -
If you get above given error in the console while running setup.bat or setup.sh. Then follow below given instruction.
-
Copy the Path from the error given in the setup.bat console or change the username in this path and try it: C:\Users\ USER_NAME\AppData\Roaming\Python\Python39\Scripts
-
Now go to Start Menu and Type: Edit environment variables for your account
-
In that click Path and then add the copied path in that field and click OK.
-
And now try again to run setup.bat on Windows or setup.sh on Linux from Downloaded Reco Folder.
-
After successfully installed Reco setup, Paste your Bot Token in the newly created .env file & continue following the instuction from the 4th Step
-
Setting up Task Scheduler for Reco-Startup: ↟
These instruction will help you to setup Reco to startup automatically when we start your PC. It looks like lenghty but its so easy to setup, just follow the steps. so chill, do and have fun...
- Open Task Scheduler by typing it inside the start menu.
- click Create Task
- Enter the Name as Reco Startup
- And now check(
✔ ) the Run with highest privileges checkBox - And then, go to Triggers tab and click New
- And set Begin the task: At log on and also set Delay task for: 8 seconds and then click OK
- And again click New and set Begin the task: On Workstation Unlock - Any user and also set Delay task for: 8 seconds and then click OK
- And now go to Actions tab and click New
- Now set
- Action: Start a Program
- Program/script: C:\Users\USERNAME\AppData\Local\Programs\Python\Python39\pythonw.exe (change the USERNAME in this path to your username)
- Add arguments(optional): reco.pyw
- Start in (optional): C:\Users\USERNAME\Downloads\Reco-PC-Server-main (change the USERNAME in this path to your username or paste the downloaded RecoPCServer Repository path)
- And click OK
- And now go to Conditions tab and uncheck all the checkBox and Check(
✔ ) ONLY Network CheckBox -> (Start only if following network connection avaliable: Any Connection) - And now Click OK
- Next time when you turn on your PC - Reco will Start Automatically
🥳 .
Contributing: ↟
Reco was written to be modular so one can easily modify the code and enhance it. I welcome and greatly appreciate anyone who wishes to contribute a module of their own. Here's how to create a Reco module:
- Create your *_module.py under the modules directory. See lock_module.py for a good example on how to structure yours.
- Create an entry for your modules in reco.pyw. The file is full of examples.
- Test Reco PC Server with your changes and make a pull request if everything works well.
- Update the README.md file to include your new module and your github profile under Contributors
Donate ↟
If you found this project helpful and want to thank me, consider buying me a cup of
Credits: ↟
- CedArctic and all contributors for creating Chimera which is modified and improved. And now it act as a server(PC controller) for Reco-Discord PC Remote Controller app.
8 Nov 22, 2022
30 Dec 7, 2022
2 Feb 28, 2022
3 Jun 4, 2021
1 Jan 13, 2022
16 Oct 21, 2022
75 Jan 2, 2023
14 Nov 16, 2022
2 Dec 16, 2021
10 Sep 25, 2022
39 Jan 1, 2023
1 Dec 26, 2021
66 Nov 19, 2022
421 Jan 5, 2023
0 Jan 16, 2022
2 Sep 15, 2022
2 Jan 16, 2022
23 Nov 9, 2022