🎬 Watch Gharmonize Demo
2.mp4
Next-generation media processing, powered by yt-dlp, FFmpeg and deno.
Seamlessly download content from YouTube, YouTube Music, and major platforms like X, Facebook, Instagram, Vimeo, Dailymotion, and TikTok. Leverage Spotify, Apple Music, and Deezer for intelligent metadata matching and track discovery — then fetch high-quality media via yt-dlp. Includes DRM-free disc ripping, iPhone / Android ringtone output, and blazing-fast GPU-accelerated transcoding, all powered by a robust and reliable processing engine.
Spotify note: Spotify is used for metadata + matching (track/playlist/album info). Gharmonize does not claim DRM bypass.
Important
The only official Gharmonize source repository and release channel is G-grbz/Gharmonize. Official desktop binaries are published through GitHub Releases, and the official container image is published through GitHub Container Registry.
Repositories, websites, archives, or executables using the Gharmonize name outside these channels are not official unless this repository explicitly says otherwise. Never disable Windows Defender or another security product, add antivirus exclusions, or run an unrelated executable as Administrator just because a third-party page claims it is required for Gharmonize.
Independent third-party listing: Softpedia – Gharmonize independently lists and reviews Gharmonize. This listing was created independently; it was not requested, operated, or managed by the Gharmonize project. Use the official GitHub release page, SHA256SUMS, and GitHub artifact attestations when you need to verify a release.
For guidance on unofficial downloads, impersonation, and reporting suspicious distributions, see SECURITY.md. For use of the Gharmonize name and logo, see TRADEMARK.md.
Prebuilt desktop builds: Official Gharmonize Windows EXE and Linux AppImage releases already include the Node.js runtime required by the application through Electron. You do not need to install Node.js separately to use these packaged builds. Some third-party download sites may incorrectly list Node.js as an additional prerequisite; that notice can be ignored for official prebuilt Gharmonize binaries. Node.js is only required when running or building Gharmonize from source.
Local / Desktop (from source)
git clone https://github.com/G-grbz/Gharmonize
cd Gharmonize
BUILD_ELECTRON=1 npm i
npm startThen open http://localhost:5174
Gharmonize checks runtime binaries (ffmpeg, ffprobe, mkvmerge, yt-dlp, deno) at startup and downloads or refreshes them automatically when needed.
For packaged AppImage/EXE builds and full installation details, see docs/INSTALLATION.md.
Gharmonize can run from the official GitHub Container Registry (GHCR) image or be built locally from source. The default/local Compose configuration does not request the NVIDIA runtime.
Official image: ghcr.io/g-grbz/gharmonize
docker pull ghcr.io/g-grbz/gharmonize:latest
docker compose pull
docker compose up -dRelease versions are also published with versioned tags such as ghcr.io/g-grbz/gharmonize:1.3.8, allowing deployments to pin a specific Gharmonize release instead of tracking latest.
Local source build
docker compose -f docker-compose.local.yml up -d --buildLocal source build with NVIDIA / NVENC
docker compose \
-f docker-compose.local.yml \
-f docker-compose-local-nvidia.yml \
up -d --buildImportant:
docker-compose-local-nvidia.ymlis an override, not a standalone Compose stack. Always load it afterdocker-compose.local.yml. It adds the NVIDIA-specific settings (gpus: all, NVIDIA runtime/environment, root user, and privileged mode) to the basewebservice. Do not run the NVIDIA override by itself. Without the override, the local Compose stack does not request NVIDIA devices or the NVIDIA container runtime.
Docker runtime binaries (FFmpeg, FFprobe, MKVToolNix, yt-dlp, and Deno) are checked at startup and cached under /opt/gharmonize/cache; missing or outdated managed binaries can be refreshed automatically. On a new Docker installation, the generated initial admin password is stored at /opt/gharmonize/cache/INITIAL_ADMIN_PASSWORD.txt.
Full Docker setup, bind mounts, permissions, MUSIC_DIR, NVIDIA Container Toolkit requirements, and docker run examples are documented in docs/DOCKER.md.
- YouTube / YouTube Music downloads for single items, playlists, and mixes
- YTLive — a dedicated music-first UI for YouTube discovery, playback, and queueing
- X (Twitter) / Facebook / Instagram / Vimeo / Dailymotion / TikTok download and conversion flows
- Spotify, Apple Music, and Deezer mapping for track / playlist / album workflows, including personalized Deezer
inspired-by-*smart tracklists - Phone ringtone output for iPhone (
.m4r) and Android (.mp3) - Audio and video conversion powered by FFmpeg, with FPS/A-V sync presets for AC3 / EAC3 / AAC
- GPU acceleration for local transcoding — NVENC, VAAPI, Intel QSV
- DRM-free disc ripping with stream selection in the Web UI
- Runtime binary management for ffmpeg, ffprobe, mkvmerge, yt-dlp, and deno
- Job engine for batch processing, progress tracking, and reliability
Full details in docs/FEATURES.md.
| Guide | Description |
|---|---|
| docs/INSTALLATION.md | Requirements, local/desktop setup, build commands |
| docs/DOCKER.md | Docker Compose, Docker run, NVIDIA/NVENC |
| docs/FEATURES.md | Full feature list and supported sources |
| docs/YTLIVE.md | YTLive music UI guide |
| docs/CONFIGURATION.md | Full .env variable reference |
| docs/BINARY_MANAGEMENT.md | ffmpeg / yt-dlp / deno binary handling |
| docs/COOKIES.md | Cookies, age-restricted content, environment comparison |
| docs/HOMEPAGE_WIDGET.md | Homepage dashboard widget setup |
| docs/TROUBLESHOOTING.md | Common issues & fixes |
| LICENSE.md | GPL-3.0 license & redistribution rules |
| TRADEMARK.md | Gharmonize name, logo, and branding policy |
| THIRD_PARTY_LICENSES.md | Bundled third-party tool licenses |
For users who want a more advanced MKV finishing workflow after ripping or extracting DRM-free media, check out G-TMCE:
🔗 https://github.com/G-grbz/G-TMCE
G-TMCE is a cross-platform MKV creation and extraction GUI for Linux and Windows. It focuses on professional remux workflows with TMDB metadata, automatic tags.xml generation, artwork downloads, chapter generation, language-aware audio/subtitle handling, forced/SDH subtitle detection, and MKVToolNix automation.
Gharmonize is designed for downloading, conversion, ripping, tagging, and batch processing. G-TMCE can be used as a companion tool when you want to prepare polished MKV outputs for media libraries and home media servers.
This software is provided "as is", without warranty of any kind. Use it at your own risk.
Gharmonize is licensed under the GPL-3.0 license.
- Full terms and redistribution rules: LICENSE.md
- Licenses for bundled third-party tools (FFmpeg, MKVToolNix, yt-dlp, deno): THIRD_PARTY_LICENSES.md
Gharmonize uses scrypt admin password hashing, AES-256-GCM encryption for supported sensitive settings, configurable server-side application access gating with optional administrator-approved temporary sessions, loopback-by-default native serving, trusted-proxy CIDR validation, SSRF/path hardening, Electron sandbox/IPC restrictions, and runtime-binary origin/digest checks. See SECURITY.md for the reporting policy and deployment notes.
Official tagged releases are built by GitHub Actions for Windows and Linux and publish Windows NSIS/portable artifacts, a Linux AppImage, a source archive, CycloneDX SBOM, a GPG-signed SHA256SUMS manifest, the public release-signing key, and GitHub artifact attestations.
# First authenticate the published release key against the official repository provenance.
gh attestation verify Gharmonize-release-signing-key.asc --repo G-grbz/Gharmonize
# Import the authenticated public key and verify the signed checksum manifest.
gpg --import Gharmonize-release-signing-key.asc
gpg --verify SHA256SUMS.asc SHA256SUMS
sha256sum -c SHA256SUMS
# You can also verify any individual artifact directly against GitHub provenance.
gh attestation verify <artifact> --repo G-grbz/Gharmonize