Skip to content

MediaHarbor v3.0.0

Latest

Choose a tag to compare

@github-actions github-actions released this 02 Oct 16:30
· 1 commit to main since this release

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 .wvd file 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 PATH when 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.app

Only 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.txt

Key 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/mediaharbor

SHA256 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