Software » Video Downloaders » Gharmonize 1.3.2

Gharmonize v1.3.2
This release enhances the YTLive interface, expands playback navigation controls, and introduces new configuration options for application timeouts, playlist processing, and file uploads.

It also improves automatic track navigation, adds previous and next controls for playlist playback, introduces an auto-play mode for individual tracks, and updates application and build dependencies.

YTLive Interface & Styling
Enhanced the overall YTLive interface
Improved visual consistency across YTLive components
Refined interface spacing, layout, and responsive behavior
Improved styling for playback and navigation controls
Improved the usability of playlist and track actions
Playback Navigation Controls
Added Previous and Next buttons for playlist playback
Improved navigation between tracks in active playlists
Updated player controls dynamically during automatic playback
Improved previous and next track selection while auto-play is active
Preserved playlist navigation state during continuous playback
Auto-Play Improvements
Added an auto-play mode for individually selected tracks
Automatically continues playback with related or available tracks
Improved track transitions during automatic playback
Improved player navigation controls while operating in auto mode
Refined track selection behavior when the playback queue changes
New Configuration Options
Updated .env.example with newly supported configuration parameters
Added configurable timeout values for application operations
Added playlist processing and item-count limits
Added upload size and processing limits
Improved configuration flexibility for different deployment environments
Documented the new environment options in the example configuration
Dependency Updates
Updated application dependencies
Updated Electron and build-related dependencies
Improved compatibility with newer runtime components
Refreshed development and packaging dependencies
Improved overall build and runtime reliability


Gharmonize v1.3.1
This release introduces YTLive Download Lists, allowing tracks, albums, and playlists from multiple music services to be collected into custom lists and downloaded or converted in batches with a single action.

It also adds cached Spotify, Apple Music, and Deezer mapping workflows, download-list synchronization, locale-aware mood discovery, improved album metadata matching, and several runtime reliability improvements.
YTLive Download Lists
Added a new My Download Lists section to YTLive
Create custom download lists directly from the YTLive interface
Add tracks, albums, and playlists to the same list
Combine music content from YouTube, Spotify, Apple Music, and Deezer
Remove individual items or delete complete lists
Store download lists persistently in the application cache
Display item counts, list status, and list cards in the YTLive interface
Queue an entire list for batch downloading and conversion with a single action
Cached Music Mapping
Added persistent mapping manifests for Spotify, Apple Music, and Deezer sources
Resolve external music sources to matching YouTube Music results
Cache matched YouTube Music IDs as JSON manifests and URL lists
Reuse previously matched tracks through cache hits instead of searching again
Integrated mapping operations with YTLive streaming and progress updates
Added shared concurrency handling across Spotify, Apple Music, and Deezer mapping pipelines
Batch Downloading
Added per-track job creation for items stored in download lists
Added one-click batch download and conversion actions
Added clientBatch and batchTotal metadata for tracking grouped jobs
Preserved the existing job pipeline while providing more controlled list-based queueing
Maintained stable item ordering during mapped music downloads and conversions
Expanded Quick URL Support
Extended the YTLive quick URL field beyond YouTube and YouTube Music
Added support for Spotify URLs
Added support for Apple Music URLs
Added support for Deezer URLs
External music URLs are now resolved and mapped to YouTube Music before processing
Download List Synchronization
Added synchronization support for saved mapped music lists
Re-resolve saved Spotify, Apple Music, and Deezer playlists or albums
Detect and add newly available tracks
Refresh cached mappings during synchronization
Rebuild outdated list resolutions without recreating the complete list
Discovery Improvements
Reworked YTLive discovery presets to better match the user's language and region

Replaced generic popular and new-release searches with mood-focused discovery presets

Added the following discovery moods:

Energetic
Workout
Feel Good
Relax
Sad
Romantic
Commute
Party
Focus
Sleep
Prioritized music-focused content in mood discovery results

Filtered Shorts, podcasts, and episodes from mood shelves

Improved regional and localized discovery behavior

Playback & YTLive Improvements
Preserved the active player while searching, navigating, and refreshing shelves
Prevented page interactions from unnecessarily interrupting active playback
Improved YTLive playback stability
Improved embedded player fallback behavior
Clarified currently playing track indicators in playlist and album views
Improved download actions in playlist and album track panels
Metadata & File Naming
Improved YouTube Music album-name detection
Improved album artist detection and normalization
Improved ID3 metadata matching for YouTube Music album tracks
Reduced metadata mismatches caused by inconsistent album and track names
Preserved cleaner track metadata during lyrics matching
Reduced incorrect lyrics matches
Improved output directory naming for album downloads
Preserved original filenames for uploaded files and local media jobs
Runtime & Reliability Improvements
Improved runtime binary validation and download workflows
Improved yt-dlp process cleanup
Improved temporary runtime binary handling
Strengthened completed-job state persistence
Added improved cache-directory writability checks
Added fallback handling when the primary job-state cache directory is unavailable
Documentation & Licensing
Simplified the main README
Moved detailed usage documentation under the docs/ directory
Reorganized the project license files
Reorganized third-party license documentation
Note
YTLive Download Lists expand Gharmonize from a music discovery and playback interface into a persistent multi-source download workflow.

