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=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.

---

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

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 🖼️

---

Full Changelog: v1.0.7...v1.0.8

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.

Full Changelog: v1.0.6...v1.0.7

Gharmonize v1.0.6

Gharmonize v1.0.6 — Release Notes

🚀 New in This Version

A polished and feature‑packed 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 audio‑track 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 job‑lifecycle 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 multi‑track 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 built‑in 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 developer‑friendly output.
• Better grouping and color usage for errors, warnings, and process logs.

---

🧹 Additional Internal Improvements

• Small refactors across the UI logic for stability.
• Smoother state‑restoration on reload.
• Better handling of SSE & backend communication.

---

Full Changelog: v1.0.5...v1.0.6

Gharmonize v1.0.5

🚀 Gharmonize v1.0.5 – Release Notes

🎬 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 Third‑Party Binaries

Gharmonize now bundles its essential third‑party 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 non‑DRM discs to MKV format.
• Default output directory: local-inputs
• Designed as a lightweight and easy ripping solution.

---

If you encounter issues or have suggestions, feel free to open an issue on the GitHub repo.

Full Changelog: v1.0.4...v1.0.5

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.

• 📂 Multi‑File Selection Support

The upload system now supports multi‑file selection, making bulk operations smoother and faster.

---

⚙️ General Improvements

• 🎨 UI & Usability Improvements

General interface polish and user‑experience enhancements across the platform.

---

Full Changelog: v1.0.3...v1.0.4

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 MP4‑related environment variables were removed.

  • This may affect downloads of age‑restricted or region‑locked 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 as‑is (no re‑encoding)

  • If the requested quality is unavailable, the closest match is automatically selected.

---

🖥️ GPU Acceleration

• Added hardware‑accelerated transcoding for:

  • 🟩 NVIDIA NVENC
  • 🟦 Intel QuickSync
  • 🟥 VAAPI

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

When NVENC is enabled, all hardware‑acceleration 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.

---

Full Changelog: v1.0.2...v1.0.3

Gharmonize v1.0.2

🚀 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.

Full Changelog: v1.0.1...v1.0.2