# Booru Enhancer — v1.2.11

## Changelog (1.2.10 → 1.2.11) — Safebooru / Gelbooru 0.2 layout fix

- **Root cause of "only one tiny thumbnail per page, can't navigate or download" on Safebooru:** the gallery container was picked by a fixed selector list (`#post-list-posts, #post-list, .content`). On Safebooru `#post-list` is the **whole page row** (sidebar + content, a flex row in the site's own CSS), not the element that holds the thumbnails. The script turned that row into a CSS grid, so the sidebar and the entire thumbnail area were squeezed into two ~220px cells.
- The container is now derived from the thumbnails themselves: it is the nearest element that actually holds the thumbnail wrappers (the parent of the first thumbnail, or the lowest common ancestor of the first two). This works for any layout and never picks the sidebar, the page row, or ``. Applies to the Gelbooru-family and generic adapters; the old selector list is only a fallback for fetched pages.
- `display:grid` is now `!important`: the site's own `div#post-list { display:flex }` (id selector) used to out-rank the script's class.
- Thumbnail wrappers get `box-sizing:border-box` (Safebooru's `.thumb` has 10px padding, which made 100%-wide cells overflow their grid column).
- The grid fills the remaining width when its parent is a flex row (it used to shrink-wrap to a single column next to the sidebar).
- Non-thumbnail children of the grid (paginator, clearfix, headings) now span the full row instead of occupying a thumbnail cell.
- Thumbnails loaded by infinite scroll are inserted right after the last existing thumbnail, not after the paginator/other trailing nodes.

- Fixed "Download" saving the resized sample/preview instead of the full original on Gelbooru (e.g. post 7094291: 56 KB vs 1.2 MB).
- Original URLs are now resolved in strict priority order, and any derived copy (`/samples/`, `/thumbnails/`, `sample_*`, `thumbnail_*`) is never accepted as "original":
1. The "Original image" link in the post's Options list
2. A `

Changelog

[1.2.9] — 2026-09-27

Fixed

• Infinite-scroll thumbnails rendered as blank/broken images. Additional pages are parsed in a detached document where the site's lazy-load JS never runs, so data-src/data-srcset were never promoted. Cloned images now resolve data-src → src and data-srcset → srcset before being appended. Uses the same truthy-fallback convention already in the file (img.src || img.dataset.src), so an empty src="" is correctly replaced. Verified against 5 edge cases: missing src, existing src not clobbered, no src/data-src at all, empty src="", srcset.

• Sankaku Complex page-mutating stages broke the site. No dedicated adapter exists, so the generic adapter was mutating a DOM it wasn't written for. Now detects "generic adapter + sankakucomplex.com" and skips all page-mutating stages (menu command still registers). Guarded on all three re-entry paths — initial init, SPA pushState/popstate nav, and the MutationObserver fallback — via a single shared helper. The check keys off adapter.id === 'generic', not hostname alone, so it self-retires once a real sankaku adapter is added. Verified with 9 host-matching edge cases (subdomains, no false positives on lookalike domains, self-retirement).

Changed

• Version constant resynchronized. BE.VERSION had drifted to '1.2.7' while @version metadata said 1.2.8. Both are now 1.2.9. This affects the exported settings JSON and the outgoing User-Agent header.

## [1.2.8]

**Infinite-scroll "hang" root-cause fix.**

### Fixed
- `BE.net.request()` previously treated *any* non-2xx HTTP status (403/404/500, etc.) the same as a transient network failure, silently retrying it up to the configured retry count before rejecting. Several booru sites respond to "page past the last one" with a non-2xx status rather than an empty 200 page — the old behavior meant a request like that would burn through all its retries, reject, land in `loadNextPage()`'s catch block, and retry the *entire request* again every 5 seconds, indefinitely, because it could never reach the "no more pages" branch. This was very likely the underlying cause of infinite scroll appearing to hang or never stop. Only genuine network failures (`onerror`/`ontimeout`) and explicit rate-limiting (429) are retried now; any response that actually completed is resolved and handed to the caller to interpret, whatever its status code.
- `BE.net.json()` updated accordingly — since `request()` no longer filters out non-2xx responses itself, `json()` now explicitly checks for a 2xx status and throws if the response didn't succeed.

### Known issue in this release
- `@version` in the userscript header was bumped to `1.2.8`, but the internal `BE.VERSION` constant was left at `'1.2.7'`. This isn't just cosmetic: it's the version string reported in exported settings JSON, and it's sent as the literal `User-Agent` (`BooruEnhancer/1.2.7 (userscript)`) on every request the e621/e926 adapter makes. Fix pending in a follow-up patch release.

===============================================================================

BOORU ENHANCER — v1.2.7

CHANGELOG

v1.2.7 — Interaction & Pagination Regression Fixes

FIXED

• Moved gallery click and pointer-event delegation from capture phase to bubble phase.

  • Prevents Booru Enhancer from intercepting thumbnail events before the site's own target-level handlers execute.
  • Preserves viewer interception for normal left-clicks.
  • Modifier-key and non-primary clicks remain untouched.

• Hardened Gelbooru-family thumbnail wrapper detection.

  • Wrapper candidates are now validated before being accepted.
  • A candidate must contain exactly one thumbnail image.
  • The candidate's resolved post ID must match the thumbnail's post ID.
  • Prevents generic [data-id]/[data-post-id] ancestors from accidentally becoming the thumbnail wrapper.
  • Prevents multi-post containers from being styled or treated as a single thumbnail.

• Removed the hard-coded Gelbooru "+42" pagination fallback.

  • No fabricated page size is assumed.
  • Pagination is extrapolated only after a real page-size delta has been observed from the site's pagination controls.
  • If no reliable pagination information exists, native pagination remains available instead of requesting a guessed URL.

• Preserved and reinforced native pagination recovery.

  • Native pagination is hidden only after a successful infinite-scroll load.
  • Failed requests restore the native paginator.
  • Empty/overlapping pages do not automatically terminate a valid pagination chain.

• Preserved pagination loop protection.

  • Previously visited page identities are never requested again.
  • Prevents A → B → A and repeated-page loops.

IMPROVED

• Gelbooru-family interaction handling is now considerably more conservative.
• Thumbnail wrapper resolution is consistent between initial thumbnails and thumbnails inserted by infinite scroll.
• Viewer/action handling operates from the explicitly enhanced thumbnail wrapper instead of broad ancestor matching.
• Infinite-scroll initialization remains fully idempotent.
• Dynamic gallery settings continue to apply immediately without requiring a page reload.
• Runtime initialization remains resilient: failures in individual stages are isolated and logged instead of preventing the rest of the extension from starting.

v1.2.6 — Gelbooru Interaction & Gallery Layout Fixes

FIXED

• Replaced broad thumbnail wrapper detection using generic article/span/div/a ancestors with adapter-specific getThumbWrapper() implementations.
• Prevented the gallery container or unrelated ancestors from being tagged as thumbnail wrappers.
• Fixed viewer, hover preview, favorite, download, and grid-layout failures caused by incorrect wrapper detection.
• Restricted gallery click/hover delegation to explicitly enhanced .be-thumb-wrap elements.
• Fixed hover-preview flickering caused by pointerout/pointerover transitions between children of the same thumbnail.
• Fixed gallery thumbnailSize, gridDensity, and gridGap settings not affecting the actual grid layout.
• Fixed compactMode having no visible CSS effect.
• Fixed --be-thumbnail-size being calculated but not applied to the DOM.
• Fixed dynamically inserted infinite-scroll thumbnails not receiving the same action-bar behavior as initial thumbnails.
• Fixed viewer opening being unnecessarily dependent on asynchronous metadata enrichment.

IMPROVED

• Added immediate CSS-grid sizing through custom properties.
• Neutralized conflicting native thumbnail sizing so Booru Enhancer controls the enhanced gallery layout.
• Added defensive numeric coercion for persisted gallery settings.
• Preserved idempotent infinite-scroll initialization.
• Preserved pagination loop detection and native paginator restoration.

v1.2.5 — Pagination & Grid Stability

FIXED

• Made gallery initialization idempotent.
• Made infinite-scroll setup idempotent.
• Added protection against duplicate observers and sentinels.
• Added pagination loop detection.
• Prevented already-visited pages from being requested repeatedly.
• Restored native pagination when infinite-scroll requests fail.
• Prevented grid items from collapsing or overlapping.
• Added min-width/min-height/overflow protections for grid items.
• Improved aspect-ratio and object-fit handling for thumbnails.

IMPROVED

• Made SPA/AJAX navigation handling safer.
• Reduced the possibility of duplicated UI and event listeners after navigation or re-initialization.
• Added more defensive error handling around gallery operations.

v1.2.7 — Overall Result

• Safer event interception
• Safer Gelbooru wrapper detection
• No fabricated Gelbooru pagination URLs
• Reliable infinite-scroll recovery
• Idempotent gallery initialization
• Stable dynamic grid sizing
• Correct action handling for dynamically loaded thumbnails
• More resilient SPA/AJAX navigation
• Better separation between site-native behavior and Booru Enhancer behavior

===============================================================================

Booru Enhancer — v1.2.5

Gallery, Pagination & Reliability Overhaul

Fixed

• Fixed infinite-scroll fallback pagination

  • Corrected an issue where a calculated fallback next-page URL was stored but never actually used for the request.
  • Calculated pagination URLs are now correctly passed to the page loader.

• Fixed initial gallery duplicate detection

  • loadedPostIds is now populated from posts already present on the page before infinite scrolling starts.
  • Prevents the first dynamically loaded page from re-inserting posts that are already visible.

• Fixed gallery state resets

  • Gallery-specific state is now reset only when the actual gallery container is replaced.
  • Ordinary DOM mutations no longer unnecessarily reset pagination or post-tracking state.

• Fixed duplicate thumbnails during infinite scrolling

  • Newly fetched posts are checked against the existing loadedPostIds set before insertion.
  • Overlapping pagination results no longer create duplicate thumbnails.

• Fixed repeated infinite-scroll initialization

  • Reinitializing the gallery no longer creates multiple IntersectionObservers, sentinels, or delegated event handlers.
  • This is especially important for SPA navigation, MutationObserver updates, and settings changes.

• Fixed repeated infinite-scroll toggling

  • Turning infinite scrolling on and off repeatedly no longer leaves stale observers or sentinel elements behind.
  • Disabling infinite scrolling correctly disconnects the observer and restores native pagination.

• Fixed pagination loops

  • Added pagination identity tracking to prevent repeatedly requesting the same page.
  • A → B → A pagination loops are detected and stopped automatically.
  • Repeated page identities now transition the loader into a safe exhausted state.

• Fixed gallery replacement handling

  • When a site replaces its gallery during SPA/AJAX navigation, the old gallery's page-scoped state is discarded correctly.
  • New galleries receive fresh pagination and duplicate-detection state.

Improved

• More reliable pagination discovery

  • Explicit rel="next" and site-specific next-page links are preferred.
  • Additional pagination links are inspected when a dedicated next link is unavailable.
  • Generic pagination no longer blindly assumes a universal +42 page size.

• Safer generic-site pagination

  • Generic adapters now prefer real pagination evidence from the site's own links.
  • Observed pid increments can be reused when a valid next-page link provides enough information.
  • If pagination cannot be determined safely, the enhancer stops instead of generating arbitrary URLs.

• Improved infinite-scroll failure handling

  • The native paginator is not hidden prematurely.
  • Failed or exhausted infinite-scroll attempts can restore the site's original pagination controls.

• Improved page-loading diagnostics

  • Added detailed debug logging for:
  • Infinite-scroll triggers
  • Selected next URLs
  • Pagination identities
  • Page requests
  • HTTP responses
  • Gallery detection
  • Thumbnail counts
  • Duplicate filtering
  • Page-loop detection
  • Exhaustion conditions

• Improved dynamic gallery support

  • Newly inserted thumbnails automatically inherit the existing delegated gallery interactions.
  • Gallery interaction no longer depends on attaching individual listeners to every thumbnail.

• Improved immediate thumbnail interaction

  • Thumbnail clicks are handled through gallery-level event delegation.
  • Opening a thumbnail does not require waiting for metadata enrichment to finish.
  • Metadata can continue loading in the background and upgrade the viewer afterward.

• Improved gallery initialization

  • Gallery initialization is now designed to be idempotent.
  • Repeated initialization attempts do not duplicate listeners or gallery infrastructure.

Settings & Persistence

• Settings continue to use persistent userscript storage.
• Storage writes support both synchronous and Promise-based userscript manager APIs.
• Settings changes can update the active gallery without recreating the entire gallery system.
• Gallery settings now safely control grid layout and infinite-scroll lifecycle.

Version

• Updated Booru Enhancer to v1.2.5.
• Userscript metadata and internal runtime version are synchronized at 1.2.5.

Known Limitations

• Some older Gelbooru-family installations may still require site-specific pagination handling because their pid page size can vary.
• Generic booru compatibility remains best-effort when a site does not expose reliable pagination or post identifiers.

Compatibility

Tested architecture targets:

• Danbooru
• Gelbooru
• Safebooru
• Rule34
• Realbooru
• TBIB
• Xbooru
• HypnoHub
• Moebooru-family sites
• e621 / e926
• Generic booru-style sites

Summary

v1.2.5 focuses on making the gallery and infinite-scroll system idempotent, duplicate-safe, loop-resistant, and resilient to SPA/AJAX page changes, while preserving the existing viewer, downloader, settings, metadata, and adapter architecture.

v1.2.0 — Runtime Repair & Feature Integration

Added

• Added a resilient GM API compatibility layer for:
  • Violentmonkey
  • Tampermonkey
  • ScriptCat
• Added persistent userscript menu commands:
  • Booru Enhancer → Settings
  • Booru Enhancer → Enable/Disable
  • Booru Enhancer → Reset Settings
  • Booru Enhancer → Debug Mode
• Added configurable thumbnail size.
• Added configurable gallery grid spacing.
• Added live gallery layout settings.
• Added download controls to the main Booru Enhancer toolbar.
• Added Download, Open Original, Favorite, and Close controls to the fullscreen viewer.
• Added immediate event delegation for gallery thumbnails.
• Added improved infinite-scroll status and retry handling.
• Added HTTP 429 retry handling with exponential backoff.
• Added adapter fallback to the generic booru implementation.

Fixed

• Fixed the downloader being implemented but not exposed through the user interface.
• Fixed the missing Download action in the main toolbar.
• Fixed the missing Download action in the fullscreen viewer.
• Fixed viewer initialization being dependent on metadata loading.
• Fixed thumbnail clicks being handled too late after page load.
• Fixed gallery hover/click functionality not being immediately available.
• Fixed settings initialization being able to fail silently when storage was unavailable.
• Fixed adapter detection failures preventing the entire script from starting.
• Fixed gallery grid spacing and thumbnail sizing configuration.
• Fixed thin thumbnails overflowing their gallery tiles.
• Fixed gallery pagination relying exclusively on a single next-page selector.
• Fixed Gelbooru-family pagination fallback from blindly assuming a fixed page size.
• Improved duplicate post prevention during infinite scrolling.
• Improved handling of failed pagination requests.

Improved

• Reworked startup into a more resilient initialization pipeline.
• Added storage fallback to an in-memory cache when userscript storage fails.
• Added safer settings defaults and persistent settings loading.
• Added explicit startup logging.
• Improved adapter detection and generic fallback behavior.
• Improved cross-origin networking through the userscript GM API.
• Improved download filename generation using metadata templates.
• Improved original-media discovery through adapter-specific post fetching.
• Improved fullscreen viewer behavior.
• Improved gallery event handling through event delegation.
• Improved responsive gallery layout.
• Improved infinite-scroll pagination state handling.
• Improved retry behavior for failed network requests.
• Added SPA navigation detection and reinitialization support.

Gallery Settings

The following settings are now available:

• gallery.infiniteScroll
• gallery.gridDensity
• gallery.thumbnailSize
• gallery.gridGap

Downloading

The downloader now supports:

• Original-quality media
• Images and videos
• Custom filename templates
• GM_download
• Browser download fallback
• Metadata-based filenames

Example:

Character - Artist (123456).jpg

v1.1.2 — Gallery UX & Initialization Improvements

Fixed

• Fixed gallery interactions taking several seconds to become available after page load.
• Fixed thumbnail click handling being delayed until metadata finished loading.
• Fixed thumbnails opening in a new tab before the Booru Enhancer viewer was ready.
• Fixed hover-preview initialization being unnecessarily dependent on metadata loading.
• Fixed thin thumbnails overflowing or overlapping adjacent thumbnails.
• Improved thumbnail containment and grid layout stability.
• Fixed gallery spacing being absent between thumbnails.
• Fixed gallery layout settings not being applied immediately after changing them.
• Improved gallery container detection across supported booru layouts.
• Improved dynamically inserted thumbnails so they become interactive immediately.

Added

• Added configurable thumbnail size.
• Added configurable gallery grid spacing.
• Added live thumbnail-size adjustment.
• Added live grid-gap adjustment.
• Added event delegation for gallery click and hover interactions.
• Added more detailed infinite-scroll diagnostics.
• Added separate handling for HTTP errors, login pages, empty responses, and rate-limit responses.
• Added retry handling for HTTP 429 responses with exponential backoff.
• Added adapter-aware gallery container detection.

New Gallery Settings

• gallery.thumbnailSize
  • Adjustable from 120px to 500px.
• gallery.gridGap
  • Adjustable from 0px to 20px.
• gallery.gridDensity
  • Controls the number of grid columns.
• gallery.compactMode
  • Provides a more compact gallery layout.

Performance

• Gallery interactions no longer wait for metadata enrichment.
• Viewer click handling is initialized immediately.
• Hover previews are initialized immediately.
• Metadata enrichment runs independently from the initial gallery UI.
• Dynamically loaded thumbnails use the same delegated event handlers as the initial gallery.
• Reduced the need for repeatedly attaching individual thumbnail event listeners.

Infinite Scroll

• Added extensive pagination diagnostics.
• Improved pagination error reporting.
• Added HTTP 429 rate-limit handling.
• Added retry handling for failed page requests.
• Improved validation of fetched gallery pages.
• Improved detection of login/error responses.
• Improved handling of dynamically loaded gallery content.

Note: Infinite-scroll pagination is still being actively tested across the different Gelbooru-family implementations. Additional site-specific pagination fixes may follow.

Changelog — Booru Enhancer v1.1.1

[1.1.1] — Infinite Scroll & Pagination Rewrite

Added

• Added a site-independent pagination API to adapters:

  • getNextUrl()
  • getPageIdentity()
  • getPostIdentity()
  • calculateNextUrl()

• Added dedicated pagination support for:

  • Gelbooru
  • Safebooru
  • Rule34.xxx
  • Realbooru
  • TBIB
  • Xbooru
  • HypnoHub
  • Danbooru
  • Moebooru
  • e621/e926
  • Generic booru sites

• Added support for Safebooru/Gelbooru-style:

  • #paginator a[alt="next"]
  • a[title="next"]
  • a.next
  • a[rel="next"]

• Added PID-based pagination detection for Gelbooru-family sites.

• Added automatic page-size detection from real pagination links.

• Added calculated pagination fallback when a site does not expose a usable next link.

• Added dynamic infinite-scroll sentinel with status messages:

  • Loading more…
  • Scroll for more…
  • No more posts
  • Unable to load the next page.

• Added Retry button when a page request fails.

Changed

• Completely rewrote the infinite-scroll implementation.
• Moved pagination logic out of the gallery module and into individual adapters.
• Infinite scroll now obtains pagination information exclusively through adapter.pagination.
• Pagination state is now stored in JavaScript rather than repeatedly reading the live paginator DOM.
• Native pagination controls are hidden using a reversible CSS class instead of directly modifying style.display.
• Fetched pages are validated before being inserted into the gallery.
• Added HTTP-status and response-body validation.
• Added detection for invalid/login/error pages.
• The gallery now extracts the next-page URL before modifying the live DOM.
• Infinite scroll automatically continues when the sentinel remains inside the preload area after a page is loaded.
• Preserved existing query parameters when calculating fallback URLs.

Fixed

• Fixed Safebooru infinite scroll stopping after the first page.

  • Safebooru uses #paginator a[alt="next"], which was not recognized by the previous implementation.

• Fixed pagination logic that incorrectly marked a gallery as exhausted when the standard a[rel="next"] / a.next selectors were unavailable.

• Fixed duplicate page requests.

• Fixed duplicate post insertion across dynamically loaded pages.

• Fixed pagination state being lost when the site's paginator DOM is replaced.

• Fixed infinite-scroll requests being triggered concurrently.

• Fixed false "No more posts" states when pagination detection temporarily fails.

• Fixed retry behavior by preserving the exact failed URL.

• Fixed calculated pagination from losing existing query parameters such as tags, rating, sorting, page, pid, and s.

Pagination Behavior

Current Page
     │
     ▼
adapter.pagination.getNextUrl()
     │
     ├── Explicit next link
     │
     ├── Advancing PID/page link
     │
     └── calculateNextUrl() fallback
              │
              ▼
        Load next page
              │
              ▼
       Validate response
              │
              ▼
        Extract posts
              │
              ▼
       Deduplicate posts
              │
              ▼
        Insert into grid
              │
              ▼
       Find next page URL
              │
              ▼
        Continue scrolling

Supported Pagination

Internal Improvements

• Added loadedPages tracking.
• Added loadedPostIds tracking.
• Added consecutiveEmptyPages tracking.
• Added explicit IDLE → LOADING → SUCCESS / ERROR / EXHAUSTED state handling.
• Exposed gallery pagination state through:

BE.modules.gallery._scrollState

• Added detailed pagination debug logging.
• Added safer handling of empty or malformed responses.

Compatibility

• Existing gallery functionality remains intact.
• Infinite scroll remains controlled by:

gallery.infiniteScroll

• Disabling infinite scroll restores the site's native pagination controls after reload.

Changelog

[1.1.0] — Reliability & Gallery Overhaul

Fixed

• Settings persistence race conditions

  • Settings now load only after the GM storage cache has finished initializing, preventing saved preferences from being overwritten by defaults on startup.
  • Added safer handling for asynchronous storage operations.

• Storage schema migration support

  • Introduced a storage-version/migration hook for future settings changes.
  • Corrupt or unreadable stored values now fail safely instead of breaking initialization.

• Gallery thumbnail sizing

  • Thumbnail sizing is now completely independent of metadata/API requests.
  • Grid layout is applied immediately when thumbnails are discovered.
  • API failures can no longer cause thumbnails to remain extremely small.

• gridDensity / compactMode

  • Grid density now directly controls the gallery's CSS grid columns via new --be-grid-columns and --be-thumb-gap custom properties.
  • Changes to grid density and compact mode apply live, without requiring a page reload.

• Gelbooru-family API failures

  • Added a multi-stage metadata retrieval strategy:
  • Same-origin fetch() with session credentials.
  • GM_xmlhttpRequest fallback.
  • Rendered post-page HTML scraping as a final fallback.
  • API outages, authentication restrictions, or CSP issues no longer disable gallery metadata enrichment.
  • HTML fallback requests use bounded concurrency and gentle pacing to avoid hammering the server.

• Silent toolbar/keybind failures

  • Actions requiring a selected post or active selection now provide visible toast feedback.
  • Selection mode now reports its current state.
  • Bulk download and reverse-search actions no longer fail silently.

• Settings-page consistency

  • The settings toolbar is now available consistently across gallery, search, index, post, and pool pages.
  • Settings that require a page reload are explicitly marked with a "Reload required" indicator.

Improved

• Gallery architecture — Visual thumbnail processing and metadata enrichment are now separate stages, so browsing remains functional even when metadata APIs are unavailable.
• Network handling — Centralized GM_xmlhttpRequest wrapper provides Promise-based requests with retry/backoff handling and better compatibility between classic GM_* and namespaced GM.* APIs.
• User feedback — Added lightweight, auto-dismissing toast notifications for non-blocking UI feedback.
• Adapter resilience — Gelbooru-family adapters now tolerate differences between Gelbooru clones and markup versions, with improved post-ID detection across multiple thumbnail markup patterns.

Architecture

Continued modular adapter-based design:

Verification

This release resolves the major issues identified in 1.0.x:

• [x] Settings persistence race
• [x] Storage initialization race
• [x] Tiny thumbnails after API failure
• [x] Broken grid-density behavior
• [x] Gelbooru API failure handling
• [x] Missing HTML fallback
• [x] Silent toolbar actions
• [x] Inconsistent settings access
• [x] Reload-required settings feedback
• [x] Version consistency (1.1.0)

Known / Deliberately Unimplemented

The following remain intentionally out of scope for this release:

• Cloud synchronization
• Tag analytics
• ML tag suggestions
• Duplicate finder
• Local download database
• External plugin loader
• Full i18n/theme system
• Command-palette UI

The current architecture already provides extension points for these features without requiring changes to the core system.

changed namespace and version