Tracks, albums, and playlists from YouTube, Spotify, Apple Music, and Deezer can now be collected into reusable lists, synchronized with their original sources, resolved through cached YouTube Music mappings, and queued for batch downloading or conversion.


Gharmonize v1.3.0
This release introduces YTLive, a brand-new YouTube and YouTube Music experience for discovery, playback, playlist browsing, and queue management.

It also adds configurable frontend selection, new YouTube Music APIs, queue monitoring, and expanded localization support.

What Does It Add?
Nothing important.

I merely replaced "one page" with "another page".

New YTLive Interface
Added the new YTLive interface for YouTube and YouTube Music
Search YouTube videos, tracks, albums, playlists, and artists from a dedicated music-focused UI
Browse YouTube Music home recommendations and discovery shelves
Preview playlists and queue tracks directly from the interface
Integrated playback, queue management, and workflow controls
Added a dedicated standalone YTLive page
YouTube Music Discovery
Added YouTube discovery endpoints under /api/youtube
Added YouTube search endpoints for YTLive
Added YouTube Music Home shelf support
Improved playlist expansion and metadata normalization
Added cookie-aware YouTube Music browsing support
Enhanced regional market handling for music discovery
Configurable Frontend Selection
Added a new FRONTEND_UI setting
Allows selecting either the classic Gharmonize interface or YTLive as the default application frontend
Added /api/ui-config endpoint for frontend configuration
Added YTLive launch shortcuts from the classic interface
YTLive Settings & Queue Management
Added YOUTUBE_QUICK_ADD_LIMIT configuration
Added YTLive-specific settings controls
Added /api/queue/status endpoint for queue monitoring
Improved active job tracking and workflow visibility
Added cross-tab and session synchronization for job state updates
User Interface Improvements
Added dedicated YTLive styling and responsive layouts
Added music-focused playback controls
Added queue and playlist browsing panels
Added recommendation shelf presentation
Improved navigation between classic UI and YTLive
Documentation & Configuration
Updated README with YTLive documentation
Documented frontend selection options
Documented YTLive routing and usage
Added new environment configuration examples
Added YOUTUBE_QUICK_ADD_LIMIT and related defaults


Gharmonize v1.2.8
This release focuses on major Spotify playlist matching improvements, smarter playlist resolution, and configurable desktop shell integration for the Track Extractor.

Spotify Playlist Matching Improvements
Improved Spotify playlist matching reliability by prioritizing the paged Spotify Web API and Pathfinder playlist resolution over public embed data
Fixed cases where playlist processing could stop around 99 tracks when relying on Spotify embed metadata
Added a Pathfinder fallback for playlists that are visible on Spotify Web but return 403 Forbidden responses from the official Spotify Web API
Prevented matching jobs from becoming stuck when Spotify returns empty item lists
Reduced duplicate integrated matching log messages during Server-Sent Events (SSE) updates
Pathfinder Improvements
Pathfinder playlist resolution now works without requiring:

SPOTIFY_CLIENT_ID
SPOTIFY_CLIENT_SECRET
This allows Gharmonize to resolve and download Spotify-managed playlists that are often inaccessible through the standard Spotify Web API, including:

Discover Weekly
Release Radar
Other Spotify-curated and personalized playlists
Configurable Track Extractor Shell Integration
Added a new TRACK_EXTRACTOR_SHELL_INTEGRATION setting
Allows users to enable or disable the Gharmonize Track Extractor context menu integration
Setting is persisted through the settings API and enabled by default
Shell integration is automatically re-applied whenever settings are saved
Windows registry entries are added or removed automatically based on the configured state
Linux desktop integration is also managed automatically
Shell integration initialization now occurs after packaged application environment setup
Added localized descriptions for shell integration settings
Desktop Integration Improvements
Improved management of Track Extractor desktop shortcuts and context menu registration
More predictable behavior when enabling or disabling shell integration across supported platforms
Cleaner initialization flow for packaged desktop environments
Note
Spotify playlist matching is now significantly more reliable for large playlists and Spotify-managed playlists that may not be fully accessible through the official Spotify API.

Users who previously needed Spotify API credentials for certain playlist types may no longer require them when Pathfinder resolution is available.


