https://github.com/MediaHarbor/mediaharbor
Cross-platform Media Ripping and Browsing GUI
https://github.com/MediaHarbor/mediaharbor
apple-music cross-platform deezer downloader gamdl gui mediaharbor music music-downloader orpheusdl qobuz react spotify tauri tidal votify youtube youtube-music yt-dlp
Last synced: about 9 hours ago
JSON representation
Cross-platform Media Ripping and Browsing GUI
- Host: GitHub
- URL: https://github.com/MediaHarbor/mediaharbor
- Owner: MediaHarbor
- License: gpl-3.0
- Created: 2024-10-13T04:48:49.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-05-06T06:05:42.000Z (about 2 months ago)
- Last Synced: 2026-05-06T07:11:56.981Z (about 2 months ago)
- Topics: apple-music, cross-platform, deezer, downloader, gamdl, gui, mediaharbor, music, music-downloader, orpheusdl, qobuz, react, spotify, tauri, tidal, votify, youtube, youtube-music, yt-dlp
- Language: Rust
- Homepage: https://mediaharbor.org
- Size: 15.5 MB
- Stars: 162
- Watchers: 1
- Forks: 6
- Open Issues: 17
-
Metadata Files:
- Readme: README.MD
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-video-downloaders - mediaharbor - 3.0 | MS Store · GitHub | **12** · S2 D4 Q3 Su1 A2 Au0 | native Tidal / Qobuz / Deezer clients · built-in player | (Comparison at a glance / The board)
README
# MediaHarbor
[](https://tauri.app/)[](https://www.rust-lang.org/)[](https://www.typescriptlang.org/)
  
 [](https://discord.gg/Kc97D86TeZ)
MediaHarbor is an all-in-one media downloader and player. Search, stream, and download audio/video from YouTube, Spotify, Tidal, Deezer, Qobuz, Apple Music, and more.
---
## Table of Contents
- [Features](#features)
- [Supported Platforms](#supported-platforms)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Building from Source](#building-from-source)
- [In-App Dependency Setup](#in-app-dependency-setup)
- [Known Issues](#known-issues)
- [Contributing](#contributing)
- [License](#license)
---
## Features
- **Search** across all supported platforms from a single interface
- **Download** tracks, albums, playlists, and videos at your chosen quality
- **Stream** directly inside the app with a built-in audio/video player
- **Lyrics** — synced (LRC), plain text, and word-by-word display where available
- **Local library** — scan a folder and browse your downloaded media by album/artist
- **Automatic dependency management** installs yt-dlp, ffmpeg, Python, votify, gamdl, and more from the Dependencies page
- **OrpheusDL integration** optional backend for platform downloads via modular support
- **In-app settings editor** — configure all platform credentials without touching config files
---
## Prerequisites
Before building, make sure you have:
- **Node.js** ≥ 18 and **npm**
- **Rust** (stable toolchain) — install from [rustup.rs](https://rustup.rs/)
- Tauri system dependencies for your OS — see the [Tauri v2 prerequisites guide](https://tauri.app/start/prerequisites/)
On Linux you also need: `libwebkit2gtk-4.1-dev`, `libssl-dev`, `libayatana-appindicator3-dev`, `librsvg2-dev`
---
## Building from Source
### 1. Clone the repository
```bash
git clone https://github.com/MediaHarbor/MediaHarbor.git
cd MediaHarbor
git checkout tauri-migration
```
### 2. Install dependencies
```bash
npm install
```
### 3. Run in development mode
```bash
npm run tauri:dev
```
This starts the Vite dev server and the Tauri process concurrently.
### 4. Build a production binary
```bash
# Linux only (.deb, .rpm, .AppImage)
npm run tauri:build:linux
# Windows only (.msi, .exe)
npm run tauri:build:win
# macOS (universal or targeted)
npm run tauri:build:mac
npm run tauri:build:mac:x64
npm run tauri:build:mac:arm64
```
The output is placed in `src/app/target/release/bundle/`.
---
## In-App Dependency Setup
MediaHarbor manages its own tool dependencies through the **Dependencies** page inside the app. On first launch, open the Updates tab and install what you need:
- **Python / yt-dlp** required for YouTube and YouTube Music downloads
- **ffmpeg** required for muxing and format conversion
- **votify + Bento4** required for Spotify downloads (cookies also needed in Settings)
- **gamdl + Bento4** required for Apple Music downloads (cookies also needed in Settings)
- **OrpheusDL + modules** optional alternative backend for platform downloads
Platform credentials (Tidal OAuth, Deezer ARL, Qobuz login, Spotify/Apple cookies) are all configured from the **Settings** page.
---
## Known Issues
- Library page may not work properly for big folders
- Apple Music streamings haven't added yet
- Synced lyrics may get out of sync due on Windows and some tracks
---
## Contributing
Contributions are welcome. Please open an issue before submitting a pull request for larger changes. For smaller fixes, a PR is fine directly.
---
## License
GPL-3.0 — see [LICENSE](LICENSE) for details.