streamtuner2(1)

💖 streamtuner2 💖

okay bestie, so streamtuner2 is literally the manual for streamtuner2, which is a browser for internet radio stations ✨ (that's the official one-liner, we keep it, it's iconic). This is from the application manuals set. Come sit with me, we're doing this together 🫶

---

🌸 SYNOPSIS 🌸

streamtuner2 command [ channel,...  ] [ title ]

that's it. that's the shape of it. command, maybe some channels, maybe a title. slay.

---

✨ DESCRIPTION ✨

Streamtuner2 is a graphical application for browsing through internet radio station directories, like:

• Xiph.org
• Internet-Radio
• MyOggRadio
• SomaFM
• Streema

It utilizes your configured audio player or recording applications — and you set those up in the <F12> settings window, no cap. 🎧

It's written in Python and it's easy to extend. And besides the graphical interface, it also has a commandline interface, because of course it does, it's a whole queen. 👑

It comes with a couple of feature plugins and additional channels. she's got range fr fr.

---

💅 OPTIONS 💅

Without any options, it starts in the graphical mode, of course. obviously. main character energy. 🎀

• help — prints out a summary of available commands. the lil "what can u even do" button.

🗂️ Cached data

these ones pull from what's already cached, iykyk.

• stream channel title — searches for a station with the given title. Either looks in a single channel, or scans all plugins. she's thorough. 🔍
• url channel title — prints out only the streaming URL. that's it. just the link. no extra. 💅
• play [channel] title — invokes the configured audio player. the channel is optional here btw, hence the brackets. press play bestie ▶️

🌐 Instantly retrieve data from directory service

these ones go get the data fresh, right now, no waiting. it's giving live.

• categories channelname — returns a nested JSON list of all categories/genres. 🌈
• category "channelname" "Category" — prints out a JSON list of the genre. Each entry contains title, url and other meta information. ⚠️ note that the category must have the exact case. like, exact exact. Jazz ≠ jazz. don't do that to yourself. 😭

---

🔥 EXAMPLES 🔥

okay here's where it clicks. watch:

streamtuner2 stream shoutcast,xiph "Top 100"

Searches for the term "Top 100" in the shoutcast and xiph channels, and returns all info about the first match as JSON output. two channels, one query, ate. ✨

streamtuner2 play frequence3

Looks for the first occourence, and starts the audio player for FREQUENCE3. 🎶

streamtuner2 category tunein Jazz

Dumps a JSON list of all stations the named genre. all of them. the whole genre. 🎀

---

🦋 GRAPHICAL MODE 🦋

There's only one option for the graphical UI mode:

• --gtk3 — Loads Gtk3 via PyGI instead of Gtk2. This is implicit when running on Python3 anyway. so like, free upgrade energy. ⭐
• --nt — No-threading mode avoids some UI separation, but stabilizes the interface (in particular channel loading crashes occassionally) for some Gtk2/Gtk3 and Python combinations. lowkey a fix-it-flag for certain setups. 🔧
• -d plugin — Disable plugin from loading. Plugin names are all-lowercase and sometimes short versions of the channel or feature, such as "reddit", "xiph", "favicons" or "dnd". bye felicia 👋
• -e plugin — Load a plugin that isn't set by default. surprise guest appearance. 🌟

---

🌈 OTHER OPTIONS 🌈

• -D — Enable debug mode, which shows a lot of activity messages during Streamtuner2 running — including UI changes and network requests or extraction steps. it's giving narrating its own life 💀
• -V — Show streamtuner version. short and sweet.
• version -v — Summarize all plugin versions. the receipts. 🧾

---

🍓 FILES 🍓

/home/$USER/.config/streamtuner2/settings.json

that's where she keeps her stuff. don't touch it unless you know what you're doing bestie 🙈

---

👑 SEE ALSO 👑

streamripper(1) audacious(1) json(5) m3u(5) pls(5)

the whole friend group. go say hi. 🫶

---

k that's the whole page, you're basically a streamtuner2 expert now, no cap. this was version 2.1.4 💖, dated 2015-04-02, from the application manuals collection. periodt. ✨💅🌸