A modern, modular Internet Radio application built with Python, CustomTkinter, and python-vlc. This project features a clean UI, live metadata updates, and a modular architecture designed for easy expansion.

• Global Streaming: Play a few radio stations.
• Live Metadata: Real-time updates for track titles and artist info.
• Smart Search: Instant station filtering via the search bar.
• Visual Cues: Country flags and "Now Playing" live indicators.
• User Control: Integrated volume slider and stop functionality.
• Modular Design: Clean separation between GUI components and player logic.

Now Playing Card	Station List	Search Bar	UI Map

internet_radio/
├── app.py                 # Main entry point
├── requirements.txt       # Python dependencies
├── gui/                   # CustomTkinter UI Components
│   ├── main_window.py
│   ├── now_playing.py
│   ├── station_list.py
│   ├── controls.py
│   ├── world_clock.py
│   ├── world_map.py
├── player/                # Media Engine & Data
│   ├── radio_player.py
│   └── stations.py
│   └── stations.json
└── assets/                # Media & Icons
|    └── icons/
|    └── map/
|    └── screenshots/
├── tests/                # Pytest suite
│   ├── test_radio_player.py
│   └── test_search_bar.py
│   └── test_station_list.py
|   └── test_stations.py 

1. Clone the repository and install:

git clone https://github.com/reory/Internet_radio_python.git
cd Internet_radio_python
pip install -r requirements.txt

This project requires both the backend and frontend to be running simultaneously.

1. Run the app:

    python app.py

The project includes a comprehensive suite of 4 tests covering radio searches, radio player, and the radio UI logic.

To run the tests:

pytest

I am currently working on scaling this project. Planned features include:

• DuckDB Backend: Migrating stations.json to a high-performance database.

• Geospatial Discovery: Interactive map for station selection.

• Graphic Equalizer: Advanced audio frequency control.

Contributions, ideas, and feedback are welcome! This is my first public project, so constructive feedback is especially appreciated as the app continues to grow.

• Fork the repository.

• Create a new branch (git checkout -b feature/YourFeature).

• Commit your changes.

• Submit a Pull Request.

• Version 1.0 Initial release.
• Version 1.1 Added Interactive Map for station discovery.
• 4 passing unit tests.

Built by Roy Peters — Click here for contact info😁