Gharmonize v1.2.7
This release introduces a new desktop Track Extractor workflow, expanded media extraction capabilities, and deeper desktop integration for advanced MKV and media processing tasks.

Track Extractor
Added a dedicated desktop Track Extractor workflow for video files

Added Electron shell integration for opening supported video files directly in the Track Extractor

Added track probing and extraction APIs with desktop bridge token protection

Added extraction support for:

Video tracks
Audio tracks
Subtitle tracks
Image attachments
Chapters
Runtime & Binary Management Improvements
Runtime binary initialization is now awaited before most API requests
Managed cached binaries can now be resolved before falling back to system PATH
Docker binary cache location updated to:
/opt/gharmonize/cache/binaries
yt-dlp Improvements
Cookie files are now copied to temporary snapshots before yt-dlp execution
Prevents accidental modification of original cookie files during downloads


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
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
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 completedAt instead 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

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


Gharmonize v1.2.2

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.


Gharmonize v1.2.1

This release focuses on improving longterm 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.


Gharmonize v1.2.0

New Features
Added support for:

X (Twitter)
Facebook
Instagram
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
Facebook
Instagram
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


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=1 is 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.
Added environment variable checks to ensure predictable and configurable behavior.

Refactored
Server Initialization & Error Handling
Improved server startup flow for better stability.
Converted PORT handling to a strict numeric value.
Updated and clarified server error messages for easier debugging and maintenance.


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.


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 nonHDR 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 HDRcompatible video streams
Great for HDR TVs, projectors, and premium displays


Gharmonize v1.0.8

Gharmonize v1.0.8 – Release: Video Processing Improvements
Advanced Video Processing & Transcoding Controls
Modal-based conversion panel

Keeps the interface clean while grouping all conversion tools in one place
Expanded codec & quality options

Gives you finer control over output quality and file size
Future-ready transcoding flow

New architecture prepared for upcoming advanced features
Orientation controls

Automatically or manually rotate videos to the correct direction
Resize modes

Choose how your video should scale (fit, fill, original, etc.)
Advanced cropping tools

Precisely trim edges using left/right/top/bottom controls
Custom borders

Add borders with adjustable size and color for a polished look


Gharmonize v1.0.7

Gharmonize v1.0.7 – Release Highlights
Compression & Encoding
Allow enabling or disabling post-job compression via the UI
Make HEVC encoding selectable
Performance & Platform Optimizations
Optimize the application for Windows
Enable faster downloads by moving metadata fetching to the background
AppImage & EXE Enhancements
Add auto-start on system login (AppImage & EXE)
Support starting the app in the background
Allow the app to keep running in the background
YouTube Improvements
Improve YouTube matching logic
Add configurable concurrency for YouTube downloads and conversions
Enable cookie usage for age-restricted or special content (requires Deno)
Add normalization functions for artist and title matching
Spotify Improvements
Refactor Spotify download and processing logic
Improve Spotify matching, downloads, and conversion
Add a concurrency input field for Spotify downloads/conversions
Add protection settings against rate limits and platform restrictions
UI & UX Improvements
Improve the Jobs panel
Add descriptions for environment variables in the settings panel
Cookie Usage Notes
Cookie support improves YouTube–Gharmonize matching accuracy and allows downloading age-restricted or similar content.

Docker users: Only cookies.txt is supported.

Windows users:

Chrome cannot provide cookies while the browser is running due to platform limitations.
Sign in to YouTube using Firefox or another supported browser, then configure cookie access accordingly.
Set the YTDLP_COOKIES_FROM_BROWSER environment variable via the environment configuration or the settings panel.
Outside of Docker (and when correctly configured on Windows as described above), a cookies.txt file is not required.


Gharmonize v1.0.6

New in This Version
A polished and featurepacked update focused on workflow reliability, audio quality, job persistence, and UI clarity.

Improved Media Handling & Conversion
Refined file upload flow for smoother user experience.
Enhanced media selection logic for both uploaded and locally chosen files.
Added selective audiotrack conversion when media contains multiple audio streams.
More robust handling of inconsistent file metadata.
Job System Enhancements
Persistent Job Tracking
Active jobs now reappear correctly even after a full page refresh.
Completed jobs remain visible in both the Active Jobs list and Jobs Panel until the corresponding output files are deleted.
Improved sync between backend job state and UI display.
Updated Completed & Ongoing Jobs Logic
More accurate joblifecycle reporting.
Reduced flickering or disappearing entries during rapid state changes.
Audio Output Improvements
Added VolumeGain processing, allowing output audio tracks to be normalized or amplified.
Clearer loudness results across MP3, AAC, M4A, and other supported formats.
UI & Usability Upgrades
Jobs Panel Overhaul
Cleaned and reorganized layout.
Improved readability for multitrack conversions.
More consistent progress bars, ETA, and state indicators.
Active Jobs View
Improved spacing and hierarchy.
More consistent interaction between panel view and main page view.
Update Tracking Module
Added builtin version checker.
Displays latest release version and release link.
Integrates with the Jobs Panel for update awareness.
Console Improvements
Console messages rewritten for clearer, more consistent, and more developerfriendly output.
Better grouping and color usage for errors, warnings, and process logs.
Additional Internal Improvements
Small refactors across the UI logic for stability.
Smoother staterestoration on reload.
Better handling of SSE & backend communication.


