Discord Remote

Discord Remote is a collection of AutoHotKey scripts that allow you to control your Windows PC remotely via Discord.

How it works

1. Discord Remote runs on the PC that's being controlled remotely
2. The user sends commands and parameters in a specific Discord channel
3. Every second, Discord Remote tries to copy the most recent message of that channel
4. If the script finds a message, it compares the message with the available commands
5. If the message corresponds to a command, it executes the command with the parameters that were passed
6. If the command outputs something, the output is sent into another specific Discord channel
7. The user can then read the results of his commands in that output channel

Features

• Full remote control of your PC
• Read and execute commands remotely
• Take screenshots remotely
• Keep your PC awake remotely
• Automatic recovery from bad inputs
• Included AutoHotKey interpreter

Commands

All the commands and their details can be seen remotely by using the Help command

• Help: Show how to use a command and list all commands
• Bulk: Execute multiple commands at once
• Clear: Remove all messages in the input and output channels
• Click: Send a mouse click (Similar to AutoHotKey's Click function)
• Focus: Focus a specific window (bring it to the foreground)
• Hide: Change the opacity of a specific window
• Input: Send inputs (Similar to AutoHotKey's SendInput function)
• Mouse: Move the mouse to the specified position on the screen
• Ping: Send a simple ping to see if Discord Remote is running
• Process: Output a list of running processes with their identifiers
• Screenshot: Take a screenshot and send it in the output channel
• Search: Search text in the Windows search box and start the first result
• Shutdown: Terminate Discord Remote and optionally lock the PC
• Text: Send text (Similar to AutoHotKey's SendText function)
• Wait: Wait for X milliseconds
• Details and examples are available when using Discord Remote

Limitations

• Doing anything is very slow

How to use

1. Download and install Discord
2. Start Discord and create 2 channels in any server:
   1. Create a channel named discord-remote-in
      • Everyone who has access to this channel will be able to send commands
   2. Create a channel named discord-remote-out
      • Everyone who has access to this channel will be able to read command results
3. Download the latest release of Discord Remote (Discord-Remote.exe)
   • If you had a previous version of Discord Remote, you should delete its old Scripts directory
4. Warning: After the next step, your PC will be controlled by the scripts
   • Attempting to use the PC might produce unexpected results like selecting or opening random apps and documents
5. Start Discord-Remote.exe like any other executable
6. Discord Remote is now running and can receive commands
   • You can send commands from any other device that can access Discord (browser or app)
   • Commands must be sent into the discord-remote-in channel
   • Command results will be sent in the discord-remote-out channel
7. To stop Discord Remote, send the Shutdown command
   • Alternatively, you can press F4 on the PC being controlled

Configuration

You can configure a few things in Discord Remote by modifying the config file

1. Changing the default input and output Discord channels

   • Open ./Scripts/Config.ini
   • Change discord-remote-in to any unique channel name
   • Change discord-remote-out to any unique channel name

2. Changing processing delays

   • If you have a faster computer, you can decrease the processing delays
     • A command with delays that are too short might produce unexpected results
   • If you have a slower computer, you can increase the processing delays
     • A command with higher delays will be slower but more reliable
   • Open ./Scripts/Config.ini and change processDelay
   • The delay is the amount of milliseconds to wait for the processing of certain inputs

3. Automatically hide Discord when starting Discord Remote

   • Open ./Scripts/Config.ini
   • Set autoHideDiscord to true
   • Be aware that, while Discord is hidden, it is still focused and intercepting keyboard inputs

4. Adding commands

   • You can add a new command by creating a file in the ./Scripts/Commands directory
   • The name of the file will be the name of the command
   • The name must be a capital letter followed by lowercase letters and must not contain spaces
   • The new command can now be used like any default one
   • If you want, you can modify ./Scripts/Commands/Help.ahk to add a help message for your new command