gitwtfhub

wtf is onda?

pedrosousa13/onda — explained in plain English

Analysis updated 2026-05-18

7GoAudience · generalComplexity · 2/5Setup · easy

TL;DR

A privacy-minded terminal app for browsing and listening to internet radio stations worldwide, streaming directly from each broadcaster with no tracking by default.

Mindmap

mindmap
  root((onda))
    What it does
      Terminal radio player
      Direct stream connect
      No tracking
      Local search option
    Tech stack
      Go
      mpv
    Use cases
      Browse world stations
      Private search
      Custom stations
    Audience
      General users
      Terminal fans

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Browse and listen to internet radio stations from anywhere in the world from your terminal.

REASON 2

Search a local offline copy of the station directory so queries never leave your machine.

REASON 3

Add and save your own custom radio stations alongside the built in directory.

What's in the stack?

Gompv

How it stacks up

pedrosousa13/ondademomanito/helperemersion/minilustre
Stars777
LanguageGoGoGo
Last pushed2023-03-072019-01-07
MaintenanceDormantDormant
Setup difficultyeasyeasymoderate
Complexity2/51/54/5
Audiencegeneralgeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Needs mpv installed separately on your PATH for audio playback.

Wtf does this do

Onda is a terminal based internet radio app for Linux, macOS, and Windows, built around the idea of listening to real radio stations from around the world without any tracking. It connects you directly to the station's own streaming server, the same way a browser would if you clicked a link, and it never records, proxies, or rebroadcasts what you listen to. By default onda does not report anything about what you listen to. Popularity tracking is off unless you turn it on, and things like your favorites, custom stations, settings, and optional play history are saved only on your own computer, never sent anywhere. Station information itself comes from the public domain Radio Browser project along with a small starter list bundled with the app. Searching works two ways: by default it queries Radio Browser over the network as you type, or if you opt in, it downloads the full station directory once, about 30 megabytes, and searches that local copy from then on, which also makes typos more forgiving and works without an internet connection for the search itself, though playing a station still needs one. To use it you need a program called mpv installed alongside onda, since mpv actually plays the audio stream. You can install onda through Homebrew on macOS and Linux, through Scoop on Windows, with the Go toolchain, or by downloading a prebuilt binary from the project's releases page. Once running, everything is controlled with the keyboard, or optionally the mouse. You can browse stations by country, genre, or language, search by station name, country, or genre in a single search box, mark favorites, see recently played stations if that feature is turned on, and add your own custom stations by entering a name, a stream URL, and an optional bitrate. Settings let you adjust audio quality, whether popularity is tracked, whether play history is kept, the color theme, and whether loudness is normalized between stations. The app checks GitHub once a day for a new release and can update itself in place after verifying the download's checksum.

Yoink these prompts

Prompt 1
Help me install onda and mpv on macOS using Homebrew.
Prompt 2
Show me the keyboard shortcuts for browsing, favoriting, and searching stations in onda.
Prompt 3
Explain how onda's opt-in local search directory keeps my queries private.

Frequently asked questions

wtf is onda?

A privacy-minded terminal app for browsing and listening to internet radio stations worldwide, streaming directly from each broadcaster with no tracking by default.

What language is onda written in?

Mainly Go. The stack also includes Go, mpv.

How hard is onda to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is onda for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.