Releases: danx123/macan-audio-player
macan_audio_player_v8.5.1
🎵 Macan Audio Player
Macan Audio Player is a modern PySide6-based audio player with support for various popular formats, powered by FFmpeg.
It features smooth lyrics sync (.lrc) with auto-follow, as well as manual lock for uninterrupted scrolling.
✨ Key Features
- Supports various popular audio formats (MP3, WAV, OGG, FLAC, AAC, etc.).
- Auto-Sync Lyrics (.lrc)
- Auto-follow lyrics to the song.
- Manual scroll lock → auto-follow stops when the user swipes.
- Toggle "Auto Follow Lyrics" via the menu.
- Dark & Light themes with modern accents.
- Basic controls: Play, Pause, Seek (via slider).
- Simple, lightweight, and clean UI.
- Dynamic Aura
- Tag editor
- Online Radio
- Audio Normalization
- Advanced Tag Editor
📸 Screenshot
📝 Changelog v8.5.1
- Fix check mark on transparent mode
📦 Installation
- Make sure Python 3.10+ is installed.
- Install dependencies:
pip install PyQt6
3. Make sure FFmpeg is installed and accessible via PATH.
---
📂 Note
The source code shared is the base project.
The full binary version (with the latest and stable features) is available in the Releases section.
---
📖 License
This project is licensed under the MIT license — free to use, modify, and distribute with proper credit.macan_audio_player_v8.5.0
🎵 Macan Audio Player
Macan Audio Player is a modern PySide6-based audio player with support for various popular formats, powered by FFmpeg.
It features smooth lyrics sync (.lrc) with auto-follow, as well as manual lock for uninterrupted scrolling.
✨ Key Features
- Supports various popular audio formats (MP3, WAV, OGG, FLAC, AAC, etc.).
- Auto-Sync Lyrics (.lrc)
- Auto-follow lyrics to the song.
- Manual scroll lock → auto-follow stops when the user swipes.
- Toggle "Auto Follow Lyrics" via the menu.
- Dark & Light themes with modern accents.
- Basic controls: Play, Pause, Seek (via slider).
- Simple, lightweight, and clean UI.
- Dynamic Aura
- Tag editor
- Online Radio
- Audio Normalization
- Advanced Tag Editor
📸 Screenshot
📝 Changelog v8.5.0
- Added Transparent Mode
📦 Installation
- Make sure Python 3.10+ is installed.
- Install dependencies:
pip install PyQt6
3. Make sure FFmpeg is installed and accessible via PATH.
---
📂 Note
The source code shared is the base project.
The full binary version (with the latest and stable features) is available in the Releases section.
---
📖 License
This project is licensed under the MIT license — free to use, modify, and distribute with proper credit.macan_audio_player_v8.4.0
🎵 Macan Audio Player
Macan Audio Player is a modern PySide6-based audio player with support for various popular formats, powered by FFmpeg.
It features smooth lyrics sync (.lrc) with auto-follow, as well as manual lock for uninterrupted scrolling.
✨ Key Features
- Supports various popular audio formats (MP3, WAV, OGG, FLAC, AAC, etc.).
- Auto-Sync Lyrics (.lrc)
- Auto-follow lyrics to the song.
- Manual scroll lock → auto-follow stops when the user swipes.
- Toggle "Auto Follow Lyrics" via the menu.
- Dark & Light themes with modern accents.
- Basic controls: Play, Pause, Seek (via slider).
- Simple, lightweight, and clean UI.
- Dynamic Aura
- Tag editor
- Online Radio
- Audio Normalization
- Advanced Tag Editor
📸 Screenshot
📝 Changelog v8.4.0
- Fixed Equlizer save preset
- Fixed center screen
- Update Engine (ffmpeg)
📦 Installation
- Make sure Python 3.10+ is installed.
- Install dependencies:
pip install PyQt6
3. Make sure FFmpeg is installed and accessible via PATH.
---
📂 Note
The source code shared is the base project.
The full binary version (with the latest and stable features) is available in the Releases section.
---
📖 License
This project is licensed under the MIT license — free to use, modify, and distribute with proper credit.macan_audio_player_v8.2.1
🎵 Macan Audio Player
Macan Audio Player is a modern PySide6-based audio player with support for various popular formats, powered by FFmpeg.
It features smooth lyrics sync (.lrc) with auto-follow, as well as manual lock for uninterrupted scrolling.
✨ Key Features
- Supports various popular audio formats (MP3, WAV, OGG, FLAC, AAC, etc.).
- Auto-Sync Lyrics (.lrc)
- Auto-follow lyrics to the song.
- Manual scroll lock → auto-follow stops when the user swipes.
- Toggle "Auto Follow Lyrics" via the menu.
- Dark & Light themes with modern accents.
- Basic controls: Play, Pause, Seek (via slider).
- Simple, lightweight, and clean UI.
- Dynamic Aura
- Tag editor
- Online Radio
- Audio Normalization
- Advanced Tag Editor
📸 Screenshot
📝 Changelog v8.2.1
- Added dynamic tooltip (volume)
📦 Installation
- Make sure Python 3.10+ is installed.
- Install dependencies:
pip install PyQt6
3. Make sure FFmpeg is installed and accessible via PATH.
---
📂 Note
The source code shared is the base project.
The full binary version (with the latest and stable features) is available in the Releases section.
---
📖 License
This project is licensed under the MIT license — free to use, modify, and distribute with proper credit.macan_audio_player_v8.2.0
🎵 Macan Audio Player
Macan Audio Player is a modern PySide6-based audio player with support for various popular formats, powered by FFmpeg.
It features smooth lyrics sync (.lrc) with auto-follow, as well as manual lock for uninterrupted scrolling.
✨ Key Features
- Supports various popular audio formats (MP3, WAV, OGG, FLAC, AAC, etc.).
- Auto-Sync Lyrics (.lrc)
- Auto-follow lyrics to the song.
- Manual scroll lock → auto-follow stops when the user swipes.
- Toggle "Auto Follow Lyrics" via the menu.
- Dark & Light themes with modern accents.
- Basic controls: Play, Pause, Seek (via slider).
- Simple, lightweight, and clean UI.
- Dynamic Aura
- Tag editor
- Online Radio
- Audio Normalization
- Advanced Tag Editor
📸 Screenshot
📝 Changelog v8.2.0
- Update Framework
📦 Installation
- Make sure Python 3.10+ is installed.
- Install dependencies:
pip install PyQt6
3. Make sure FFmpeg is installed and accessible via PATH.
---
📂 Note
The source code shared is the base project.
The full binary version (with the latest and stable features) is available in the Releases section.
---
📖 License
This project is licensed under the MIT license — free to use, modify, and distribute with proper credit.macan_audio_player_v8.0.0
🎵 Macan Audio Player
Macan Audio Player is a modern PySide6-based audio player with support for various popular formats, powered by FFmpeg.
It features smooth lyrics sync (.lrc) with auto-follow, as well as manual lock for uninterrupted scrolling.
✨ Key Features
- Supports various popular audio formats (MP3, WAV, OGG, FLAC, AAC, etc.).
- Auto-Sync Lyrics (.lrc)
- Auto-follow lyrics to the song.
- Manual scroll lock → auto-follow stops when the user swipes.
- Toggle "Auto Follow Lyrics" via the menu.
- Dark & Light themes with modern accents.
- Basic controls: Play, Pause, Seek (via slider).
- Simple, lightweight, and clean UI.
- Dynamic Aura
- Tag editor
- Online Radio
- Audio Normalization
- Advanced Tag Editor
📸 Screenshot
📝 Changelog v8.0.0
- Added Running Text (Marquee) status bar
- Added QSettings for Radio
- Added Radio Sync with Dynamic Aura
📦 Installation
- Make sure Python 3.10+ is installed.
- Install dependencies:
pip install PyQt6
3. Make sure FFmpeg is installed and accessible via PATH.
---
📂 Note
The source code shared is the base project.
The full binary version (with the latest and stable features) is available in the Releases section.
---
📖 License
This project is licensed under the MIT license — free to use, modify, and distribute with proper credit.macan_audio_player_v7.8.2
🎵 Macan Audio Player
Macan Audio Player is a modern PySide6-based audio player with support for various popular formats, powered by FFmpeg.
It features smooth lyrics sync (.lrc) with auto-follow, as well as manual lock for uninterrupted scrolling.
✨ Key Features
- Supports various popular audio formats (MP3, WAV, OGG, FLAC, AAC, etc.).
- Auto-Sync Lyrics (.lrc)
- Auto-follow lyrics to the song.
- Manual scroll lock → auto-follow stops when the user swipes.
- Toggle "Auto Follow Lyrics" via the menu.
- Dark & Light themes with modern accents.
- Basic controls: Play, Pause, Seek (via slider).
- Simple, lightweight, and clean UI.
- Dynamic Aura
- Tag editor
- Online Radio
- Audio Normalization
- Advanced Tag Editor
📸 Screenshot
📝 Changelog v7.8.2
Fixes & Enhancements
- Playlist Insertion Logic: Fixed an issue where new tracks added via the "Add File(s)" button or drag-and-drop were always appended to the end of the list. New files are now inserted directly below the currently playing track for improved queue management.
- Playlist Multi-Selection: Enabled extended selection (Shift + Ctrl) in the playlist widget, allowing users to select and manage multiple tracks simultaneously.
- Fixed Multiple Remove Track
📦 Installation
- Make sure Python 3.10+ is installed.
- Install dependencies:
pip install PyQt6
3. Make sure FFmpeg is installed and accessible via PATH.
---
📂 Note
The source code shared is the base project.
The full binary version (with the latest and stable features) is available in the Releases section.
---
📖 License
This project is licensed under the MIT license — free to use, modify, and distribute with proper credit.macan_audio_player_v7.8.0
🎵 Macan Audio Player
Macan Audio Player is a modern PySide6-based audio player with support for various popular formats, powered by FFmpeg.
It features smooth lyrics sync (.lrc) with auto-follow, as well as manual lock for uninterrupted scrolling.
✨ Key Features
- Supports various popular audio formats (MP3, WAV, OGG, FLAC, AAC, etc.).
- Auto-Sync Lyrics (.lrc)
- Auto-follow lyrics to the song.
- Manual scroll lock → auto-follow stops when the user swipes.
- Toggle "Auto Follow Lyrics" via the menu.
- Dark & Light themes with modern accents.
- Basic controls: Play, Pause, Seek (via slider).
- Simple, lightweight, and clean UI.
- Dynamic Aura
- Tag editor
- Online Radio
- Audio Normalization
- Advanced Tag Editor
📸 Screenshot
📝 Changelog v7.8.0
Fixes & Enhancements
Playlist Insertion Logic: Fixed an issue where new tracks added via the "Add File(s)" button or drag-and-drop were always appended to the end of the list. New files are now inserted directly below the currently playing track for improved queue management.
Playlist Multi-Selection: Enabled extended selection (Shift + Ctrl) in the playlist widget, allowing users to select and manage multiple tracks simultaneously.
📦 Installation
- Make sure Python 3.10+ is installed.
- Install dependencies:
pip install PyQt6
3. Make sure FFmpeg is installed and accessible via PATH.
---
📂 Note
The source code shared is the base project.
The full binary version (with the latest and stable features) is available in the Releases section.
---
📖 License
This project is licensed under the MIT license — free to use, modify, and distribute with proper credit.macan_audio_player_v7.5.0
🎵 Macan Audio Player
Macan Audio Player is a modern PySide6-based audio player with support for various popular formats, powered by FFmpeg.
It features smooth lyrics sync (.lrc) with auto-follow, as well as manual lock for uninterrupted scrolling.
✨ Key Features
- Supports various popular audio formats (MP3, WAV, OGG, FLAC, AAC, etc.).
- Auto-Sync Lyrics (.lrc)
- Auto-follow lyrics to the song.
- Manual scroll lock → auto-follow stops when the user swipes.
- Toggle "Auto Follow Lyrics" via the menu.
- Dark & Light themes with modern accents.
- Basic controls: Play, Pause, Seek (via slider).
- Simple, lightweight, and clean UI.
- Dynamic Aura
- Tag editor
- Online Radio
- Audio Normalization
- Advanced Tag Editor
📸 Screenshot
📝 Changelog v7.5.0
🚀 New Features
Add File(s) Functionality
A new "Add File(s)" button and corresponding icon (add-file) have been added to the main control panel.
This allows users to select and add one or more individual audio files (e.g., .mp3, .flac) via a file dialog, supplementing the existing "Add Folder" capability.
Windows File Association
A "Register format" option has been added to the main options menu.
This feature allows users on Windows to associate supported audio formats (.mp3, .m4a, .ogg, .flac, .wav) with the Macan Audio Player.
The system now includes helper functions (is_admin, run_as_admin, perform_windows_registration) to check for administrator privileges, request UAC elevation, and safely modify the Windows Registry.
Code & Refactoring
Custom PlaylistWidget Class
The standard QListWidget for the playlist has been refactored into a new custom class, PlaylistWidget.
This change encapsulates the playlist's setup logic (e.g., drag/drop modes) and prepares the codebase for more advanced, playlist-specific features in the future.
Preparatory Code
Added a (currently unused) handle_playlist_drop method, indicating future work on enhancing drag-and-drop functionality directly onto the playlist widget.
📦 Installation
- Make sure Python 3.10+ is installed.
- Install dependencies:
pip install PyQt6
3. Make sure FFmpeg is installed and accessible via PATH.
---
📂 Note
The source code shared is the base project.
The full binary version (with the latest and stable features) is available in the Releases section.
---
📖 License
This project is licensed under the MIT license — free to use, modify, and distribute with proper credit.macan_audio_player_v7.2.0
🎵 Macan Audio Player
Macan Audio Player is a modern PySide6-based audio player with support for various popular formats, powered by FFmpeg.
It features smooth lyrics sync (.lrc) with auto-follow, as well as manual lock for uninterrupted scrolling.
✨ Key Features
- Supports various popular audio formats (MP3, WAV, OGG, FLAC, AAC, etc.).
- Auto-Sync Lyrics (.lrc)
- Auto-follow lyrics to the song.
- Manual scroll lock → auto-follow stops when the user swipes.
- Toggle "Auto Follow Lyrics" via the menu.
- Dark & Light themes with modern accents.
- Basic controls: Play, Pause, Seek (via slider).
- Simple, lightweight, and clean UI.
- Dynamic Aura
- Tag editor
- Online Radio
- Audio Normalization
- Advanced Tag Editor
📸 Screenshot
📝 Changelog v7.2.0
- Fixed volume-muted svg
- Added format register function (association files).mp3, .m4a, .ogg, .flac
✨ New Features
- Playlist Context Menu: Remove Selected Track
- Users can now right-click a track in the playlist and select "Remove Selected" to delete it from the current session.
- This action intelligently handles various playback scenarios:
- If the currently playing track is removed, the player will stop and advance to the next track.
- If the playlist becomes empty, the player UI is reset to its default state.
- If a track before the currently playing track is removed, the playback index is automatically adjusted.
🎨 Enhancements
- Upgraded Notification System:
- Album Art Display: Notifications (bubbles) now display the track's album art alongside the title and artist, providing richer visual feedback.
- Layout Consistency: Corrected a layout calculation issue where notifications could have inconsistent sizing or screen placement, especially with long track titles. Notifications are now constrained to a maximum width and positioned reliably on the screen.
🔧 Refactors
- Introduced the
remove_selected_trackmethod to modularize the logic for track removal from the playlist. - Refactored
NotificationWidgetto accept and processartwork_data, and switched its internal layout toQHBoxLayoutto support the album art.
📦 Installation
- Make sure Python 3.10+ is installed.
- Install dependencies:
pip install PyQt6
3. Make sure FFmpeg is installed and accessible via PATH.
---
📂 Note
The source code shared is the base project.
The full binary version (with the latest and stable features) is available in the Releases section.
---
📖 License
This project is licensed under the MIT license — free to use, modify, and distribute with proper credit.