Gharmonize v1.0.5

Improved MP4 Conversion & Added MKV Support
MP4 conversion has been enhanced for both server-side processing and local media file selections.
MKV is now available as an optional output format, selectable directly from the UI.
Users can now choose audio and subtitle tracks before starting the conversion process.
Integrated ThirdParty Binaries
Gharmonize now bundles its essential thirdparty tools internally:

ffmpeg, ffprobe, mkvmerge, and yt-dlp are now shipped inside the application.
No need to install them system-wide or provide manual directory paths.
Windows users no longer need to set environment variables for ffmpeg or yt-dlp — the built-in versions are used automatically.
New Rip Module (Experimental)
An experimental rip module has been added.
Allows exporting nonDRM discs to MKV format.
Default output directory: local-inputs
Designed as a lightweight and easy ripping solution.



Gharmonize v1.0.4

New Features
Sequential Task Processing System
All added jobs are now executed in order, ensuring predictable processing even when you queue tasks with different configurations.

Environment Selection from local-inputs (Admin Only)
A new option lets you select media directly from the local-inputs folder, allowing conversion without uploading large files through the UI.

MultiFile Selection Support
The upload system now supports multifile selection, making bulk operations smoother and faster.

General Improvements
UI & Usability Improvements
General interface polish and userexperience enhancements across the platform.


Gharmonize v1.0.3

Audio Codec Improvements
AAC codec support added for improved compatibility across devices.
Enhanced FLAC and WAV pipelines for better stability and audio precision.
FPS adaptation now includes AAC for more reliable A/V sync.
FLAC & WAV Enhancements
More accurate control over:

Compression level
Bit depth
Output quality
MP4 Handling Changes
Some MP4related environment variables were removed.

This may affect downloads of agerestricted or regionlocked videos.
If required, you may need to provide cookies (browser extension recommended).
MP4 codec upgrades:

Supports resolutions up to 2160p.

Two modes available:

Transcode using your selected encoder
Download asis (no reencoding)
If the requested quality is unavailable, the closest match is automatically selected.

GPU Acceleration
Added hardwareaccelerated transcoding for:

NVIDIA NVENC
Intel QuickSync
VAAPI
Note: In Docker, VAAPI and Intel QuickSync are disabled by default.

When NVENC is enabled, all hardwareacceleration requests are routed to NVENC.

See the README section on enabling NVENC in Docker for full configuration instructions.

Upload System Update
Maximum upload size is now controlled via an environment variable.
The value can be changed directly from the Settings Panel.
Docker – NVENC Setup (Quick Note)
Before enabling NVENC in Docker:

Make sure your host has NVIDIA GPU drivers + the NVIDIA Container Toolkit.
Enable NVENC following the instructions in the README.
Once active, the system automatically prefers NVENC.


Gharmonize v1.0.2

New
Added FPS adaptation support for AC3 and EAC3 codecs.
Now, audio encoded with AC3/EAC3 can seamlessly adjust playback speed to match different frame rates (e.g., PAL NTSC), ensuring perfect audio-video sync and smooth playback across regions.

Improvements
Enhanced UI fallback behavior for smoother user experience and better resilience in edge cases.
Counters now display more accurate results and update dynamically for both downloaded and converted media.


Gharmonize v1.0.1

New Features
Windows support added!

You can download it directly below.
Or, follow the instructions in the README section to build it yourself.
General Improvements
Overall performance and stability enhancements.
Minor UI adjustments and bug fixes.


Gharmonize v1.0.0

Gharmonize is now officially released as a stable version.
This build includes all core features described in the [README], focused on reliability, clarity, and performance.

Highlights
Full support for YouTube / YouTube Music (single, playlist, automix)
Spotify integration for tracks, playlists, and albums
Conversion to mp3 / flac / wav / ogg / mp4
Embedded metadata & album art support
Simple web UI and JSON API
Ready-to-use Docker Compose setup
Tech Stack
Node.js + ffmpeg + yt-dlp + Express + Docker

Stability Notes
This is a stable and feature-complete build intended for general use.
Further releases will focus on UI refinement, parallel task improvements, and optional advanced settings.