Version 0.9.0 (INCOMPLETE BETA)
⚠️ IMPORTANT: Radar-Whisper is not ready for general use.
Radar Whisper is a modern and intuitive music player application, designed with a clean, stylized aesthetic and a smooth experience powered by PyQt5. Although it already has a functional foundation, this 0.9.0 version is still in development and includes incomplete features, as well as bugs and runtime errors. Therefore, it is recommended for evaluation and testing purposes only.
- 🎨 Customizable themes: Supports light and dark modes.
- 🎵 Music playback: Audio file support.
- ⏱️ Interactive progress bar: Scrollable for track time seeking.
- 🔊 Volume control: Slider with mute function.
- ⏯️ Standard playback controls: Play, pause, stop, next, previous, shuffle, and repeat (implemented but not functional).
- 📃 Drag-and-drop playlist: Dynamically loads tracks, allows manual sorting.
- 🖼️ Track info panel: Title, artist, duration, cover art (still being refined), and bitrate (also still being refined).
- 🔍 Integrated search: Dynamic track filtering.
Radar-Whisper/
│
├── main.py # Main entry point of the application.
├── main_window.py # Main window setup and display logic.
├── ui_components.py # Definition of custom widgets and visual elements.
├── playlist_manager.py # Logic for playlist management.
├── metadata_handler.py # Reads, processes, and formats track metadata.
├── audio_player.py # Core audio playback controller.
│
├── icon.ico # App icon.
├── icon.png # App icon.
├── Banner.png # Graphic banner
├── Capture.png # Screenshot (dark theme).
├── Capture2.png # Screenshot (light theme).
└── radar_animation.gif # Decorative animation.
│
└── README.md # This document.
| Component | Status | Notes |
|---|---|---|
| Audio playback | 🟢 Functional | Limited to some formats. |
| Playlists | 🟡 Partial | Persistence between sessions is missing. |
| GUI | 🟢 Functional | Basic aesthetics implemented, advanced settings pending. |
| Volume control | 🟢 Functional | No keyboard shortcuts yet. |
| Info panel | 🔴 Incomplete | Displays limited metadata. Full integration pending. |
| Dark/Light mode | 🟡 Partial | Requires manual restart. |
| General stability | 🟠 Unstable | May crash with corrupted files. |
- Python 3.8+
- PyQt5
- Mutagen (for audio metadata handling)
- OS: Windows, Linux (partial), macOS (untested)
git clone https://github.com/Ivan-Ayub97/Radar-Whisper.git
cd radar-whisperpython -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate.bat # Windowspython main.py
- Error-free track repeat
- Full metadata integration (artist, album, genre, year)
- Support for multiple audio formats (OGG, M4A, etc.)
- Playlist persistence in local files
- Mini-player mode
- Floating player
- Full Linux support
This project is open to the community. Whether you're a developer, designer, tester, or simply curious to contribute—you're welcome!
- Report bugs by opening an Issue
- Improve incomplete features
- Refactor code
- Translate the interface
- Suggest UI improvements
- Share ideas in discussions
- Fork the repository
- Create a new branch with your feature
- Make a well-documented Pull Request
You don’t need to be an expert to contribute—every improvement counts.
- Track repeat shows a metadata handling error.
- Playing a new track requires stopping the previous one.
- The program may crash with unsupported audio files.
- Icons may not render correctly on Linux.
- No error handling for corrupted tracks.
- Playlists are not saved between sessions.
- Some UI features are not optimized for low resolutions.
This project is licensed under the MIT License. Feel free to use, modify, and distribute it.
- Lead Developer: Ivan E. C. Ayub
- Contact: negroayub97@gmail.com (optional)
- Technologies used: Python 3, PyQt5, Mutagen
Thanks to the entire developer community that supports Open Source projects. Feel free to collaborate, share, fork, and improve this music player step by step.
Because we believe music deserves an elegant, free, and adaptable environment. Radar Whisper was born as a stylized alternative focused on user experience and open to collaborative evolution.