1# Changelog
2
3All notable changes to this project will be documented in this file.
4
5## [Unreleased]
6
7## [0.6.0] - 2025-09-12
8
9### Added
10- **Smart AV1 codec negotiation system for YouTube high-resolution streaming**:
11  - **Resolution-aware MediaCapabilities API reporting**: Intelligent codec capability reporting based on video resolution, enabling YouTube to select optimal codecs for different quality levels
12  - **YouTube format manifest manipulation**: Real-time format list reordering to prioritize AV1 for ≤1080p content while allowing VP9 fallback for higher resolutions
13  - **Graduated codec preference system**: Smart localStorage preference (`2048`) instead of forced AV1 (`8192`), giving YouTube flexibility for optimal codec selection
14  - **4K HDR 60fps AV1 support**: Successfully enables YouTube delivery of premium quality 4K HDR content with AV1 codec, HDR10 (PQ) color space, and BT.2020 wide color gamut
15  - **Configurable AV1 resolution limits**: New `av1_max_resolution` config option with environment variable support (`DUMBER_AV1_MAX_RES`)
16  - **Automatic codec fallback logic**: Seamless VP9 fallback for resolutions where AV1 performance may be suboptimal
17  - **High bitrate streaming support**: Enables premium quality streaming (650+ Mbps) with proper buffer management
18  - Fixes previous limitation where forcing AV1 would cap YouTube playback at 1080p maximum
19- Page refresh functionality with standard keyboard shortcuts:
20  - **Ctrl+R** / **Cmd+R**: Reload current page
21  - **Ctrl+Shift+R** / **Cmd+Shift+R**: Hard reload (bypass cache)
22  - **F5**: Alternative reload key
23  - WebKit integration with proper `webkit_web_view_reload()` and `webkit_web_view_reload_bypass_cache()` calls
24- **Twitch theater mode and fullscreen stability fix**:
25  - **Complete removal of codec interference on Twitch**: Eliminates aggressive codec control that caused theater mode and fullscreen freezing
26  - **Native Twitch codec selection**: Allows Twitch to handle codec negotiation without browser intervention
27  - Fixes theater mode freeze and fullscreen black screen issues on Twitch
28
29### Fixed
30- Zoom level toast no longer shows on every page navigation within the same domain:
31  - Added smart detection to differentiate user-initiated vs programmatic zoom changes
32  - Toast now only appears when manually adjusting zoom or entering a new domain
33  - Prevents annoying notifications during regular browsing within the same site
34- Links with `target="_blank"` now load in current window instead of being ignored:
35  - Added WebKit `create` signal handler to intercept new window requests
36  - Redirects popup/new tab links to current window for seamless single-window browsing
37  - Maintains user experience consistency in tab-less browser architecture
38
39## [0.5.0] - 2025-09-12
40
41### Added
42- Hardware video acceleration with automatic GPU detection:
43  - Multi-vendor GPU detection (AMD, NVIDIA, Intel) using glxinfo, lspci, and sysfs
44  - Automatic VA-API driver selection (radeonsi for AMD, vdpau for NVIDIA, iHD for Intel)
45  - WebKitGTK integration with GStreamer hardware acceleration backends
46  - Environment variable configuration support (LIBVA_DRIVER_NAME, GST_VAAPI_ALL_DRIVERS)
47  - Legacy VA-API fallback mode for compatibility with older systems
48  - Video decoding acceleration for H.264, HEVC, VP9, and AV1 codecs
49  - Significantly reduced CPU usage during video streaming (Twitch, YouTube, etc.)
50  - Smart conflict prevention between legacy and modern VA-API implementations
51- TLS certificate error handling with user confirmation dialog:
52  - Comprehensive certificate information display (subject, issuer, validity dates)
53  - Interactive warning dialog for untrusted certificate authorities
54  - Certificate exception management with per-host persistence
55  - Manual load triggering after user accepts certificate exceptions
56  - Proper integration with WebKitGTK 6.0 network session API
57- Zoom level toast notifications:
58  - Real-time zoom level display with format: "Zoom level: ±X% (Y%)"
59  - Smart debouncing to prevent notification spam during rapid zoom changes
60  - Automatic cleanup of stuck or colliding toast messages
61  - 150ms debounce timer with 2-second display duration
62  - Emergency cleanup function for orphaned toast elements
63- Comprehensive XDG-compliant logging system:
64  - Complete application output capture (Go logs, fmt prints, WebKit C logs)
65  - XDG Base Directory specification compliance (`~/.local/state/dumber/logs/`)
66  - Automatic log rotation with size/age-based cleanup and compression
67  - WebKit CGO log capture with GLib log handler integration
68  - CLI log management commands (`dumber logs list`, `logs tail`, `logs clean`)
69  - File-only logging for cache operations to prevent dmenu interference
70  - Multi-output support with timestamped, tagged log entries
71  - Configurable log levels, formats (text/JSON), and retention policies
72
73### Fixed
74- WebView background set to black to improve user experience during page loads
75- Multiple linting issues and code quality improvements (reduced from 211 to ~150 issues)
76- Omnibox responsive scaling and layout issues:
77  - Fixed over-aggressive viewport scaling that made omnibox disproportionately large at high zoom levels
78  - Resolved input field overflow extending beyond container boundaries
79  - Improved box-sizing model to prevent layout issues
80  - Added conditional separator display (hidden when no search results)
81  - Omnibox now scales proportionally with webpage content across all zoom levels
82- Dmenu history favicon display:
83  - Complete favicon caching system for fuzzel/dmenu integration with real website icons
84  - ICO file support using go-ico library for perfect Windows icon conversion to PNG
85  - Smart brightness detection and color inversion for dark theme visibility
86  - All cached favicons normalized to consistent 32x32 PNG format for uniform display
87  - Anti-aliasing preservation during color inversion to prevent edge noise and pixelation
88  - Asynchronous favicon downloading and caching with 7-day freshness and 30-day cleanup
89  - Fuzzel icon protocol integration (`\0icon\x1f<path>`) for native icon display
90  - Favicon URLs extracted from webpage metadata and stored in database during navigation
91  - Fallback system removed to ensure consistent sizing - shows real favicons or no icon
92  - XDG Base Directory compliance for favicon cache storage
93
94## [0.4.0] - 2025-09-10
95
96### Added
97- High-performance fuzzy cache system for dmenu history:
98  - Binary serialization with memory-mapped files for zero-copy access
99  - Trigram indexing (3-character sequences) for fast candidate filtering  
100  - Prefix trie (compressed tree structure) for prefix matching
101  - Pre-sorted entry indices for O(1) top entries retrieval
102  - Smart cache invalidation with filesystem persistence and background refresh
103  - Comprehensive fuzzy matching algorithms: Jaro-Winkler similarity, Levenshtein distance, tokenized matching
104  - Weighted scoring system combining URL, title, recency, and visit count scores
105  - XDG Base Directory Specification compliance (cache stored in state directory)
106  - Atomic operations for concurrent access control
107  - Dependency injection using interfaces and gomock for testing
108- Purge command for cleaning up dumber data and cache files:
109  - Selective purging with flags: `--database`, `--history-cache`, `--browser-cache`, `--browser-data`, `--state`, `--config`
110  - Clear distinction between history cache (dmenu fuzzy search) and browser cache (WebKit)
111  - Browser data includes cookies, localStorage, sessionStorage
112  - Confirmation prompt with `--force` flag to skip
113  - Targets all data locations: SQLite database, WebKit cache/data, dmenu fuzzy cache, configuration files
114- Ctrl+Shift+C keyboard shortcut to copy current URL to clipboard:
115  - Cross-platform clipboard support with wl-copy (Wayland) and xclip (X11) fallback
116  - Reusable toast notification system for user feedback
117  - Injectable JavaScript component for consistent styling across all websites
118  - Native backend integration for reliable clipboard access
119
120### Changed
121- Dmenu performance dramatically improved: 200ms → 4ms (98% faster)
122- GetTopEntries optimized from O(n log n) to O(1) using pre-sorted indices
123- Cache build time reduced to ~300μs for typical history datasets
124
125### Fixed
126- Dark theme detection now properly reads GNOME desktop interface color-scheme setting (`org.gnome.desktop.interface color-scheme`) instead of only checking `gtk-application-prefer-dark-theme`
127- Eliminated O(n log n) sorting bottleneck on every dmenu call
128- Memory-efficient compact entry storage with minimal footprint
129- Concurrent cache access with proper read/write locking
130- Process no longer hangs when closing window with Cmd+Q or window close button - implemented proper GTK4 `close-request` signal handling and OS signal handling for graceful shutdown
131
132## [0.3.0] - 2025-01-11
133
134### Added
135- WebKit memory controls (opt‑in):
136  - Env vars to tune memory/perf trade‑offs without code changes:
137    - `DUMBER_CACHE_MODEL`, `DUMBER_ENABLE_PAGE_CACHE`
138    - `DUMBER_ENABLE_MEMORY_MONITORING`, `DUMBER_MEMORY_LIMIT_MB`, `DUMBER_MEMORY_POLL_INTERVAL`
139    - `DUMBER_MEMORY_CONSERVATIVE`, `DUMBER_MEMORY_STRICT`, `DUMBER_MEMORY_KILL`
140    - `DUMBER_GC_INTERVAL`, `DUMBER_RECYCLE_THRESHOLD`
141  - Version‑guarded CGO wrappers for memory pressure and GC hooks; safe no‑ops on unsupported WebKitGTK builds.
142 - Find in page (Ctrl/Cmd+F):
143   - Omnibox refactored into a reusable component with dedicated "find" mode.
144   - Highlighting: yellow for all matches; active match in orange for clarity.
145   - Match list with context (right side stops at nearest punctuation: . , ; : -).
146   - Navigation UX:
147     - ArrowUp/Down move selection and scroll the overlay list (page scroll disabled while open).
148     - Enter centers on the active match and closes; Shift+Enter goes to previous; Alt+Enter centers without closing.
149     - Hover focuses input and selects list items; click outside closes the overlay.
150     - Faded overlay with subtle blur when reviewing matches; opacity restores on input focus/typing.
151   - Programmatic API: `OpenFind(initial)`, `FindQuery(q)`, `CloseFind()` on `WebView`.
152
153### Changed
154- Performance‑first defaults retained:
155  - Cache model set to “WebBrowser”, page cache enabled, DevTools available.
156  - No implicit memory pressure or GC enabled by default; all memory tuning is opt‑in.
157
158### Removed
159- Deprecated offline app‑cache calls eliminated (no‑ops) to avoid warnings and brittle builds.
160
161### Fixed
162- Homepage Recent History layout:
163  - Show single-line entries as “{Title} – {Domain} – {URL}”.
164  - Truncate long URLs with a gradient fade; prevent horizontal overflow.
165  - Adjusted styling so URL is darker for readability.
166- Search shortcuts and config interop:
167  - Backend SearchShortcut now serializes `url`/`description` with JSON tags.
168  - Frontend normalizes field casing and extracts base URLs, handling `%s` and `{query}` templates.
169  - Omnibox shortcut parsing now URL-encodes queries and supports `%s` placeholders.
170- Input and navigation reliability (GTK4/WebKitGTK 6):
171  - Capture-phase key controller to ensure accelerators fire consistently.
172  - Do not consume normal left/right clicks; only mouse buttons 8/9 trigger back/forward.
173  - Added Alt+ArrowLeft/Right navigation and enabled two-finger swipe back/forward when supported.
174  - Added Ctrl+scroll zoom in/out; refined accelerator matching so Ctrl− works across layouts.
175  - Removed layout-specific hacks; added diagnostic logs for raw minus key events.
176- Zoom persistence:
177  - Added WebView zoom-changed hook; save per-domain zoom to SQLite on every change.
178  - Log on successful save: “saved X.XX for domain.tld” and on load: “loaded X.XX for domain.tld”.
179  - Load and log initial zoom level on startup and on every navigation.
180- Build/dev ergonomics:
181  - Makefile loads `.env.local`; supports overriding `GOMODCACHE`, `GOCACHE`, `GOTMPDIR` for sandboxed builds.
182 - WebKit CGO hardening and API compatibility:
183   - Apply memory pressure settings to `WebKitNetworkSession` (correct signature) when enabled.
184   - Guarded C wrappers remove deprecation warnings across header variants; builds succeed on WebKitGTK 6.
185
186## [0.2.0] - 2025-09-10
187
188### Added
189- WebKitGTK 6 (GTK4) migration for the built‑in browser window:
190  - WebView constructed via `g_object_new(WEBKIT_TYPE_WEB_VIEW, …)` with a fresh `WebKitUserContentManager`.
191  - `WebKitNetworkSession` with persistent cookies (SQLite) and cache directories.
192- Native UCM messaging restored via `script-message-received::dumber` (JSCValue*), removing the JS fallback bridge.
193- Rendering mode controls:
194  - CLI flag `--rendering-mode=auto|gpu|cpu` and `DUMBER_RENDERING_MODE` env.
195  - In‑app status endpoint `dumb://homepage/api/rendering/status`.
196- Native zoom shortcuts at the WebKit layer (Ctrl/Cmd+=, +, −, 0) and GTK4 input controllers for keyboard/mouse.
197- AZERTY keyboard fix: treat underscore as minus for zoom‑out.
198- Runtime theme synchronization: watch GTK `gtk-application-prefer-dark-theme` and update page color‑scheme live.
199- Makefile target `check-webkit` to print `pkg-config` versions of GTK4/WebKitGTK 6.0/JSC 6.0.
200- Documentation updates:
201  - README now targets WebKitGTK 6 (GTK4) and lists GStreamer package requirements for Arch and Debian/Ubuntu.
202  - CLAUDE notes updated with migration status, GPU/Vulkan path, runtime theme sync, and persistence.
203
204### Changed
205- Build flags and includes now target `webkitgtk-6.0`, `gtk4`, and `javascriptcoregtk-6.0`.
206- GTK4 APIs for windowing and event handling (GtkEventController, GtkGestureClick) replace GTK3/GdkEvent paths.
207
208### Removed
209- Legacy WebKit2GTK constructors and container APIs.
210- JavaScript fallback for UCM message bridging.
211
212### Fixed
213- Header/enum compatibility for hardware acceleration policy and cookie policy across WebKit header variants.
214- Linker error for `on_theme_changed` and gpointer usage in signal connections.
215- Crashy paths mitigated by default “media safe” startup (can be disabled via `DUMBER_MEDIA_SAFE=0`).
216
217### Notes
218- GPU rendering path leverages GTK4’s renderer (Vulkan/OpenGL). Mode `auto` uses GPU when available and falls back gracefully to CPU.
219- WebKitGTK relies on GStreamer; install recommended packages for audio/video (see README).
220
221## [0.1.0] - 2025-09-09
222
223### Added
224- Initial project scaffolding, build system, and dependencies.
225- Unified CLI + GUI architecture with search shortcuts and fuzzy parsing.
226- Wails v3‑alpha browser integration (early phase).
227- Global keyboard controls with script injection (zoom/devtools, etc.).
228- Native WebKit2GTK backend migration:
229  - Custom `dumb://` scheme and `/api` endpoints: `/config`, `/history/recent`, `/history/search`, `/history/stats`.
230  - UserContentManager omnibox injection and theme initialization.
231  - Persistent WebsiteDataManager with cookies.sqlite; per‑domain zoom and title persistence.
232  - Keyboard/mouse accelerators (including mouse back/forward); debounced triggers.
233  - Homepage switched to first‑party API fetches; removed @wailsio/runtime usage.
234- Documentation and licensing: README enhancements and LICENSE added.
235
236### Changed
237- Replaced Wails runtime with native WebKit2GTK CGO bindings and homepage API.
238- Improved asset resolution and logging for the `dumb://homepage` scheme.
239
240### Fixed
241- Eliminated duplicate accelerator triggers via debouncing.
242- Corrected asset resolution and URL normalization in scheme handler.