Discord Python RAT Documentation

Introduction

The Discord Python RAT (Remote Administration Tool) is a project designed to provide remote administration capabilities using Discord as the communication platform. It leverages the Discord Bot API to manage and control a system remotely through various commands. This document aims to explain the functionalities of each module (feature) and provide examples of how to use them.

Table of Contents

1. Command List
2. Modules
3. Contribute

   Command List

Modules

.help

Displays a list of available commands with their descriptions.

Example:

YOU>.help
CLIENT>
.help               - Shows this message
.ping               - Latency delay of the bot
.cd <directory>     - Change Directory
.ls                 - List Directory
.export <file>      - Export File into link
.upload <link>      - Upload File from link
.cmd <cmd>          - Execute CMD Command
.run <file>         - Run a File
.ss                 - Take a Screenshot of the first monitor
.blue               - Sends a bluescreen ;)
.start              - Adds the bot to the startup directory
.exit               - Closes the connection to the bot
.reload             - Reloads the connection to the bot
.volumeup           - Increase the system volume
.volumedown         - Decrease the system volume
.admincheck         - Check admin privileges
.location           - Get location information
.clipboard          - Get clipboard content
.wallpaper          - Change wallpaper
.export             - Export file into link
.upload             - Upload file from link
.shell              - Execute shell command
.run                - Run command
.cd                 - Change directory
.input              - Send keystrokes
.type               - Type text
.say                - Text to speech
.message            - Display message box
.mouse              - Display mouse grid

.ping

Shows the latency delay of the bot in milliseconds.

Example:

YOU>.ping
CLIENT>
Pong!
jk here's the latency: 203ms

.cd \<directory>

Change the current working directory.

Example:

YOU>.cd C:\Users\Username\Documents
CLIENT>
Changed Directory > C:\Users\Username\Documents

.ls

List files in the current directory.

Example:

YOU>.ls
CLIENT>
Files > C:\Users\Username\Documents
file1.txt
file2.doc

.export \<file>

Export a file and provide a link.

Example:

YOU>.export example.txt
CLIENT>
Export
https://example.com/file.txt

.upload \<link>

Upload a file from a provided link.

Example:

YOU>.upload https://example.com/file.txt
CLIENT>
Uploaded file in current directory:
C:/example/directory/example.txt

.cmd \<cmd>

Execute a command using CMD.

Example:

YOU>.cmd ipconfig
CLIENT>
CMD Output:
Windows IP Configuration
...

.run \<file>

Run an executable file.

Example:

.run program.exe

(no output)

.ss

Take a screenshot of the first monitor.

Example:

YOU>.ss
CLIENT>
(Screenshot of Desktop)

.blue

Trigger a bluescreen on the system.

Example:

YOU>.blue
CLIENT>
Attempting...
Blue Successful!

.start

Add the bot to the system's startup directory.

Example:

YOU>.start
CLIENT>
Bot added to startup directory

.exit

Close the connection to the bot.

Example:

YOU>.exit
CLIENT>
Connection closed

.reload

Reload the connection to the bot.

Example:

YOU>.reload
CLIENT>
Reloading, please be patient...
Connection reloaded

.volumeup

Increase the system volume to 100%.

Example:

YOU>.volumeup
CLIENT>
Volume is set to 100%

.volumedown

Decrease the system volume to 0%.

Example:

YOU>.volumedown
CLIENT>
Volume is set to 0%

.admincheck

Check if the bot has admin privileges.

Example:

YOU>.admincheck
CLIENT>
Congrats, you're admin

.location

Get the current geolocation information.

Example:

YOU>.location
CLIENT>
Location: http://www.google.com/maps/place/latitude,longitude

.clipboard

Get the content of the system clipboard.

Example:

YOU>.clipboard
CLIENT>
Clipboard content is:
This is clipboard text

.wallpaper

Change the system wallpaper.

Example:

YOU>.wallpaper <attached image>
CLIENT>
Changed wallpaper

.input

Send a combination of keystrokes.

Example:

YOU>.input Ctrl Alt Delete
CLIENT>
Sent keystroke: Ctrl+Alt+Delete

.type

Type specified text as if it were typed by a keyboard.

Example:

YOU>.type Hello, World!
CLIENT>
Sent: Hello, World!

.say

Convert text to speech and play it.

Example:

YOU>.say Hello, how are you?
CLIENT>
Just said: Hello, how are you?

.shell

Execute a shell command on the system.

Example:

.shell dir
CLIENT>
(shell output)

.run

Run a command on the system using subprocess.

Example:

.run notepad.exe
(no output)

⚠ WIP ⚠:

.message

Display a message box on the system.

.mouse

Display a grid on the screen to help locate the mouse pointer.

Example:

.mouse large

Note: The large argument specifies the size of

the grid (large, medium, small, tiny).

Contribute - How?

I welcome contributions from the community to enhance and improve this project. If you're interested in contributing, follow these steps:

Getting Started

1. Fork the Repository: Start by forking the project repository to your GitHub account. This will create a copy of the project under your account.

2. Clone the Repository: Clone the forked repository to your local machine using the following command:

   git clone https://github.com/your-username/repository.git

3. Create a Branch: Create a new branch for your changes. This helps in isolating your work from the main codebase.

   git checkout -b feature-name

4. Make Changes:

   • Make a Discord bot
   • Make it admin and give it all permissions
   • Invite the Discord bot into your Server
   • Make a new File called Settings.py in the same directory as main.py
   • add following code:

     bot_token ="<INSERT YOUR BOT TOKEN>"
     guild_id = <ID OF YOUR DISCORD-SERVER>

   • Implement your changes while adhering to best coding practices and using common sense. Write clear and concise code that follows the existing style and structure.

5. Test Your Changes: Ensure that your changes work as expected and do not introduce any new issues. If they do its not bad its just... difficult.

Submitting Changes

6. Commit Changes: Once you are satisfied with your changes, commit them with a clear and descriptive commit message.

   git commit -m "Add feature: your feature name"

7. Push Changes: Push your changes to your forked repository on GitHub.

   git push origin feature-name

8. Create a Pull Request (PR): Open a pull request from your forked repository to the main project repository. Provide a detailed description of your changes, and our team will review it.

Code Guidelines

When contributing, please adhere to the following guidelines:

• Follow best coding practices relevant to the programming language used.
• Write clear and meaningful commit messages.
• Keep your codebase well-documented.
• Ensure your changes do not break existing functionality.
• Use common sense to make decisions that contribute to the overall improvement of the project.

Thank you for considering contributing to our project! Your efforts help make this project better for everyone
I will try to give you credits for what you did and how it helped in the project!