<p align="center"> <img src="https://github.com/xanonDev/pinkcord/blob/main/pic/banner.png" alt="Pinkcord Banner" /> </p> <h1 align="center">Pinkcord</h1> <p align="center"> <strong>A Discord Bot C2 Framework for Remote Administration (Educational Purposes Only)</strong> </p> <p align="center"> <a href="https://www.buymeacoffee.com/pinkcord"><img alt="Support via BuyMeACoffee" src="https://img.shields.io/badge/Support-Buy%20Me%20A%20Coffee-yellow?style=for-the-badge&logo=buymeacoffee"></a> <a href="https://github.com/xanonDev/pinkcord/stargazers"><img alt="GitHub Stars" src="https://img.shields.io/github/stars/xanonDev/pinkcord?style=for-the-badge&logo=github&color=yellow"></a> <a href="https://github.com/xanonDev/pinkcord/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/xanonDev/pinkcord?style=for-the-badge&logo=github"></a> <a href="https://github.com/xanonDev/pinkcord/issues"><img alt="GitHub Issues" src="https://img.shields.io/github/issues/xanonDev/pinkcord?style=for-the-badge&logo=github&color=red"></a> <a href="https://github.com/xanonDev/pinkcord/network/members"><img alt="GitHub Forks" src="https://img.shields.io/github/forks/xanonDev/pinkcord?style=for-the-badge&logo=github&color=blue"></a> <a href="https://discord.gg/gX72uKxJr7"><img alt="Discord Community" src="https://img.shields.io/discord/1146757562646151168?label=Discord&logo=discord&logoColor=white&color=5865F2&style=for-the-badge"></a> </p>

⚠️ Disclaimer: Educational Use Only

Pinkcord is a tool created strictly for educational and research purposes. It demonstrates how Discord's API can be leveraged for command and control (C2) communication, similar in concept to frameworks like Meterpreter but operating over Discord instead of traditional C2 channels.

Using Pinkcord for any unauthorized access, malicious activities, or illegal purposes is strictly prohibited. Doing so violates Discord's Terms of Service, may lead to the permanent ban of your Discord account(s), and could result in severe legal consequences.

By downloading or using this software, you agree that you are solely responsible for your actions and any potential misuse. The developers assume no liability and are not responsible for any damage or legal issues caused by the use or misuse of this program. Use it ethically and responsibly within controlled environments for learning purposes only.

🤔 What is Pinkcord?

Pinkcord is a Python-based remote administration tool that uses Discord bots as a communication channel to control remote computers. Unlike traditional RATs or frameworks like Metasploit's Meterpreter that might require direct network access or complex setup, Pinkcord leverages the ubiquity and infrastructure of Discord for C2 communication.

Key Features:

Discord C2: Uses Discord bots for sending commands and receiving output.
Remote Shell: Execute commands on the target machine.
File Transfer: Upload and download files.
Screen Capture: Take screenshots of the target's desktop.
System Interaction: Control volume, display messages, simulate clicks/keystrokes.
Information Gathering: Retrieve system details, IP location, clipboard content.
Persistence: Option to copy the agent to the startup folder.
Data Exfiltration: Steal browser cookies (Chrome).

🛡️ Note on Antivirus & Windows Defender

Running Pinkcord or its compiled executable may trigger warnings from Windows Defender or other antivirus software. This is expected because the tool performs actions commonly associated with malware, such as:

Executing arbitrary shell commands (os.system, subprocess).
Interacting with user input/output (keylogging, screenshots via pyautogui, keyboard).
Modifying system state (changing volume, accessing files, adding to startup).

These detections are often based on the behavior and capabilities of the program, not necessarily malicious code signatures. Pinkcord itself, when used as intended for education, does not contain intentionally harmful payloads beyond its described functionality. You may need to create exclusions in your AV software within your controlled testing environment if you choose to experiment with it. Do not disable your antivirus on systems you are not authorized to test on.

⚙️ Setup & Installation

Install Python: Download and install Python (version 3.x recommended) from the official Python website. Make sure to check "Add Python to PATH" during installation.
Download Pinkcord: Clone or download the repository files:
```
git clone https://github.com/xanonDev/pinkcord.git
cd pinkcord
```
Alternatively, download the ZIP file and extract it.
Run Setup: Open a command prompt (Windows) or terminal (Linux/macOS) in the pinkcord directory and run the setup script. This script will guide you through configuration (like entering your Discord Bot Token and Guild ID) and install necessary dependencies.
- On Windows:
```
python setup.py
```
  or simply double-click setup.bat.
- On Linux/macOS:
```
python3 setup.py
```
- Note: If commands fail, try using py instead of python or python3.
Follow Instructions: The setup script will provide further instructions, potentially including compiling the chosen version into an executable (.exe).
Deployment (For Testing): If the program compiles to an .exe, deploy and run this executable on the target machine you own or have explicit permission to test on.

📦 Available Versions

During setup, you can choose between different versions based on your needs, balancing features and detectability:

pinkcord_minimal.py
- Features: Reverse shell functionality only.
- Size: Smallest (~<8MB compiled).
- Detection: Lowest chance of detection due to limited features.
pinkcord_lite.py
- Features: Minimal features + File upload/download, Screenshot capability.
- Size: Medium (~15-35MB compiled, depending on Pillow installation).
- Detection: Slightly higher detection potential than minimal.
pinkcord.py (Full Version)
- Features: All capabilities included (keylogger, info gathering, system interaction, etc.).
- Size: Largest (~20-45MB compiled, depending on Pillow installation).
- Detection: Highest chance of detection due to comprehensive feature set.

💻 Command Reference

Interact with compromised sessions via commands sent through your Discord bot. Replace [session] with the target session ID/name.

Pinkcord

Install / Use

README