Repository navigation
What's Changed
If you are upgrading: settings are migrated on first launch, and the 2.x file is kept as mh-settings.json.bak.
Changed
- Breaking: store settings in a nested, versioned layout that 2.x builds cannot read (
a109276) - Breaking: play Spotify as AAC through Widevine instead of Ogg Vorbis through PlayPlay, which needs a
.wvdfile and the Spotify dependency (a109276) - Play audio through a native engine instead of the WebView, with crossfade, replay gain and output device selection (
72d4183) - Index local music in SQLite instead of rescanning folders on every visit (
fb24ac6) - Open search results as full album, artist and playlist pages instead of a pop-up (
fb24ac6) - Start Apple Music playback without Python and gamdl by handling the Widevine license in Rust (
a109276) - Show track details in OS media controls (MPRIS, Windows, macOS) (
72d4183) - Show speed, ETA, per-item progress and a summary for batch downloads (
a109276) - Stop editing shell profiles and the Windows user
PATHwhen installing tools (3b8f086) - Run every music service through shared search, download and playback providers (
a109276) - Replace the logo and app icons (
183e82a) - Require Node.js 24 or later to build from source (
58b7c70,4d6fce3)
Added
- Add native Spotify and Apple Music downloaders and use them by default; votify and gamdl remain available (
a109276) - Add internet radio: search Radio Browser, SomaFM and the Icecast directory, with favourites, custom lists, imports and a station editor (
67bcba2) - Add streaming-service libraries with saved albums, artists, playlists and home shelves, and write saves, follows and playlist edits back to the service (
fb24ac6) - Add in-app updates for AppImage, deb, rpm, NSIS, MSI and macOS builds (
f85240c) - Add local playlists with M3U import and export (
fb24ac6) - Add a tag editor, play history and a start-radio action to the local library (
fb24ac6) - Add autoplay, which queues similar tracks from the same service when the queue runs out (
72d4183) - Add playback of APE, Musepack, Speex and TTA files (
72d4183) - Add credential health checks with a status pill on each service's settings tab (
9e819a8) - Add in-app sign-in for Qobuz and Tidal, and Tidal token import (
9e819a8) - Add a service picker to onboarding, and hide the services you don't use (
a109276,3b8f086) - Add an Audio/Video choice for pasted links, so any yt-dlp site can be saved as audio (
a109276) - Skip tracks already downloaded from the same service (
a109276) - Add installers for aria2c, Deno and N_m3u8DL-RE (
3b8f086) - Add action buttons to notifications, and replace repeated ones instead of stacking them (
bff223f) - Sign release checksums and the RPM with GPG, and attest build provenance (
8b4111c,e714448) - Document how to verify a release (
5e091b8)
Fixed
- Sort album tracks by disc and track number (#41) (
fb24ac6) - Install a native FFmpeg build on Apple Silicon Macs (#38) (
3b8f086) - Detect yt-dlp installed outside MediaHarbor's Python environment (#30) (
3b8f086) - Report the real app version on the Dependencies page and to the update check (#44) (
a109276) - Bundle FFmpeg and Python in the Snap, so downloads work there (
d81d3ad) - Fix Copy link doing nothing on Linux (
a109276)
Installation
| Platform | File | How to install |
|---|---|---|
| Linux (Debian/Ubuntu) | *.deb |
sudo dpkg -i MediaHarbor_*.deb |
| Linux (Fedora/RHEL) | *.rpm |
sudo rpm -i MediaHarbor_*.rpm |
| Linux (universal) | *.AppImage |
chmod +x *.AppImage && ./MediaHarbor_*.AppImage |
| Linux (Flatpak) | *.flatpak |
flatpak install MediaHarbor-*.flatpak |
| Windows (installer) | *x64-setup.exe |
Run the setup wizard |
| Windows (MSI) | *.msi |
msiexec /i MediaHarbor_*.msi |
| macOS Intel | *x64.dmg |
Open DMG, drag to Applications, then see the macOS note below |
| macOS Apple Silicon | *aarch64.dmg |
Open DMG, drag to Applications, then see the macOS note below |
Also available via Snap (sudo snap install mediaharbor) and AUR (paru -S mediaharbor).
macOS: first launch
MediaHarbor is not notarized, so macOS blocks it the first time. After dragging it to Applications, run:
xattr -dr com.apple.quarantine /Applications/MediaHarbor.appOnly needed once — updates installed from inside the app are unaffected.
Verify this release
Every artifact below is hashed in SHA256SUMS.txt, which is GPG-signed as SHA256SUMS.txt.asc.
# one-time: import the release key
curl -fsSL https://raw.githubusercontent.com/MediaHarbor/mediaharbor/main/packaging/keys/mediaharbor-release.asc | gpg --import
# verify the manifest, then the files against it
gpg --verify SHA256SUMS.txt.asc SHA256SUMS.txt
sha256sum --ignore-missing -c SHA256SUMS.txtKey fingerprint: 4E7E D764 DFB4 F1B6 59C1 C570 DD7A E5F9 C20A 4047
The RPM additionally carries an embedded signature (rpm --checksig), and every
artifact has a Sigstore build-provenance attestation proving it was produced by
this repository's release workflow:
gh attestation verify <file> --repo MediaHarbor/mediaharborSHA256 Checksums
| File | SHA256 |
|---|---|
MediaHarbor-3.0.0-1.x86_64.rpm |
09df71f2dfaa150a7188d0e76e8416793e1cf519af8f01e2700a7c5b33bde0ce |
MediaHarbor-aarch64.flatpak |
cc4ff6196327ece335b6de131c25484007181e9e58d401261a79e245af3460f1 |
MediaHarbor-x86_64.flatpak |
d1a7a7a15c650db349f7e72873d4062025f81620a23c8a4603b5cb7922d68022 |
MediaHarbor_3.0.0_aarch64.dmg |
1a5b936cfccb588249379a00acb94fcf66bf0dec7933c5133feb27ca62f4ed2e |
MediaHarbor_3.0.0_amd64.AppImage |
d383353c553e21a97173a65a44275062647f5a4f0b3719f7758bc23c2c14e443 |
MediaHarbor_3.0.0_amd64.deb |
e1f9bef933bec1147a181ec68157a90bf45efea31c3c900d3aff502286d94083 |
MediaHarbor_3.0.0_x64-setup.exe |
95525e79c22805ee33fb2420a40ff2a47ef8d8f78e116665fb8f9112dd0398aa |
MediaHarbor_3.0.0_x64.dmg |
352f2b69c584fa89b404be0cd2eb1dc1dbc0c9095c61920df82ec8c5b16c02ff |
MediaHarbor_3.0.0_x64_en-US.msi |
37cd81a6dc97e469e8c818a0bdae30b6424d865454babe5d8f80f5cb09f68a49 |
MediaHarbor_aarch64-apple-darwin.app.tar.gz |
0174b97e642778b97142b42fa947e3f0e25fc79e9f4d08cf5d2221fda047b6ae |
MediaHarbor_x86_64-apple-darwin.app.tar.gz |
87de86ed393cfb6de6f2045b423c910fdf7c9b05c9968e9bc53fd59574af935f |
Full changelog: v2.2.0...v3.0.0