Ranger Radio Transmission Indexer

This software package contains functionality for processing audio from Burning Man's radio system.

Installation

To install this package, you will need to install Python 3.11. You should also install the pipx tool, which provides an easy way to install python executables.

Additionally, this package uses the pydub and the openai-whisper Python packages, each of which has specific setup requirements. See the instructions for each package for details. In particular, both require ffmpeg.

On macOS using Homebrew, you can install what you need thusly:

brew install [email protected]
brew install pipx
brew install ffmpeg

Once you have the above installed, you can install this package using pipx:

pipx install git+https://github.com/burningmantech/ranger-transmissions.git

You should now have a command called rtx in your system.

To update to the latest version:

pipx reinstall ranger-transmissions

Usage

rtx provides a command line application that lets you browse though indexed audio content. If you have an existing data file containing an index, put that at ~/rtx.sqlite. Then start the interactive application:

rtx application

If you simply want a report of the indexed content, you can get that directly:

# All transmissions
rtx transmissions

# Search
rtx transmissions --search="ranger"

To generate your an index of audio files (warning: this takes a very long time), first create a file ~/.rtx.toml which describes where to find the audio content:

[Audio.Event.2023]

Name = "Burning Man 2023"

SourceDirectory = "~/Google Drive/Shared drives/2023 Radio System Archive"

Then run the indexer:

rtx index