# zhongyang219/musicplayer2

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/zhongyang219-musicplayer2).**

6,211 stars · 488 forks · C++ · gpl-3.0

## Links

- GitHub: https://github.com/zhongyang219/MusicPlayer2
- awesome-repositories: https://awesome-repositories.com/repository/zhongyang219-musicplayer2.md

## Description

MusicPlayer2 is a desktop music player for Windows built on the BASS audio engine, designed for high-quality local audio playback with real-time spectrum visualization. It functions as a local music library manager, organizing tracks by artist, album, and genre, while also serving as an online metadata and artwork downloader that fetches lyrics and album covers automatically. The player features a fully customizable interface defined through XML configuration files, and includes a synchronized lyrics display with desktop overlay and karaoke-style highlighting.

The player distinguishes itself with advanced audio control capabilities, including A-B loop playback for repeating user-defined segments of a track, playback speed adjustment without pitch change, and a built-in equalizer with reverb effects. It supports a wide range of audio formats including FLAC, APE, MIDI with custom sound fonts, and TAK, and offers cue sheet playback with proper track navigation. The interface can be extensively customized through XML-based layouts, multiple themes, and mini player variants, while the desktop overlay renders synchronized lyrics and album art independently of the main window.

Additional capabilities include audio format conversion between WAV, MP3, WMA, OGG, and FLAC, tag-based metadata editing with batch operations, and file-based playlist management using M3U/M3U8 formats. The player integrates with LastFM for scrobbling, supports global hotkeys and system media controls, and includes a song search feature with Chinese pinyin matching. Configuration can be backed up and restored, and the player supports portable installation.

## Tags

### Part of an Awesome List

