pluto-siege 2.0.3__tar.gz → 2.1.0__tar.gz

pluto_siege-2.1.0/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: pluto_siege
+Version: 2.1.0
+Summary: PlutoSDR ISM-band RF capture and replay tool (433 MHz, 868 MHz, etc.).
+Author: SketchTurnerDev
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/SketchTurnerDev/pluto_siege
+Project-URL: Repository, https://github.com/SketchTurnerDev/pluto_siege.git
+Project-URL: Issues, https://github.com/SketchTurnerDev/pluto_siege/issues
+Keywords: 433mhz,868mhz,adalm-pluto,ham-radio,ism-band,pentesting,pluto-sdr,pluto-siege,plutosdr,plutosiege,python,radio-frequency,red-team,rf-hacking,sdr,security-tools,sigmf,subghz,wireless,wireless-security
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Environment :: Console :: Curses
+Classifier: Topic :: Communications :: Ham Radio
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyadi-iio>=0.0.16
+Requires-Dist: pylibiio<1.0
+Requires-Dist: numpy>=1.20.0
+Dynamic: license-file
+
+<h1 align="center">PlutoSiege</h1>
+
+<p align="center">
+  <strong>ISM-Band RF Capture & Replay Tool for PlutoSDR</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/pluto-siege/"><img src="https://img.shields.io/pypi/v/pluto-siege?style=for-the-badge&logo=pypi&logoColor=white&color=blue" alt="PyPI"></a>
+  <img src="https://img.shields.io/badge/Python-3.9+-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python">
+  <a href="https://github.com/SketchTurnerDev/pluto_siege/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-GPL--3.0-blueviolet.svg?style=for-the-badge" alt="License"></a>
+  <img src="https://img.shields.io/badge/Hardware-ADALM--Pluto-0099FF?style=for-the-badge" alt="Hardware">
+  <img src="https://img.shields.io/badge/Format-SigMF-orange?style=for-the-badge" alt="SigMF">
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/SketchTurnerDev/pluto_siege/main/assets/screenshot.png" alt="PlutoSiege Screenshot" width="100%">
+</p>
+
+> **REGULATORY DISCLAIMER**  
+> RF transmission is regulated by local authorities. Replay only signals you own or are permitted to transmit, into a dummy load or at the lowest power required.
+
+## About
+
+**PlutoSiege** is a terminal application (TUI) and command-line utility (CLI) for recording and replaying short ISM-band RF bursts (e.g. 433 MHz, 868 MHz) from car remotes, garage doors, doorbells, and wireless sensors.
+
+Built for the **ADALM-Pluto (AD9363/AD9361)** SDR architecture, it saves recordings in standard **SigMF (Signal Metadata Format)** so they can be opened in other SDR tools like URH, IQEngine, GNU Radio, or Inspectrum.
+
+### Hardware Compatibility
+Fully supports both official **Analog Devices ADALM-Pluto** hardware (Rev. B / Rev. C) and third-party clones/analogues based on the same AD9363/AD9361 transceivers (such as **Pluto Nano**, **Pluto Plus**, and other custom PlutoSDR boards).
+
+## Features
+
+- **Single & Continuous Capture**: Capture single RF bursts or enable **Auto capture** (`--auto-capture true`) to loop continuously and save numbered multi-burst recordings with collision-safe filenames.
+- **Level Metering**: Real-time dBFS level meter with saturation (`SAT!`) warning.
+- **Threshold Detection**: Automated noise floor estimation (with optional periodic recalibration for mobile capture) or manual threshold setting.
+- **Pre-Trigger Buffer**: Keeps a ring buffer of history before trigger so preambles are not missed.
+- **SigMF Format**: Saves `.sigmf-meta` and `.sigmf-data` pairs in a configurable recordings directory.
+- **GPS Geotagging**: Records precise coordinates in SigMF metadata via `gpsd` and displays geotags during replay.
+- **Digital Loopback Test**: Built-in internal digital BIST loopback test (at 1 GHz) to check hardware health and SNR without external antennas.
+- **Full CLI & Headless Mode**: Launch any mode or override any setting from the command line, list available recordings, or run completely headless without curses.
+- **Linux Native**: Built and optimized specifically for Linux environments (supports all major distribution families: Debian-based, RPM-based, Arch-based, etc.).
+
+## Installation
+
+### 1. System Drivers (libiio)
+Install the required IIO system drivers for your distribution family:
+
+**Debian-based (Ubuntu, Debian, Kali, Mint, etc.):**
+```bash
+sudo apt update && sudo apt install -y libiio0 libiio-dev libiio-utils
+```
+
+**RPM-based (Fedora, RHEL, CentOS, Rocky, etc.):**
+```bash
+sudo dnf install -y libiio python3-iio libiio-utils
+```
+
+**Arch-based (Arch Linux, Manjaro, etc.):**
+```bash
+sudo pacman -S libiio
+```
+
+### 2. Optional: GPS Support (gpsd)
+If you plan to use GPS geotagging for SigMF recordings, install the `gpsd` daemon and tools:
+
+**Debian-based:**
+```bash
+sudo apt install -y gpsd gpsd-clients
+```
+
+**RPM-based:**
+```bash
+sudo dnf install -y gpsd gpsd-clients
+```
+
+**Arch-based:**
+```bash
+sudo pacman -S gpsd
+```
+
+> **Note:** Configure and start the `gpsd` service according to your specific GPS receiver hardware (USB dongle, UART module, Bluetooth, or virtual source) so that it listens on `127.0.0.1:2947`. Once running, enable GPS in PlutoSiege **Settings** (`Enable GPS (gpsd): yes`) or via CLI (`--enable-gps true`).
+
+### 3. Install & Run PlutoSiege
+
+#### Option A: Via pip / pipx (Recommended)
+Install directly from PyPI:
+```bash
+pipx install pluto_siege
+# or: pip install pluto_siege
+```
+
+Launch from any terminal:
+```bash
+pluto_siege
+```
+
+#### Option B: From Source (Clone Repository)
+Clone the repository and install dependencies:
+```bash
+git clone https://github.com/SketchTurnerDev/pluto_siege.git
+cd pluto_siege
+pip install -r requirements.txt
+```
+
+Launch via the main script:
+```bash
+python pluto_siege.py
+# or: python -m pluto_siege
+```
+
+## Demo
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/SketchTurnerDev/pluto_siege/main/assets/demo.gif" alt="PlutoSiege Demo" width="100%">
+</p>
+
+## Application Menu
+
+The main menu provides access to all core operations:
+
+### 1. Capture
+Listens for incoming RF bursts on the configured receiver frequency (`rx_freq`).
+- Captures a single burst by default, or loops continuously (numbering saved bursts `[#1]`, `[#2]`, ... until stopped with `Esc` / `Q` in TUI or `Ctrl+C` in headless mode) when **Auto capture** (`--auto-capture true`) is enabled.
+- Real-time dBFS level meter with saturation (`SAT!`) warnings.
+- Automated noise floor estimation or manual threshold detection.
+- Pre-trigger history ring buffer to preserve signal preambles.
+- Saves captures as standard SigMF (`.sigmf-meta` and `.sigmf-data`) pairs with optional GPS geolocation tags.
+
+### 2. Transmit
+Browse and replay saved SigMF recordings from the configured recordings directory (`records_dir`).
+- Displays recorded timestamp, center frequency, sample rate, sample count, and GPS coordinates.
+- Replays signals via the PlutoSDR transmitter at the exact frequency (`core:frequency`) and sample rate (`core:sample_rate`) stored in `.sigmf-meta`.
+- In-place deletion of unwanted recordings (`D` or `Delete`).
+
+### 3. Loopback Test
+Internal hardware diagnostic to verify the SDR transceiver and USB/DMA pipeline.
+- Enables the AD936x internal digital BIST loopback (`loopback = 1`) at 1 GHz without transmitting over the air.
+- Calculates received Signal-to-Noise Ratio (SNR) to confirm hardware health.
+
+### 4. Settings & CLI Parameters
+Configures radio parameters, trigger behavior, GPS integration, and interface preferences. All settings can be edited interactively in the TUI **Settings** screen or passed via command-line flags.
+
+| Flags / Parameter | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `--pluto-uri, --pu` | `str` | `usb:` | PlutoSDR `libiio` context URI (`usb:`, `usb:1.4.5`, `ip:192.168.2.1`, `local:`). |
+| `--rx-freq, --rf` | `int` | `433.92M` | Receiver center frequency in Hz; supports `k`/`M`/`G` suffixes and bare MHz shorthand (`70M - 6G`; e.g. `433`, `868`). |
+| `--sample-rate, --sr` | `int` | `2.1M` | Sample rate in SPS; supports `k`/`M` suffixes (`521k - 61.44M`). |
+| `--rf-bandwidth, --rb` | `int` | `0` | Analog RF filter bandwidth in Hz, or `0`/`auto` to follow `--sample-rate`; supports `k`/`M` suffixes (`0` or `200k - 56M`). |
+| `--rx-gain, --rg` | `float` | `15.0` | Manual RX hardware gain in dB (`-10.0 .. 74.5`). |
+| `--tx-gain, --tg` | `float` | `0.0` | Manual TX hardware gain in dB (`-89.75 .. 0.0`). |
+| `--tx-repeats, --tr` | `int` | `1` | Number of consecutive burst transmissions per replay (`1 .. 100`). |
+| `--auto-capture, --ac` | `bool` | `false` | Enable continuous multi-burst capture loop (`true` or `false`). |
+| `--auto-threshold, --at` | `bool` | `true` | Enable automatic noise floor threshold detection (`true` or `false`). |
+| `--auto-trigger-margin, --atm` | `float` | `8.0` | Trigger margin above noise floor in dB (`1.0 .. 30.0`; unused when `--auto-threshold` is `false`). |
+| `--auto-recal-seconds, --ars` | `float` | `0.0` | Periodic noise floor recalibration interval in seconds while listening, or `0` to disable; supports `ms`/`s` suffixes (`0.0 .. 600.0`; unused when `--auto-threshold` is `false`). |
+| `--manual-threshold, --mt` | `float` | `-30.0` | Fixed trigger threshold in dBFS (`-120.0 .. 0.0`; unused when `--auto-threshold` is `true`). |
+| `--pre-trigger-buffers, --ptb` | `int` | `2` | Number of pre-trigger history buffers kept in memory (`1 .. 50`). |
+| `--min-burst-seconds, --mbs` | `float` | `0.0` | Minimum active burst duration in seconds to filter short noise spikes, or `0` to disable; supports `ms`/`s` suffixes (`0.0 .. 5.0`). |
+| `--silence-seconds, --ss` | `float` | `0.8` | Continuous silence duration in seconds to stop recording; supports `ms`/`s` suffixes (`0.01 .. 10.0`). |
+| `--max-post-trigger-seconds, --mpts` | `float` | `4.0` | Maximum recording duration in seconds after trigger; supports `ms`/`s` suffixes (`0.1 .. 30.0`). |
+| `--rx-buffer-size, --rbs` | `int` | `32768` | DMA receive buffer size in samples (`1024 .. 1048576`). |
+| `--enable-gps, --eg` | `bool` | `false` | Enable GPS geolocation tagging via `gpsd` daemon (`true` or `false`). |
+| `--gpsd-host, --gh` | `str` | `127.0.0.1` | `gpsd` daemon hostname or IP address (unused when `--enable-gps` is `false`). |
+| `--gpsd-port, --gp` | `int` | `2947` | `gpsd` daemon TCP port (`1 .. 65535`; unused when `--enable-gps` is `false`). |
+| `--records-dir, --rd` | `str` | `./recordings` | Directory path for saving and loading SigMF recordings (`~/.pluto_siege/recordings` when installed via `pip`/`pipx`). |
+| `--enable-sound, --es` | `bool` | `true` | Enable acoustic sound effect cues (`true` or `false`). |
+| `--enable-mouse, --em` | `bool` | `true` | Enable terminal mouse support in the TUI (`true` or `false`). |
+
+### CLI-Only Options
+
+| Flags | Description |
+| :--- | :--- |
+| `--capture, -c` | Start in Capture mode. |
+| `--transmit, --tx` | Start in Transmit mode (pass a recording `#` from `--list`, `.sigmf-data` path, `'latest'`, or omit in TUI). |
+| `--loopback, --lb` | Run the internal digital Loopback Test. |
+| `--list, -l` | List available SigMF recordings in `records-dir` and exit. |
+| `--show-config, --sc` | Show current configuration and exit. |
+| `--headless, --hl` | Run in console text mode without the curses TUI (outputs plain logs without colors or live meter when redirected to a file/pipe; supports `NO_COLOR` / `FORCE_COLOR`). |
+| `--save, -s` | Persist CLI setting changes to `settings.json`. |
+| `--reset, -r` | Reset configuration to defaults and save to `settings.json`. |
+| `--version, -v` | Show program version and exit. |
+| `--help, -h` | Show help message and exit. |
+
+## License
+
+Distributed under the **GNU General Public License v3.0** (GPL-3.0). See [`LICENSE`](https://github.com/SketchTurnerDev/pluto_siege/blob/main/LICENSE) for details.

pluto_siege-2.1.0/README.md

@@ -0,0 +1,186 @@
+<h1 align="center">PlutoSiege</h1>
+
+<p align="center">
+  <strong>ISM-Band RF Capture & Replay Tool for PlutoSDR</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/pluto-siege/"><img src="https://img.shields.io/pypi/v/pluto-siege?style=for-the-badge&logo=pypi&logoColor=white&color=blue" alt="PyPI"></a>
+  <img src="https://img.shields.io/badge/Python-3.9+-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python">
+  <a href="https://github.com/SketchTurnerDev/pluto_siege/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-GPL--3.0-blueviolet.svg?style=for-the-badge" alt="License"></a>
+  <img src="https://img.shields.io/badge/Hardware-ADALM--Pluto-0099FF?style=for-the-badge" alt="Hardware">
+  <img src="https://img.shields.io/badge/Format-SigMF-orange?style=for-the-badge" alt="SigMF">
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/SketchTurnerDev/pluto_siege/main/assets/screenshot.png" alt="PlutoSiege Screenshot" width="100%">
+</p>
+
+> **REGULATORY DISCLAIMER**  
+> RF transmission is regulated by local authorities. Replay only signals you own or are permitted to transmit, into a dummy load or at the lowest power required.
+
+## About
+
+**PlutoSiege** is a terminal application (TUI) and command-line utility (CLI) for recording and replaying short ISM-band RF bursts (e.g. 433 MHz, 868 MHz) from car remotes, garage doors, doorbells, and wireless sensors.
+
+Built for the **ADALM-Pluto (AD9363/AD9361)** SDR architecture, it saves recordings in standard **SigMF (Signal Metadata Format)** so they can be opened in other SDR tools like URH, IQEngine, GNU Radio, or Inspectrum.
+
+### Hardware Compatibility
+Fully supports both official **Analog Devices ADALM-Pluto** hardware (Rev. B / Rev. C) and third-party clones/analogues based on the same AD9363/AD9361 transceivers (such as **Pluto Nano**, **Pluto Plus**, and other custom PlutoSDR boards).
+
+## Features
+
+- **Single & Continuous Capture**: Capture single RF bursts or enable **Auto capture** (`--auto-capture true`) to loop continuously and save numbered multi-burst recordings with collision-safe filenames.
+- **Level Metering**: Real-time dBFS level meter with saturation (`SAT!`) warning.
+- **Threshold Detection**: Automated noise floor estimation (with optional periodic recalibration for mobile capture) or manual threshold setting.
+- **Pre-Trigger Buffer**: Keeps a ring buffer of history before trigger so preambles are not missed.
+- **SigMF Format**: Saves `.sigmf-meta` and `.sigmf-data` pairs in a configurable recordings directory.
+- **GPS Geotagging**: Records precise coordinates in SigMF metadata via `gpsd` and displays geotags during replay.
+- **Digital Loopback Test**: Built-in internal digital BIST loopback test (at 1 GHz) to check hardware health and SNR without external antennas.
+- **Full CLI & Headless Mode**: Launch any mode or override any setting from the command line, list available recordings, or run completely headless without curses.
+- **Linux Native**: Built and optimized specifically for Linux environments (supports all major distribution families: Debian-based, RPM-based, Arch-based, etc.).
+
+## Installation
+
+### 1. System Drivers (libiio)
+Install the required IIO system drivers for your distribution family:
+
+**Debian-based (Ubuntu, Debian, Kali, Mint, etc.):**
+```bash
+sudo apt update && sudo apt install -y libiio0 libiio-dev libiio-utils
+```
+
+**RPM-based (Fedora, RHEL, CentOS, Rocky, etc.):**
+```bash
+sudo dnf install -y libiio python3-iio libiio-utils
+```
+
+**Arch-based (Arch Linux, Manjaro, etc.):**
+```bash
+sudo pacman -S libiio
+```
+
+### 2. Optional: GPS Support (gpsd)
+If you plan to use GPS geotagging for SigMF recordings, install the `gpsd` daemon and tools:
+
+**Debian-based:**
+```bash
+sudo apt install -y gpsd gpsd-clients
+```
+
+**RPM-based:**
+```bash
+sudo dnf install -y gpsd gpsd-clients
+```
+
+**Arch-based:**
+```bash
+sudo pacman -S gpsd
+```
+
+> **Note:** Configure and start the `gpsd` service according to your specific GPS receiver hardware (USB dongle, UART module, Bluetooth, or virtual source) so that it listens on `127.0.0.1:2947`. Once running, enable GPS in PlutoSiege **Settings** (`Enable GPS (gpsd): yes`) or via CLI (`--enable-gps true`).
+
+### 3. Install & Run PlutoSiege
+
+#### Option A: Via pip / pipx (Recommended)
+Install directly from PyPI:
+```bash
+pipx install pluto_siege
+# or: pip install pluto_siege
+```
+
+Launch from any terminal:
+```bash
+pluto_siege
+```
+
+#### Option B: From Source (Clone Repository)
+Clone the repository and install dependencies:
+```bash
+git clone https://github.com/SketchTurnerDev/pluto_siege.git
+cd pluto_siege
+pip install -r requirements.txt
+```
+
+Launch via the main script:
+```bash
+python pluto_siege.py
+# or: python -m pluto_siege
+```
+
+## Demo
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/SketchTurnerDev/pluto_siege/main/assets/demo.gif" alt="PlutoSiege Demo" width="100%">
+</p>
+
+## Application Menu
+
+The main menu provides access to all core operations:
+
+### 1. Capture
+Listens for incoming RF bursts on the configured receiver frequency (`rx_freq`).
+- Captures a single burst by default, or loops continuously (numbering saved bursts `[#1]`, `[#2]`, ... until stopped with `Esc` / `Q` in TUI or `Ctrl+C` in headless mode) when **Auto capture** (`--auto-capture true`) is enabled.
+- Real-time dBFS level meter with saturation (`SAT!`) warnings.
+- Automated noise floor estimation or manual threshold detection.
+- Pre-trigger history ring buffer to preserve signal preambles.
+- Saves captures as standard SigMF (`.sigmf-meta` and `.sigmf-data`) pairs with optional GPS geolocation tags.
+
+### 2. Transmit
+Browse and replay saved SigMF recordings from the configured recordings directory (`records_dir`).
+- Displays recorded timestamp, center frequency, sample rate, sample count, and GPS coordinates.
+- Replays signals via the PlutoSDR transmitter at the exact frequency (`core:frequency`) and sample rate (`core:sample_rate`) stored in `.sigmf-meta`.
+- In-place deletion of unwanted recordings (`D` or `Delete`).
+
+### 3. Loopback Test
+Internal hardware diagnostic to verify the SDR transceiver and USB/DMA pipeline.
+- Enables the AD936x internal digital BIST loopback (`loopback = 1`) at 1 GHz without transmitting over the air.
+- Calculates received Signal-to-Noise Ratio (SNR) to confirm hardware health.
+
+### 4. Settings & CLI Parameters
+Configures radio parameters, trigger behavior, GPS integration, and interface preferences. All settings can be edited interactively in the TUI **Settings** screen or passed via command-line flags.
+
+| Flags / Parameter | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `--pluto-uri, --pu` | `str` | `usb:` | PlutoSDR `libiio` context URI (`usb:`, `usb:1.4.5`, `ip:192.168.2.1`, `local:`). |
+| `--rx-freq, --rf` | `int` | `433.92M` | Receiver center frequency in Hz; supports `k`/`M`/`G` suffixes and bare MHz shorthand (`70M - 6G`; e.g. `433`, `868`). |
+| `--sample-rate, --sr` | `int` | `2.1M` | Sample rate in SPS; supports `k`/`M` suffixes (`521k - 61.44M`). |
+| `--rf-bandwidth, --rb` | `int` | `0` | Analog RF filter bandwidth in Hz, or `0`/`auto` to follow `--sample-rate`; supports `k`/`M` suffixes (`0` or `200k - 56M`). |
+| `--rx-gain, --rg` | `float` | `15.0` | Manual RX hardware gain in dB (`-10.0 .. 74.5`). |
+| `--tx-gain, --tg` | `float` | `0.0` | Manual TX hardware gain in dB (`-89.75 .. 0.0`). |
+| `--tx-repeats, --tr` | `int` | `1` | Number of consecutive burst transmissions per replay (`1 .. 100`). |
+| `--auto-capture, --ac` | `bool` | `false` | Enable continuous multi-burst capture loop (`true` or `false`). |
+| `--auto-threshold, --at` | `bool` | `true` | Enable automatic noise floor threshold detection (`true` or `false`). |
+| `--auto-trigger-margin, --atm` | `float` | `8.0` | Trigger margin above noise floor in dB (`1.0 .. 30.0`; unused when `--auto-threshold` is `false`). |
+| `--auto-recal-seconds, --ars` | `float` | `0.0` | Periodic noise floor recalibration interval in seconds while listening, or `0` to disable; supports `ms`/`s` suffixes (`0.0 .. 600.0`; unused when `--auto-threshold` is `false`). |
+| `--manual-threshold, --mt` | `float` | `-30.0` | Fixed trigger threshold in dBFS (`-120.0 .. 0.0`; unused when `--auto-threshold` is `true`). |
+| `--pre-trigger-buffers, --ptb` | `int` | `2` | Number of pre-trigger history buffers kept in memory (`1 .. 50`). |
+| `--min-burst-seconds, --mbs` | `float` | `0.0` | Minimum active burst duration in seconds to filter short noise spikes, or `0` to disable; supports `ms`/`s` suffixes (`0.0 .. 5.0`). |
+| `--silence-seconds, --ss` | `float` | `0.8` | Continuous silence duration in seconds to stop recording; supports `ms`/`s` suffixes (`0.01 .. 10.0`). |
+| `--max-post-trigger-seconds, --mpts` | `float` | `4.0` | Maximum recording duration in seconds after trigger; supports `ms`/`s` suffixes (`0.1 .. 30.0`). |
+| `--rx-buffer-size, --rbs` | `int` | `32768` | DMA receive buffer size in samples (`1024 .. 1048576`). |
+| `--enable-gps, --eg` | `bool` | `false` | Enable GPS geolocation tagging via `gpsd` daemon (`true` or `false`). |
+| `--gpsd-host, --gh` | `str` | `127.0.0.1` | `gpsd` daemon hostname or IP address (unused when `--enable-gps` is `false`). |
+| `--gpsd-port, --gp` | `int` | `2947` | `gpsd` daemon TCP port (`1 .. 65535`; unused when `--enable-gps` is `false`). |
+| `--records-dir, --rd` | `str` | `./recordings` | Directory path for saving and loading SigMF recordings (`~/.pluto_siege/recordings` when installed via `pip`/`pipx`). |
+| `--enable-sound, --es` | `bool` | `true` | Enable acoustic sound effect cues (`true` or `false`). |
+| `--enable-mouse, --em` | `bool` | `true` | Enable terminal mouse support in the TUI (`true` or `false`). |
+
+### CLI-Only Options
+
+| Flags | Description |
+| :--- | :--- |
+| `--capture, -c` | Start in Capture mode. |
+| `--transmit, --tx` | Start in Transmit mode (pass a recording `#` from `--list`, `.sigmf-data` path, `'latest'`, or omit in TUI). |
+| `--loopback, --lb` | Run the internal digital Loopback Test. |
+| `--list, -l` | List available SigMF recordings in `records-dir` and exit. |
+| `--show-config, --sc` | Show current configuration and exit. |
+| `--headless, --hl` | Run in console text mode without the curses TUI (outputs plain logs without colors or live meter when redirected to a file/pipe; supports `NO_COLOR` / `FORCE_COLOR`). |
+| `--save, -s` | Persist CLI setting changes to `settings.json`. |
+| `--reset, -r` | Reset configuration to defaults and save to `settings.json`. |
+| `--version, -v` | Show program version and exit. |
+| `--help, -h` | Show help message and exit. |
+
+## License
+
+Distributed under the **GNU General Public License v3.0** (GPL-3.0). See [`LICENSE`](https://github.com/SketchTurnerDev/pluto_siege/blob/main/LICENSE) for details.

{pluto_siege-2.0.3 → pluto_siege-2.1.0}/pluto_siege/__main__.py

@@ -17,7 +17,7 @@
 
 """Entry point for ``python3 -m pluto_siege``."""
 
-from pluto_siege.ui.screens.main_menu import main
+from pluto_siege.cli import main
 
 if __name__ == "__main__":
     main()