Repository files navigation

This document explains how to set up and run thewizard scripts in thewizard/ folder of the SIGINTPI project.

Thewizard folder contains Python scripts that help automate:

1. Raspberry Pi readiness (basic updates, remote access, etc.)
2. Component readiness (installing drivers for SDR devices like RTL-SDR, HackRF, etc.)
3. Software readiness (installing GNU Radio, GQRX, GR-GSM, Kalibrate-RTL, etc.)

To get started, clone the SIGINTPI repository from GitHub:

git clone https://github.com/exfil0/SIGINTPI.gitcd SIGINTPI

To run the Python scripts directly (without typingpython3), make them executable. In your project’s root directory (or wherever yourwizard/ folder is located), run:

sudo chmod +x wizard/*.py

This command applies executable permissions to all.py files in thewizard/ directory. If you have subfolders with.py files, you can recursively apply permissions:

sudo find wizard/ -type f -name"*.py" -exec chmod +x {}\;

Note: You can skip this step if you prefer to run each script withpython3 wizard/scriptname.py.

Additionally, ensure that the required permissions are set on all scripts during deployment. Run the following command to ensure all scripts in thewizard/ directory are ready to execute:

sudo chmod -R +x wizard

You can execute each script in thewizard folder in sequence:

• Performs basic Raspberry Pi system updates, upgrades, and enables SSH/VNC.

• Specifically enables and checks remote access services (SSH, VNC).

• Installs drivers/packages for hardware (e.g., RTL-SDR, HackRF).
• Automatically detects devices (like HackRF, NESDR) and tests them.

• Installs & verifies signal-processing software (GNU Radio, GQRX, GR-GSM, Kalibrate-RTL).
• Prompts you to test GUI apps (e.g., GQRX) on the desktop.

If you made the scripts executable:

cd wizardsudo ./raspberrypi_readiness.pysudo ./remote-access-enable.pysudo ./raspberrypi-components-readiness.pysudo ./raspberrypi-software-readiness.py

If you want to use Python directly:

cd wizardsudo python3 raspberrypi_readiness.pysudo python3 remote-access-enable.pysudo python3 raspberrypi-components-readiness.pysudo python3 raspberrypi-software-readiness.py

During the setup, you might be prompted to:

• Reboot or log out/log in to apply certain changes (e.g., group memberships).
• Plug in devices (e.g., HackRF, NESDR). The script may wait until the device is detected (vialsusb).
• Open desktop-based tools (e.g., GNU Radio Companion, GQRX) to confirm they launch properly.

Read the console output carefully and follow each instruction.

If you get aPermission denied error, ensure you have runchmod +x on the script or invoke it withsudo python3 wizard/<script>.py.

Check that your system is online and up to date. The scripts typically runsudo apt update -y && sudo apt upgrade -y to ensure a fresh environment.

If you are using a custom Raspberry Pi OS, some packages or commands may differ. Modify the scripts or install missing packages manually if needed.

When a script adds your user to a group (e.g.,plugdev), you must log out and log back in or reboot for the changes to apply.