Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/kernferm/radio-player-pro

A modern, user-friendly radio streaming application that lets you listen to thousands of radio stations from around the world. Built with Python and CustomTkinter for a sleek, professional interface.
https://github.com/kernferm/radio-player-pro

20kplus bubblesthedev international player pygame radio vlc windows

Last synced: 4 months ago
JSON representation

A modern, user-friendly radio streaming application that lets you listen to thousands of radio stations from around the world. Built with Python and CustomTkinter for a sleek, professional interface.

Awesome Lists containing this project

README 

          
# 🎵 Radio Player Pro



![Radio Player Pro](https://img.shields.io/badge/Radio%20Player%20Pro-v1.2.9-blue?style=for-the-badge&logo=music)

![Platform](https://img.shields.io/badge/Platform-Windows-lightgrey?style=for-the-badge&logo=windows)

![License](https://img.shields.io/badge/License-STRICT-green?style=for-the-badge)



A modern, user-friendly radio streaming application that lets you listen to thousands of radio stations from around the world. Built with Python and CustomTkinter for a sleek, professional interface.



---



## Document Support

- [Trouble Shooting Docs](https://github.com/KernFerm/Radio-Player-Pro/blob/main/TroubleShooting.MD)

- [Support Docs](https://github.com/KernFerm/Radio-Player-Pro/blob/main/Support.MD)

- [System Requirements Docs](https://github.com/KernFerm/Radio-Player-Pro/blob/main/SystemRequirements.MD)

- [Installation & Setup Docs](https://github.com/KernFerm/Radio-Player-Pro/blob/main/Installation_N_Setup.MD)



## 👥 Community



### Join Our Discord

- **Discord Server**: [![](https://invidget.switchblade.xyz/zQbJJgwbUv)](https://discord.gg/zQbJJgwbUv)

- **Features**: 

  - Get help and support

  - Share favorite stations

  - Request new features

  - Connect with other users



## 🚀 Quick Start



### For Windows Users (Recommended)

- [CLICK HERE TO DOWNLOAD **RADIO PLAYER PRO** MAKE SURE TO SAVE ON YOUR DESKTOP](https://www.fnbubbles420.org/Download/index)



1. **Download** the complete Radio Player Pro package

2. **Extract main zipfolder you will see `radio.exe`.

3. **Navigate** to the `Radio-Player-Pro` folder

4. **Double-click** `radio.exe` to launch the application



⚠️ **CRITICAL**: Keep all files and folders together - do not move the exe file alone!



---



## ⚠️ Important File Structure



**DO NOT SEPARATE THESE FILES!** The application requires all components to work properly:



### 🔴 NEVER DO THIS:

- ❌ Move `radio.exe` to your desktop without the `_internal` folder

- ❌ Delete or move files from the `_internal` folder

- ❌ Separate the executable from its dependencies

- ❌ Rename the main folder while the app is running



### ✅ ALWAYS DO THIS:

- ✅ Keep the entire `Radio-Player-Pro` folder intact

- ✅ Run `radio.exe` from its original location

- ✅ Create shortcuts pointing to the exe in its folder

- ✅ Back up the entire folder structure



---



## 🎮 How to Use



### First Launch



1. **Accept** the User Agreement (covers privacy and usage terms)

2. **API MESSAGE** if `API` are online it will display and online message. if `API` are offline it will display an offline message

3. **Wait** for the splash screen (2 seconds)

4. The main application window will appear



### Main Interface



#### 🎵 Now Playing Section

- Shows currently selected station

- **▶ Play/Pause** button to control playback

- **⏹ Stop** button to stop streaming

- **Volume slider** to adjust audio level

- **Status display** showing connection info



#### 🔍 Search & Discovery

- **Search box**: Enter station name, genre, or country

- **Search button**: Find stations matching your query

- **Local button**: Automatically find stations in your area

- **Genre dropdown**: Browse by music genre

- **Country dropdown**: Browse by country



#### ⭐ Favorites Management

- **Favorites dropdown**: Quick access to saved stations

- **▶ Play**: Play selected favorite station

- **⭐ Add Current**: Save currently playing station



#### 📻 Station List

- Browse through available radio stations

- Each station shows:

  - Station name

  - Country and genre tags

  - Vote count (popularity)

  - **▶ Play** button



### Menu Bar Features



- **File**: Exit the application

- **View**: Switch between Dark/Light themes

- **Audio**: Configure audio settings and backends

- **Community**: Join our Discord server

- **Help**: Audio help and about information

- **License**: View software license



---



## 🎯 Features



### 🎵 Audio Playback

- **Multiple audio backends**: VLC (recommended), PyAudio, PyDub, Pygame

- **High-quality streaming** with adaptive buffering

- **Volume control** with real-time adjustment

- **Play/Pause/Stop** controls



### 🌍 Station Discovery

- **20,000+ radio stations** from around the world

- **Smart search** by name, genre, country, or tags

- **Local station detection** based on your location

- **Popular stations** curated by community votes

- **Genre filtering** with comprehensive categories



### ⭐ Personalization

- **Favorites system** to save your preferred stations

- **Quick access** to favorite stations

- **Persistent storage** of preferences

- **Theme customization** (Dark/Light modes)



### 🔧 Technical Features

- **Multiple audio backend support**

- **Robust error handling** and recovery

- **Caching system** for faster loading

- **Security-first design** with input sanitization

- **Cross-platform compatibility**



---



## 🎨 Customization



### Themes

- **Dark Mode**: Default, easy on the eyes

- **Light Mode**: Clean, bright interface

- Switch via **View** menu



### Audio Settings

- **Buffer size**: Adjustable for your connection

- **Audio quality**: Multiple backend options

- **Volume**: Persistent across sessions



### Favorites

- **Unlimited favorites**: Save as many stations as you want

- **Quick access**: Dropdown menu for instant playback

- **Backup**: Export/import favorites (advanced)



---



### Contributing

- Report bugs and issues

- Suggest new features

- Share station recommendations

- Help other users



---



## ***NOTE***

- if `API` is down radio will `fallback` to `temp` stations. 

- when `API` is back online everything will return back to normal `FULLY FUNCTIONAL`



---



## 📝 License



- **PRIVATE LICENSE**

```

### Terms Summary

- ✅ Free to use for personal purposes

- ✅ No data collection or tracking

- ✅ Local processing only

- ⚠️ Use at your own risk

- ⚠️ Comply with local laws and regulations

```

---



## 🎵 Enjoy Your Music!



Radio Player Pro brings the world's radio stations to your fingertips. Whether you're discovering new music, staying updated with news, or enjoying your favorite shows, we've got you covered.



**Happy Listening!** 🎧



---



*Developed by `BubblesTheDev` | Version 1.2.9 | 2025*



---



> **Remember**: Always keep the `radio.exe` file together with the `_internal` folder and all other components. The application is designed to work as a complete package!