Help us keep the list up to date and submit new video software here.
Tool
Complete Version history / Release notes / Changelog / What's New for Gharmonize
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.
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)
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
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.