Skip to content

PeaceKeeper96/ixxi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

Repository files navigation

IXXI

Overview

This project is a basic Discord Command and Control (C2) Handler written in Python. Using the discord library, it allows users to execute specific commands on a target system through a Discord bot. This project serves as a first foray into learning about bot development and command execution in a secure and controlled environment for myself.

Features

  • Connects to Discord using a user-provided bot token.
  • Executes system commands based on user input from Discord messages.
  • Handles command outputs and sends them back to the Discord channel.
  • Supports several commands including ls, cat, pwd, uname, whoami, and more.

Dependencies

Ensure you have the following installed:

  • Python 3.7 or later
  • discord.py library (can be installed via pip install discord.py)
  • python-dotenv library for environment variable management (can be installed via pip install python-dotenv)

Installation

  1. Clone the repository:

    git clone https://github.com/PeaceKeeper96/ixxi/
    cd ixxi
  2. Install the required dependencies:

    pip install discord.py python-dotenv
  3. Create a .env file in the project directory to securely store your Discord token and other sensitive credentials:

    DISCORD_TOKEN=your_discord_token_here
  4. Set your Discord user ID and the desired channel ID in the source code:

    discord_id = # Put your discord user ID here
    channel_id = # Put your desired C2 channel ID here

Usage

  1. Navigate to the project directory in your command line.

  2. Run the script using:

    python ixxi.py
  3. The bot will log in and be available in the specified Discord server.

Commands

The following commands can be executed via the Discord channel:

  • dir: Lists directory contents on the target machine.
  • ls : Lists contents of the specified directory (default is current directory).
  • PIKEMAN: Reads the /etc/passwd file.
  • VOLGIER: Reads the /etc/shadow file.
  • SWORDSMAN: Reads the /etc/group file.
  • WATCHER: Displays network interface configurations.
  • cat : Outputs the content of the specified file.
  • pwd: Displays the current working directory.
  • uname: Shows system information.
  • whoami: Displays the current user.
  • history: Shows the command history.

Security Considerations

  • Ensure that you have permission to execute commands on any target machine.
  • Use this script responsibly and only in environments where you have legal authorization.
  • Keep your token and user IDs secure & never share them publicly.

Future Improvements

  • Enhance error handling for command executions.
  • Add more sophisticated command parsing and execution capabilities.
  • Implement logging and tracking for executed commands.
  • Create an interactive help command.
  • General Cleanup of code.

License

This project is intended for educational purposes only. Modify as needed for your use case. Always adhere to ethical guidelines and legal standards in your software development practices.

About

A really simple python C2 bot i made for discord as a first project, to act against linux devices.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages