A terminal-based radio and music player for Linux and Termux. It’s your all-in-one groove machine, complete with an epic ASCII art radio and a slick menu interface. Tune into online radio streams or jam out to your local music library! ASCII art radio + menu interface. Streams online radio from fmstream.org or plays your local music.
\
\
\
\
\
\
\
_______________________________________\
/ RocknRoll \
/___________________________________________\
| author: linux-edu |
| ____________ ______ |
| |------------| / \ |
| |------------| | | |
| |------------| \______/ |
| ____________ |
| |
| VOL | TUNER | FM | AM |
|_____________________________________________|
\___________________________________________/
Ready to get the show on the road? Here’s how to install and start rocking.
# Get mpv and Python ready to party!
sudo apt install mpv python3 -y
# Clone the repo and jump in
git clone [https://github.com/linux-edu/RocknRoll-Radio.git](https://github.com/linux-edu/RocknRoll-Radio.git)
cd RocknRoll-Radio
# Install the Python dependencies
pip install -r requirements.txt
# Let's get this show started!
python3 radio.pyTermux 🔥
# Amp up your Termux with mpv and Python!
pkg install mpv python -y
# Clone the repo and jump in
git clone [https://github.com/linux-edu/RocknRoll-Radio.git](https://github.com/linux-edu/RocknRoll-Radio.git)
cd RocknRoll-Radio
# Install the Python dependencies
pip install -r requirements.txt
# Time to rock!
python radio.py🎶 Jam Out to Your Local Tunes
This app is more than just a radio—it's your personal jukebox! RocknRoll-Radio automatically scours your system for your music files in all the right places:
~/Music/: The go-to spot on most Linux systems.
~/storage/music/: The standard groove location for Termux.
music/: A convenient folder included right in this repo for you to drop your tracks and get started instantly!
💡 Pro-Tip: Just drop your .mp3 or .wav files into the music/ folder and you're good to go!
RocknRoll-Radio/ ├── radio.py ├── requirements.txt └── music/ └── your_songs_here.mp3
Let's get this done! Here is the complete Markdown code you can copy and paste directly into your README.md file. It includes a brand new section with the stylish badges and clear instructions for your users.
➕ Request a New Station
Got a favorite radio station you want to add to the list? We'd love to hear from you! To request a new station, please follow these two simple steps:
First, show some love by liking and following our Facebook page:
Then, join our WhatsApp channel to send us your request:
Once you've done that, you're all set! Just let us know which station you'd like to see added.
Was this helpful? Let me know what other topics you'd like explained! 👍
👉 Share this with someone new to Linux/Termux! 🚀
✅ Like if this helped you!
🔔 Follow for daily Linux tips.
📄 License
This project is licensed under the MIT License. Copyright (c) 2025 linux-edu
🙌 Join the Band!
Pull requests are the ultimate encore! Fork this repo, customize it with your favorite radio presets, or help us refine the TUI to make the show even better.
💖 Support the Sound!
If our work hits the right notes for you, consider becoming a sponsor. 🎵
Your sponsorship keeps our tunes playing by helping us:
Maintain and improve open-source instruments like RocknRoll-Radio
Write more cool scripts for the Termux and Linux communities
Keep our dedication to education and community projects strong
Even a small contribution makes a huge difference. Thank you for helping us keep open-source accessible to everyone! 🙏
