Release 1.2.2

Split into per-browser builds with official Firefox support.

What's New · Novidades

Official Firefox Support
Dedicated Firefox build with event-page background (background.scripts) and browser_specific_settings.gecko for AMO compatibility — same audio engine, same UI, agora também no Firefox.

Per-browser builds
The extension now ships as two self-contained folders — chrome/ and firefox/. Each zip below is a complete drop-in extension.

Landing Page
Added a Visitors counter on the landing page footer.

---

Install · Instalação

Chrome · Chromium · Edge · Brave

1. Baixe k-room-v1.2.2-chrome.zip e extraia
2. Acesse chrome://extensions/ e ative o Developer mode
3. Clique em Load unpacked e selecione a pasta extraída

Firefox

1. Baixe k-room-v1.2.2-firefox.zip e extraia
2. Acesse about:debugging#/runtime/this-firefox
3. Clique em Load Temporary Add-on e selecione o manifest.json da pasta extraída

Add-ons temporários no Firefox são removidos ao reiniciar. Instalação permanente requer assinatura via AMO.

---

Full changelog: log.txt tem o histórico completo bilíngue.

Release 1.2.1: Audio Fixes

AUDIO ENGINE — Stability & Dynamics
───────────────────────────────────
• Asymmetric EMA Logic.
Implemented separate attack (250ms) and release (5000ms) time constants
for loudness tracking. The engine now reacts instantly to loud drops
while preventing excessive volume boosts during quiet sections.

• Crest Factor Awareness.
Added dynamic target adjustment based on the song's dynamic range.
High-dynamic tracks now get more headroom automatically to prevent
clipping during peaks.

• Headroom & Safety.
Reduced Peak Limiter Trust (8dB → 3dB) and slowed down peak envelope
decay (2s) to ensure a more conservative and safer gain ceiling.

• Critical Logic Fix.
Removed a duplicate/broken scan implementation that was overriding the
stable logic and breaking Progressive Mode refinement.

• Preset Overhaul.
Raised compressor thresholds and lowered ratios across all presets to
prevent constant squashing and preserve the "punch" and energy of
the music.

TRACK DETECTION — Sync & Reliability
────────────────────────────────────
• Immediate Detection.
Added mediaSession and loadedmetadata listeners. Song changes are now
detected instantly rather than waiting for URL polling.

• State Reset.
Implemented resetForTrackChange() to clear EMA and peak history when
a new song starts, preventing volume "bleeding" between tracks.

• Time Sync Fix.
Added readiness checks to prevent "merged time" or incorrect duration
displays during rapid track transitions.

Release 1.2.0

FEATURES & UI — New Additions
─────────────────────────────
• Implemented Progressive Mode.
Intelligent scanning and locking of the ideal volume levels. Perfect for
scenarios where real-time adjustment isn't desired.

• Added EQ Graph System.
Visual representation and manual control of the 5-band equalizer for
surgical precision.

• Added Media Controls.
Native browser media keys support for play/pause, next, and previous track.

• Bass Perceptual Compensation.
Improved bass clarity at lower volumes using psychoacoustic modeling to
compensate for the Fletcher-Munson curve.

• New Visual Identity.
Complete logo overhaul and general theme shift from red to a premium
White/Silver "Moon" aesthetic.

• Landing Page Prototype.
Initial release of the professional, minimalist product landing page.

• Firefox Support (Work in Progress).
Underlying architecture adjustments to support Manifest v2/v3 compatibility
for the Firefox version.

BUG FIXES
─────────
• Fixed Volume Jumping.
Refined EMA (loudness average) logic to eliminate sudden jumps between
tracks with different masters.

Release 1.1.0

K-ROOM YT Music Control - v1.1.0

This release brings major stability improvements to the Audio Engine and a complete visual overhaul to the project's landing page!

Audio Engine

• Critical Fixes: Fixed an issue where the extension would randomly stop and drop audio playback. An intelligent auto-reconnection system is now in place.
• Smoother Transitions: Eliminated micro-glitches from the UI sliders and abrupt volume jumps between tracks. Fades and auto-gain now transition much more naturally.
• Faster Response: Core engine response time reduced from 1500ms to 800ms.

UI & Landing Page

• New Dark Mode Design: The main landing page (index.html) has been completely redesigned with a modern dark aesthetic and polished animations.
• Fully Bilingual: Added complete i18n support with instant toggling between English and Portuguese.
• Interactive Web Demo: You can now test a pixel-accurate interactive replica of the extension directly from the landing page by clicking "Take a Look" (no installation required!).

Release 1.0.1

🎧 K-ROOM - YouTube Music Volume Control

A extensão essencial para equilibrar o volume das suas músicas no YouTube Music, sem perda de qualidade e com zero distorção!

✨ Principais Recursos

• Compressor & Limiter Integrado: Motor de áudio em tempo real que controla a dinâmica da faixa para evitar clipping e nivelar o volume.
• Equalizador de Ganho Automático: Acaba com a variação brutal de volume entre músicas de álbuns e épocas diferentes.
• Filtro Passa-Alta (Highpass): Remove frequências sub-graves indesejadas (abaixo de 30 Hz) que causam ruídos e distorções.

🎛️ Presets Recomendados

• 🧠 Smart Mode: Ajuste dinâmico adaptativo em tempo real para qualquer tipo de faixa.
• 🌙 Night Mode: Aumenta as partes baixas e contém os picos. Perfeito para escutar música ou podcasts de madrugada sem tomar sustos.
• 🍃 Gentle: Preserva a dinâmica original da música aplicando um nivelamento muito sutil.
• 🔥 Strong: Nivelamento firme e agressivo, ideal para playlists muito misturadas ou ambientes barulhentos.

💅 Design & Experiência

• Nova Landing Page: Design premium atualizado no estilo "Dark Glass", totalmente alinhado à identidade visual nativa do YouTube Music.
• Internacionalização: Suporte completo para Inglês e Português.

---

📦 Como instalar (Modo Desenvolvedor)

1. Faça o download do arquivo k-room-extension.zip logo abaixo.
2. Extraia o arquivo em uma pasta no seu computador.
3. No seu navegador, acesse chrome://extensions/ (ou a página de extensões do seu browser).
4. Ative o Modo do Desenvolvedor no canto superior direito.
5. Clique em Carregar sem compactação (Load unpacked) e selecione a pasta que você acabou de extrair.
6. Pronto! Acesse o YouTube Music e aproveite.