Releases: G-grbz/Gharmonize
Gharmonize v1.2.6
🚀 Gharmonize v1.2.6
This release introduces advanced audio normalization capabilities during transcoding, providing better loudness consistency and dynamic range control.
🔊 Audio Transcoding Enhancements
- Added loudnorm modes for EBU R128 loudness normalization
- Introduced Dynamic Range Control (DRC) for improved audio balance
- Implemented two-pass processing for more accurate and consistent normalization results
Gharmonize v1.2.5
🚀 Gharmonize v1.2.5
This release introduces ringtone support for both iOS and Android, improves third-party app management, and enhances download result handling.
📱 Ringtone Mode
- Added iOS and Android-compatible ringtone download mode
- Optimized output formats for seamless use across mobile devices
⚙️ Third-Party App Management
- Added automatic download and update support for third-party applications
- Removed third-party apps from the main app root and Docker container
- Updated related modules to align with the new workflow
📥 Download & Error Handling Improvements
- Enhanced error handling for download results
- Added logic to track matched logical indices and process download results more accurately
Gharmonize v1.2.4
🚀 Gharmonize v1.2.4
This release focuses on improving tagging accuracy, expanding platform support, and enhancing overall UX.
🏷️ Tagging Improvements
- Fixed album order issues in metadata
- Resolved incorrect total track count in tagging
- Improved overall tagging consistency and reliability
🔗 Matching Enhancements
- Improved matching accuracy between YouTube and Apple Music
- Reduced rare mismatches during metadata resolution
🎧 Deezer Support Added
You can now use Deezer as a source, including:
- Track
- Album
- Playlist
- Artist top tracks
🎬 Video & Metadata Fixes
- Fixed video job metadata handling
- MKV files are now treated like other video outputs in UI and logs
- Switched to server-side
completedAtinstead of browser fallback - Preserved empty audio selection for silent video exports
📱 UI / UX Improvements
- Improved usability of preview start/end input fields across desktop and mobile
🌍 Localization
- Added Spanish language support
Gharmonize v1.2.3
🎵 Gharmonize v1.2.3
✨ New Features
🍎 Apple Music Support
- Added Apple Music support via yt-dlp matching
- Apple Music playlists, albums, and single tracks can now be matched and converted
- Improved media metadata matching for Apple Music sources
⚡ Improvements
🔄 Progress Flow Enhancements
- Improved Spotify progress flow
- More accurate real-time progress updates
🛑 Job Cancellation Fixes
- Fixed issues in the job cancellation workflow
📦 Embedding Completion Counter
- Embedding completion counter now persists until conversions are removed from the directory
🖼️ Better Cover Art Handling
- Apple Music cover art is now preferred when available for YouTube MP3 conversions
🏷️ Metadata Improvements
- ID3 tags enriched with better metadata handling
🛠️ General Improvements
- Various minor improvements and optimizations across the application
📌 Summary
This release focuses on Apple Music integration, improved conversion reliability, and better metadata and progress tracking across the application.
Full Changelog: v1.2.2...v1.2.3
Gharmonize v1.2.2 Release
🚀 Gharmonize v1.2.2 Release
🎵 Improvements
Spotify Web API Compatibility Update
This release updates Gharmonize to support recent changes in the Spotify Web API.
Several internal transformations and tagging mechanisms used throughout the application have been revised to ensure continued compatibility and stable integration.
🔧 Changes
- Updated Spotify transformation logic used across the application.
- Adjusted tagging and metadata mapping to align with the latest Spotify Web API behavior.
- Improved overall Spotify integration stability.
📦 Notes
If you are using features that rely on Spotify metadata or synchronization, updating to this version is recommended to ensure proper functionality.
Full Changelog: v1.2.1...v1.2.2
Gharmonize v1.2.1
🚀 Gharmonize v1.2.1 Release
This release focuses on improving long‑term maintainability by introducing an easier way to keep required binaries up to date.
✨ Features
🔄 Automatic & Manual Binary Updates
- Added support for updating yt-dlp and Deno automatically at system startup.
- Added an option to manually update binaries from the Settings panel.
These improvements help ensure the application always runs with the latest compatible versions and remains easier to maintain over time.
🐳 Docker Users
If you are running Gharmonize in Docker and want to enable binary management inside the container, add the following line to your .env file:
GHARMONIZE_WEB_BINARIES_IN_DOCKER=1This allows Gharmonize to manage yt-dlp and Deno binaries on the host system when using Docker.
🧩 Summary
- Automatic updates for yt-dlp and Deno on system startup
- Manual update option via Settings panel
- Optional Docker binary management via environment variable
💡 Keeping these tools updated ensures better compatibility, stability, and sustainability for the Gharmonize ecosystem.
Full Changelog: v1.2.0...v1.2.1
Gharmonize v1.2.0
🚀 Gharmonize v1.2.0 Release
✨ New Features
-
Added support for:
- X (Twitter)
- Vimeo
- Dailymotion
- TikTok
-
Added ability to embed 🎤 lyrics directly into tracks
-
Added automatic subfolder export for:
- YouTube playlists
- Spotify playlists
- Spotify albums
🔧 Improvements
-
Improved Spotify matching logic for YouTube conversions
-
Improved playlist output naming
-
Enhanced YouTube output naming system
-
MP4 is now the default codec for:
- X
- TikTok
📂 Usability
-
Added Show & Open Download Directory feature
⚠️ Works only on the server machine where Gharmonize is installed.Not supported in:
- Docker environments
- Web client access from other devices
⏱️ Conversion Insights
-
Added processing time metrics:
- Start time
- End time
- Total duration
-
Added MP4 conversion stats:
- Converted media duration
- FPS information
Full Changelog: v1.1.1...v1.2.0
Gharmonize v1.1.1
Gharmonize v1.1.1
🚀 Release Highlights
This release focuses on improving dashboard integration, refining cover art handling with optional Spotify support, and strengthening server initialization and error handling.
✨ Added
Homepage Widget Integration
- Added a Gharmonize homepage widget for seamless dashboard integration.
- Introduced a custom homepage dashboard configuration.
- Embedded Gharmonize as a reusable widget component, making it easier to integrate into existing layouts.
🎵 Enhanced
Cover Handling with Optional Spotify Support
-
Improved cover selection logic with clearer preference handling.
-
Added support for Spotify cover URLs.
-
Introduced conditional Spotify matching for YouTube downloads:
- When
PREFER_SPOTIFY_TAGS=1is set, album covers are optionally fetched from Spotify if a matching track is found. - When disabled, Gharmonize continues using downloaded or embedded covers as usual.
- When
-
Added environment variable checks to ensure predictable and configurable behavior.
🔧 Refactored
Server Initialization & Error Handling
- Improved server startup flow for better stability.
- Converted
PORThandling to a strict numeric value. - Updated and clarified server error messages for easier debugging and maintenance.
Full Changelog: v1.1.0...v1.1.1
Gharmonize v1.1.0
Gharmonize v1.1.0 🚀
✨ What’s New
🎵 Prefer Spotify Album Art
- Gharmonize now always fetches and embeds album artwork directly from Spotify during Spotify conversions.
- ✅ Ensures consistent, official cover art across the pipeline.
- 🧼 Prevents fallback to YouTube/yt-dlp thumbnails.
- 🏷️ Produces cleaner, more reliable metadata for downloads and library tools.
🔊 DTS Audio Support (Core) for Transcoding + Downloads
- Added DTS (Core) as an audio codec option for internal transcoding and download workflows.
- 🎚️ Selectable via audio codec options (DTS /
dca). - 📦 Includes DTS-friendly bitrate presets where applicable (e.g., 768k / 1024k / 1509k / 1536k).
- 🛠️ Integrates cleanly with existing settings without changing defaults unless chosen.
🎞️ MP4 Audio FPS Sync (Tempo Adjust)
- Added an audio tempo correction setting to ensure audio stays perfectly aligned during MP4 encoding.
- 🔁 Includes common presets like 23.976 ↔ 24, 23.976 ↔ 25, 25 ↔ 24, and more.
- 🎧 Helps prevent audio drift when converting between TV/stream and cinema frame rates.
- ⚙️ Quick to apply via a dedicated UI control.
Full Changelog: v1.0.9...v1.1.0
Gharmonize v1.0.9
Gharmonize v1.0.9 🚀
✨ What’s New
🎬 Preview Encoding (Test Encode)
Before committing to a full conversion, you can now generate a short preview encode.
Why this matters:
- Verify output quality before long encodes
- Test codec, bitrate, and resolution settings
- Confirm audio/subtitle stream selections
- Save time by avoiding incorrect full encodes
This makes your encoding workflow safer, faster, and more predictable.
🌈 HDR → SDR Conversion
You can now properly convert HDR videos into SDR for maximum compatibility.
Includes:
- Accurate tone mapping
- Controlled peak brightness handling
- Correct color space, transfer and range mapping
- Clean SDR output for non‑HDR displays
Perfect for sharing HDR content on standard screens, mobile devices, and SDR platforms.
✨ SDR → HDR Conversion
Need to upgrade your SDR content into HDR? Gharmonize now supports SDR to HDR upscaling.
Features:
- Converts SDR to HDR (PQ / BT.2020)
- Applies brightness expansion and tone shaping
- Produces HDR‑compatible video streams
- Great for HDR TVs, projectors, and premium displays
Full Changelog: v1.0.8...v1.0.9