Welcome to the RF Swift project which aims to provide all needed tools for RF HAMs and professionals.
This toolbox written in Go and shell script allows to quickly deploy Docker containers with desired RF tools, and will all provide more feautures in the near future.
For the moment, the scripts are not yet complete, but your are welcomed to fullfil them if you see there is a needed tool you want to deploy at scale.
This toolbox was inspirated from the nice [Exegol project](https://github.com/ThePorgs/Exegol) in order to integrate all needed tools for radio analysis without uninstalling your favorite OS, and save space depending on your needs via special Docker file recipes.
Still, if you want to have all RF softwares in one OS, you can alternatively use [DragonOS](https://cemaxecuter.com/). But if you want to deploy your tools, messing inside a container without affecting your host, this toolbox is for you ;)
By default, you can the command without arguments if you want to start the `/bin/bash` interpreter and use the default image tag name, and with default environement diplay variable.
## Executing a command inside an existing container
Running a command inside a previous container is fairly easy, if you run a cointainer and exit it.
All you need to do, is to execute the desire command as follows:
sudo ./rfswift exec -e urh
if you want to run it into another existing container, you can precise the container ID as follows:
sudo ./rfswift exec -e /bin/bash -c c9e223a987a36441fb631f4a11def746aabb1a1bc862b5f2589d5b3ac8429cb1 # we are executing on the 'c9e223a987a36441fb631f4a11def746aabb1a1bc862b5f2589d5b3ac8429cb1' container
## Getting the latests containers
To get the 10 last containers you have create, you can use the following command:
sudo ./rfswift last -h
rfswift last [flags]
Flags:
-f, --filter string filter by image name
[...]
sudo ./rfswift last -f myrfswift:latest # we are using a filter for images
You are warmly welcomed to contribute to fill scripts we your desired tools.
In the future, we will create a dedicated page for developpers.
## Troubleshooting
### Sound
The sound is sometimes notes restarting when stoping to play with tools like SDR++.
To solve it for the moment, you can restart the tool and try playing it.
Some tools like GQRX are not yet working with the sound, we will try to fix it when possible, but you can also capture the signal and demodulate it to `wav` and play it with Audacity as a quick fix.
