Personal Frequency

A local radio-style tuner for station presets, public live streams, podcast RSS feeds, and your own audio files.

Run

python3 server.py

Open http://127.0.0.1:8765.

Direct stream stations can play from the static page. Podcast RSS stations and the local_audio/ folder work best through server.py because it provides /api/rss and /api/library.

Add Local Stations

Drop owned audio files into:

local_audio/

Then restart or refresh the app and tune to a local station.

You can also use the file loader in the app. Browser-loaded files stay in memory for the session.

Edit Presets

Station presets live in stations.json.

Supported station kinds:

• stream: a direct audio stream URL that the browser can play.
• rss: a podcast feed with episode enclosures.
• local: files selected in the browser or discovered in local_audio/.
• manual: direct audio links listed in a station's tracks array.

The GTA/K-Billy-style presets are intentionally local/manual shells. Put your own legally sourced files behind them instead of hardcoding unauthorized uploads.