Technical Documentation: harmonoid/harmonoid
ℹ️ Provenance: Multi-Tier Ingestion · CodeWiki Reference
Overview (`README.md`)
Harmonoid
🎵 Plays & manages your music library. Looks beautiful & juicy.
Website • Download • Discord • Available for Windows, GNU/Linux, macOS, Android & iOS!
Features
- Performant media library & tag reader.
- Material Design 3 & 2.
- Light & dark themes.
- Lyrics (LRC, tags & online).
- Lyrics translations.
- Notification lyrics.
- Artist images.
- Playlists.
- Gapless playback.
- Speed adjustment.
- Pitch adjustment.
- Volume boost.
- Crossfade.
- ReplayGain.
- Exclusive audio.
- Tag editor.
- Last.fm integration.
- Discord RPC integration.
- mpv/FFmpeg backend. Supports all file formats.
- Multiple artist & genre support.
- Fallback cover support. e.g. cover.jpg, Folder.jpg etc.
- Small installer (≈ 35 MB) & low RAM usage (≈ 150 MB).
- Excellent backward compatibility, Windows 10+, macOS 10.15+, Android 7.0+ & iOS 14.0+.
- Portable.
- Cross-platform (Windows, GNU/Linux, macOS, Android & iOS).
- System Media Transport Controls & Taskbar Thumbnail Toolbar for Windows.
- D-Bus MPRIS controls for GNU/Linux.
- MPNowPlayingInfoCenter for macOS & iOS.
- Notification.MediaStyle for Android.
Why
It's really hard to find software with good design & animations on desktop. It's almost like desktop app developers don't have faith in adding animations to their UI. Other music players, which look kind-of good don't work properly, refuse to support an audio format, read tags incorrectly, don't have my favorite feature or simply use electron.js.
Harmonoid very strictly implements Material Design to be a consistent, cohesive & modern music player for all platforms. There are no inconsistent paddings, spacings or weird alignments to make me feel uncomfortable. It's built with care & proper time is given to everything.
Localizations
You can help the project by adding or updating localizations at harmonoid/localizations.
License
This project & the work under this repository is governed by PolyForm Strict License 1.0.0 that can be found in the LICENSE file.
Overview (`ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md`)
Launch Screen Assets
You can customize the launch screen with your own desired assets by replacing the image files in this directory.
You can also do it by opening your Flutter project's Xcode project with open ios/Runner.xcworkspace, selecting Runner/Assets.xcassets in the Project Navigator and dropping in the desired images.
--- METRICS ---
- Files Extracted: 2
- Estimated Token Budget: ~978 tokens
- Canonical Reference: https://codewiki.google/github.com/harmonoid/harmonoid