- [Music Players](https://awesome-repositories.com/f/awesome-lists/media/music-players.md) — Plays local music files with features like speed adjustment, equalizer, and A-B loop for practice or analysis.
- [Desktop](https://awesome-repositories.com/f/awesome-lists/media/music-players/desktop.md) — Plays local files with high-quality sound output and extensive format support on Windows.

### Graphics & Multimedia

- [BASS Engine Players](https://awesome-repositories.com/f/graphics-multimedia/audio-player-customizations/bass-engine-players.md) — Uses the BASS audio library for low-level playback, speed adjustment, and real-time audio data extraction.
- [Audio Playback](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-playback.md) — Plays local audio files in a wide range of formats, including FLAC, APE, MIDI, and TAK, using multiple playback engines. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Metadata Tagging](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-processing/metadata-tagging.md) — Reads and writes embedded audio tags and album covers across multiple formats using a unified metadata abstraction.
- [BASS Engine Desktop Players](https://awesome-repositories.com/f/graphics-multimedia/audio-player-customizations/bass-engine-desktop-players.md) — Uses the BASS library for low-latency playback and real-time audio processing on Windows.
- [Lyric Overlays](https://awesome-repositories.com/f/graphics-multimedia/lyric-overlays.md) — Shows synchronized lyrics as an overlay on the desktop with configurable alignment and Karaoke-style highlighting. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Audio Playlist Managers](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/playlist-aggregators/personal-playlist-managers/audio-playlist-managers.md) — Creates, edits, sorts, and saves audio playlists with M3U/M3U8 support and drag-and-drop. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Synchronized Lyric Displays](https://awesome-repositories.com/f/graphics-multimedia/synchronized-lyric-displays.md) — Shows song lyrics in sync with playback, including desktop overlay and karaoke-style highlighting.
- [Spectrum Visualizer Players](https://awesome-repositories.com/f/graphics-multimedia/visualization-mapping/heat-map-generators/audio-frequency-heat-maps/spectrum-analyzers/spectrum-visualizer-players.md) — Renders a real-time frequency spectrum visualization of the currently playing audio.
- [Real-Time Spectrum Visualization Pipelines](https://awesome-repositories.com/f/graphics-multimedia/visualization-mapping/heat-map-generators/audio-frequency-heat-maps/spectrum-analyzers/spectrum-visualizer-players/real-time-spectrum-visualization-pipelines.md) — Extracts frequency data from the audio stream and renders it as a live spectrum display in the UI.
- [Audio Fades and Crossfades](https://awesome-repositories.com/f/graphics-multimedia/audio-fades-and-crossfades.md) — Gradually increases or decreases volume at the start and end of playback for a smooth listening experience. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Playback Speed Controllers](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-playback/playback-speed-controllers.md) — Changes the playback tempo of audio without affecting pitch, useful for language learning or transcription. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Format Converters](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-processing/format-converters.md) — Converts audio files between formats such as WAV, MP3, WMA, OGG, and FLAC, with options for output quality and custom file naming. ([source](https://cdn.jsdelivr.net/gh/zhongyang219/musicplayer2@master/README.md))
- [Global Playback Controllers](https://awesome-repositories.com/f/graphics-multimedia/audio-music/global-playback-controllers.md) — Assigns keyboard shortcuts for common playback actions, including play/pause, volume adjustment, and adding songs to favorites. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Mini Player Layouts](https://awesome-repositories.com/f/graphics-multimedia/audio-player-customizations/mini-player-layouts.md) — Provides multiple mini player layouts and allows users to define their own mini player appearance. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Folder Browsers](https://awesome-repositories.com/f/graphics-multimedia/media-category-browsing/folder-browsers.md) — Navigates and selects folders within the media library using a dedicated folder-browse element. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Album Art Retrievals](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-downloaders/album-group-downloads/album-art-retrievals.md) — Fetches and saves album covers from online sources automatically or manually. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Cue Sheet Playbacks](https://awesome-repositories.com/f/graphics-multimedia/media-track-management/cue-sheet-playbacks.md) — Adds and plays individual tracks from Cue sheet files directly within the media library. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Playback Looping](https://awesome-repositories.com/f/graphics-multimedia/playback-looping.md) — Repeats a user-defined segment of a track continuously for practice or analysis. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Automatic Position Resumers](https://awesome-repositories.com/f/graphics-multimedia/playback-position-tracking/automatic-position-resumers.md) — Remembers the last playback position for each track and offers an option to start from the beginning when switching lists. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Audio Effect Enablers](https://awesome-repositories.com/f/graphics-multimedia/sound-effect-libraries/audio-effect-enablers.md) — Enables audio effects such as reverb and crossfade, and allows selection of output devices. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Album Artwork Displays](https://awesome-repositories.com/f/graphics-multimedia/synchronized-lyric-displays/album-artwork-displays.md) — Shows embedded or downloaded album covers in the main window, mini player, and system search box. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Spectrum Analyzers](https://awesome-repositories.com/f/graphics-multimedia/visualization-mapping/heat-map-generators/audio-frequency-heat-maps/spectrum-analyzers.md) — Shows a small frequency spectrum visualization next to the currently playing track in the playlist. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))

### Content Management & Publishing

- [Music Library Managers](https://awesome-repositories.com/f/content-management-publishing/media-management/audiobook-servers/e-book-servers/comic-book-libraries/personal-library-managers/music-library-managers.md) — Organizes and browses a personal music collection by scanning directories, editing metadata, and creating playlists.
- [Audio Tagging](https://awesome-repositories.com/f/content-management-publishing/metadata-tagging/audio-tagging.md) — Reads and writes metadata tags for many audio formats, including ID3v2, FLAC, and APE, with batch editing and tag retrieval from filenames or online sources. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))

### Data & Databases

- [Media Library Indexers](https://awesome-repositories.com/f/data-databases/metadata-indexing/media-library-indexers.md) — Indexes local audio files into a browsable library organized by artist, album, genre, and folder. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))

### Mobile Development

- [Lyrics and Album Art Downloaders](https://awesome-repositories.com/f/mobile-development/cross-platform-frameworks/flutter/artwork-browsers/artwork-downloaders/lyrics-and-album-art-downloaders.md) — Fetches lyrics and album covers automatically from online sources for the currently playing track.

### User Interface & Experience

- [Interface Layout Customization](https://awesome-repositories.com/f/user-interface-experience/interface-layout-customization.md) — Defines the entire player UI structure through XML configuration files parsed at runtime. ([source](https://cdn.jsdelivr.net/gh/zhongyang219/musicplayer2@master/README.md))
- [Media Player Interfaces](https://awesome-repositories.com/f/user-interface-experience/media-player-interfaces.md) — Defines the entire player layout and appearance through XML configuration files and color themes.
- [Theme Customization](https://awesome-repositories.com/f/user-interface-experience/ui-architecture/design-utilities/design-systems/theme-architecture-frameworks/theme-customization.md) — Switches between dark/light themes, applies rounded corners, blur effects, and custom background images. ([source](https://cdn.jsdelivr.net/gh/zhongyang219/musicplayer2@master/README.md))
- [Runtime XML Layout Engines](https://awesome-repositories.com/f/user-interface-experience/xml-layout-definitions/runtime-xml-layout-engines.md) — Defines the entire player UI structure and behavior through XML configuration files parsed at runtime.
- [Media Transport Controls](https://awesome-repositories.com/f/user-interface-experience/media-transport-controls.md) — Integrates with System Media Transport Controls for remote and keyboard-based playback control. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))

### Artificial Intelligence & ML

- [Sound Font Players](https://awesome-repositories.com/f/artificial-intelligence-ml/algorithmic-music-composition/midi-music-composition-tools/sound-font-players.md) — Plays MIDI music files and allows loading custom sound font libraries. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))

### Business & Productivity Software

- [Audio Segment Loopers](https://awesome-repositories.com/f/business-productivity-software/a-b-testing/audio-segment-loopers.md) — Maintains a user-defined start and end position within a track and triggers seamless repeat playback between those points.
- [Song Searches](https://awesome-repositories.com/f/business-productivity-software/digital-library-search/song-searches.md) — Finds songs in the library or playlist by name, artist, or album with support for Chinese pinyin matching. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))

### Development Tools & Productivity

- [Tag-Based File Renamers](https://awesome-repositories.com/f/development-tools-productivity/developer-utilities-libraries/workflow-productivity-enhancers/developer-productivity-utilities/file-management-utilities/bulk-file-renamers/tag-based-file-renamers.md) — Renames audio files using their embedded metadata tags. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Lyric Retrieval](https://awesome-repositories.com/f/development-tools-productivity/integration-metadata-retrievers/media-metadata-retrievers/lyric-retrieval.md) — Retrieves lyrics automatically from online services and saves them with an Artist - Title naming format. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [Album Art Retrievals](https://awesome-repositories.com/f/development-tools-productivity/integration-metadata-retrievers/media-metadata-retrievers/lyric-retrieval/album-art-retrievals.md) — Downloads album covers and lyrics automatically or manually from online sources. ([source](https://github.com/zhongyang219/MusicPlayer2/blob/master/Documents/update_log.md))
- [M3U Playlist Editors](https://awesome-repositories.com/f/development-tools-productivity/playlist-managers/m3u-playlist-editors.md) — Loads and saves playlists in standard m3u/m3u8 format with drag-and-drop and metadata persistence.