-
v0.1.7 Stable
pax released this
2026-04-05 22:56:09 +00:00 | 458 commits to main since this releaseChanges since v0.1.5
Infinite Scroll
- New mode — toggle in Settings > General, applies live
- Auto-loads more posts when scrolling to bottom
- Staggered loading — posts appear one at a time as thumbnails arrive
- Stops at end — gracefully handles API exhaustion
- Arrow keys at bottom don't break the grid
- Loading locked during drain to prevent multi-page burst
- Triggered one row from bottom for seamless experience
Page Cache & Deduplication
- Page results cached in memory — prev/next loads instantly
- Backfilled posts don't repeat on subsequent pages
- Page label updates on cached loads
Prefetch
- Ring expansion — prefetches in all 8 directions (including diagonals)
- Auto-start on search — begins from top of page immediately
- Re-centers on click — restarts spiral from clicked post
- Triggers on infinite scroll — new appended posts prefetch automatically
Clipboard
- Copy File to Clipboard — works in grid, preview, bookmarks, and library
- Ctrl+C shortcut — global shortcut via QShortcut
- QMimeData — uses same mechanism as drag-and-drop for universal compatibility
- Sets both file URL (for file managers) and image data (for Discord/image apps)
- Videos copy as file URIs
Slideshow
- Blacklist Tag button — opens categorized tag menu
- Blacklist Post button — blacklists current post
Blacklist
- In-place removal — blacklisting removes matching posts from grid without re-searching
- Preserves infinite scroll state
- Only clears preview when the blacklisted post is the one being viewed
UI Polish
- QProxyStyle dark arrows — spinbox/combobox arrows visible on all dark QSS themes
- Diagonal nav fix — column count reads viewport width correctly
- Status bar — shows result count with action confirmations
- Live settings — infinite scroll, library dir, thumbnail size apply without restart
Stability
- All silent exceptions logged
- Missing defaults added for fresh installs
- Git history cleaned
Download
booru-viewer.exe— Windows standalone (requires VP9 Video Extensions for WebM playback)Downloads
-
v0.1.6 Stable
2026-04-05 20:40:16 +00:00 | 478 commits to main since this releaseChanges since v0.1.5
Infinite Scroll
- New mode — toggle in Settings > General: "Infinite scroll (replaces page buttons)"
- Hides prev/next buttons, auto-loads more posts when scrolling to bottom
- Posts appended to grid, deduped, blacklist filtered
- Stops gracefully when API runs out of results (shows "end")
- Arrow keys at bottom don't nuke the grid — page turn disabled in infinite scroll
- Applies live — no restart needed
Page Cache & Deduplication
- Page results cached — prev/next loads instantly from memory within a search session
- Post deduplication — backfilled posts don't repeat on subsequent pages
- Page label updates on cached page loads
Prefetch
- Ring expansion — prefetches in all 8 directions (up, down, left, right, diagonals)
- Auto-start on search — begins prefetching from top of page immediately
- Re-centers on click — clicking a post restarts the spiral from that position
- Triggers on infinite scroll — new appended posts start prefetching automatically
Slideshow
- Blacklist Tag button — opens categorized tag menu in slideshow toolbar
- Blacklist Post button — blacklists current post from slideshow toolbar
- Blacklisting clears slideshow — both preview and slideshow cleared when previewed post is blacklisted
Copy to Clipboard
- Ctrl+C — copies preview image to clipboard (falls back to cached file)
- Right-click grid — "Copy Image to Clipboard" option
- Right-click preview — "Copy Image to Clipboard" always available
Live Settings
- Most settings apply instantly — infinite scroll, library directory, thumbnail size, rating, score
- Removed "restart required" labels
Bugfixes
- Blacklisting doesn't clear unrelated preview — only clears when the previewed post matches
- Backfill confirmed working — debug logging added
- Status bar keeps result count — shows "N results — Loaded" instead of just "Loaded"
- Fixed README code block formatting and added ffmpeg back to Linux deps
Download
booru-viewer.exe— Windows standalone (requires VP9 Video Extensions for WebM playback)Downloads
-
v0.1.5 — Stable Stable
2026-04-05 17:47:57 +00:00 | 510 commits to main since this releaseStable Release
First stable release of booru-viewer.
Changes since v0.1.4
Slideshow
- Preview cleared while open — media only plays in slideshow, info panel with tags expands to fill the space
- Video position sync — remembers playback position between preview and slideshow both ways
- Video state sync — mute, volume, autoplay, loop mode shared between preview and slideshow
- Focus-aware — key events and scroll-to-volume only fire when slideshow window is active
- Monitor selector — Settings > General lets you pick which monitor slideshow opens on
- Ctrl+P privacy screen — works from slideshow, hides window and pauses video
- Minimum window size — prevents squishing when dragged by window manager
Video Playback
- 3-way Loop/Once/Next — click to cycle: Loop (repeat), Once (stop at end), Next (advance to next post)
- Autoplay/Manual — only shown when Next mode is active
- Mid-playback toggle — switching modes takes effect immediately
- Space to pause — hover over preview and press Space
- Click-to-seek — click anywhere on the seek bar to jump
- Scroll-to-volume — scroll wheel adjusts volume in preview and slideshow
Library
- Video thumbnails — ffmpeg if available, play icon placeholder fallback
- Right-click context — Open in Default App, Open Folder, Copy Path, Delete
- Multi-select delete
- Unreachable warning — red text when library directory is missing or unmounted
- Configurable directory — Settings > Paths with browse button
- Slideshow navigation — arrow keys work in Library tab slideshow
Prefetch
- Spiral prefetch — gradually preloads entire page outward from clicked post with gentle pacing
- Renamed setting — "Prefetch whole page over time"
UI Polish
- Right-click doesn't change preview — selects thumbnail visually, shows context menu without restarting video
- Hover highlight — lighter border on thumbnail hover
- Blacklisting clears preview — both tag and post blacklist
- QProxyStyle dark arrows — spinbox and combobox arrows visible on all dark QSS themes
- Two indicators — yellow star (bookmarked), green dot (saved), both QSS-controllable
Bookmarks
- Fully renamed from Favorites — all UI, signals, and API
- Decoupled from saves — bookmark without saving, save without bookmarking
- Import signal fix — bookmark imports properly refresh the view
Stability
- Missing defaults added — fresh installs won't hit empty setting values
- All silent exceptions logged — no more swallowed errors
- Expanded Linux install docs — per-distro package commands, venv setup, GStreamer deps
- Removed old custom_css_guide.txt — replaced by themes/README.md
- Fixed PyInstaller spec — removed reference to deleted file
Download
booru-viewer.exe— Windows standalone (requires VP9 Video Extensions for WebM playback)Downloads
-
v0.1.4 Stable
2026-04-05 06:38:41 +00:00 | 572 commits to main since this releaseChanges since v0.1.3
Library Rewrite
- Three-tab layout — Browse | Bookmarks | Library
- Bookmarks (formerly Favorites) — posts tracked in DB, like browser bookmarks. Can revisit from cache.
- Library — browse saved files on disk with sorting (date, name, size) and folder sidebar
- Independent operations — bookmarking and saving are now decoupled. Bookmark without saving, save without bookmarking.
- Unbookmarking no longer deletes saved files
- Saving no longer auto-bookmarks
- Configurable library directory — Settings > Paths with browse button
Visual Indicators
- Yellow star for bookmarked posts
- Green dot for saved posts
- Red dot for missing files (NAS/external drive offline)
- All three QSS-controllable:
qproperty-bookmarkedColor,qproperty-savedColor,qproperty-missingColor
Library Tab
- Video thumbnails via ffmpeg first-frame extraction
- Right-click context — Open in Default App, Open Containing Folder, Copy File Path, Delete from Library
- Multi-select delete — bulk delete files from library
- Unreachable warning — red text when library directory is missing or unmounted
Slideshow
- Preview cleared while slideshow is open — media only plays in slideshow, info/tags still visible in main app
- Preview restores on close — current post reloads when slideshow exits
- Video position sync — remembers playback position between preview and slideshow both ways
- Actions hidden for Library — no Bookmark/Save buttons when browsing library in slideshow
- Actions toggle dynamically — switching tabs with slideshow open shows/hides buttons
- Focus-aware — key events and scroll-to-volume only fire when slideshow window is active
- No more external player — video errors logged instead of opening in system player
Blacklist
- Add post URLs manually — "Add..." button in Settings > Blacklist accepts multiple URLs
- Backfill — filtered posts replaced from next API pages to fill page size
Other
- Auto cache eviction — runs live after each download when enabled
- Renamed terminology — Favorite→Bookmark throughout UI and code
- Configurable library path — custom save directory applied on startup
Download
booru-viewer.exe— Windows standalone (requires VP9 Video Extensions for WebM playback)Downloads
-
v0.1.3 Stable
2026-04-05 01:42:40 +00:00 | 614 commits to main since this releaseChanges since v0.1.2
Slideshow Mode
- Toolbar — Favorite and Save/Unsave toggle buttons showing current post state
- Up/Down navigation — J/K and arrow keys navigate by grid row
- F11 toggle — Switch between fullscreen and windowed
- Ctrl+H — Hide/show all UI for distraction-free viewing
- Page boundary — All directions past edges load next/prev page
- Text input safety — Slideshow keybinds don't interfere with search bar
Tag Categories
- Info panel — Tags grouped by category with color coding: Artist (gold), Character (green), Copyright (purple), Species (red), General, Meta (gray)
- Blacklist Tag menu — Right-click shows categorized submenus (Danbooru/e621)
- Danbooru & e621 — Categories parsed from API; Gelbooru/Moebooru fall back to flat list
Blacklist
- Paste-friendly — Text box in settings, paste space or newline separated tags
- Toggleable — Enable/disable checkbox without deleting tags
- Client-side filtering — No more tag limit errors from server-side negatives
- Auto-enable — Right-click blacklist enables and re-searches immediately
Theming
- 6 bundled themes — Nord, Catppuccin Mocha, Gruvbox, Solarized Dark, Tokyo Night, Everforest
- Fusion style — Custom QSS now switches to Fusion for consistent rendering
- Grid selection — QSS
selection-background-colorcontrols thumbnail highlight - Theme docs —
themes/README.mdwith complete QSS reference for every widget
Favorites
- Bulk actions — Multi-select right-click: Save All, Unsave All, Move All, Unfavorite All
Library
- Unsave from Library — Grid right-click, preview right-click, and slideshow toolbar
- Save/Unsave toggle — Single button in slideshow showing current state
Search
- Inline history — Dropdown arrow inside search bar (no more "v" button)
- Manage Saved Searches — Dialog for deleting individual saved searches
- Session cache — Cacheless mode clears search history on exit
Privacy & Transparency
- Network tab — Settings > Network shows all hosts contacted with request counts
- Zero telemetry — Confirmed by full codebase audit
- Privacy section in README
Performance
- Persistent event loop — Single background thread for all async operations
- Directory pre-scan — Saved file checks via set lookups instead of per-post exists()
- Batch DB — Single-transaction bulk favorite inserts
- Database indexes — favorites.folder and favorites.favorited_at
Bugfixes
- Fixed async error handling — exceptions no longer silently swallowed
- Fixed close race condition — async thread joins before DB close
- Fixed slideshow state buttons not updating after async favorite/save
- Fixed grid up/down in last incomplete row
- Fixed preview stealing keyboard focus from grid
- Fixed QTextEdit text color in Windows dark mode
- Fixed Gelbooru HTML entities in tags (' → ')
- Fixed Save button width clipping
Download
booru-viewer.exe— Windows standalone (requires VP9 Video Extensions for WebM playback)Downloads
-
v0.1.2 Stable
2026-04-05 00:56:20 +00:00 | 628 commits to main since this releaseChanges since v0.1.1
Slideshow Mode
- Video support — Slideshow mode now plays MP4, WebM, and GIF files
- Seek controls —
,and.seek 5 seconds back/forward in videos,Spacetoggles play/pause - Bidirectional sync — Clicking posts in the main grid updates the slideshow, and vice versa
- Arrow key navigation — Left/Right/H/L navigate posts in slideshow (including during video playback)
Navigation
- Page boundary navigation — Arrow keys past the last/first post automatically load the next/prev page (works in grid, preview, and slideshow)
- All directions — Up/Down/J/K at grid boundaries also trigger page turns
- Auto-select — After a page turn, the first or last post is automatically selected and previewed
Pixiv Ugoira Support
- Auto-convert — Pixiv ugoira
.zipfiles (frame archives) are automatically converted to animated GIFs - Cached — Converted GIFs are cached so subsequent loads are instant
Video Playback
- Seamless looping — Short videos no longer flash/flicker when looping (uses native
QMediaPlayer.Loops.Infinite) - No double audio — Main preview video pauses when slideshow opens
Other
- Session cache — New "Clear cache on exit" option in Settings > Cache
- Filetype field — Info panel now shows the file type (JPG, PNG, WebM, etc.)
Download
booru-viewer.exe— Windows standalone (requires VP9 Video Extensions from Microsoft Store for WebM playback)Downloads
-
v0.1.1 Stable
2026-04-05 00:20:03 +00:00 | 639 commits to main since this releaseChanges since v0.1.0
- Bottom page navigation — Prev/Next buttons moved to the bottom of the window
- Favorites keyboard nav — Arrow keys now scroll through favorites and load previews correctly (previously only worked on Browse tab)
- Score filter fix — Score≥ spinbox now uses server-side
score:>=Nfiltering instead of client-side, so full pages of results load properly - Slideshow mode — Right-click preview → "Slideshow Mode" for fullscreen viewing with arrow key navigation
- Windows 10 dark mode — Automatically detects system dark mode and applies a dark theme (Fusion + flat stylesheet)
- TUI removed — GUI-only, simplified codebase
- Screenshots added to README with Windows 10, Windows 11, and Linux examples
Download
booru-viewer.exe— Windows standalone (requires VP9 Video Extensions from Microsoft Store for WebM playback)Downloads
-
v0.1.0 Stable
2026-04-04 11:00:50 +00:00 | 655 commits to main since this releaseInitial release. Download booru-viewer.exe for Windows.
Downloads