[Userscript] Danbooru Insights

Danbooru Insights (formerly Danbooru Grass) is a comprehensive analytics suite for Danbooru users and tags. It injects GitHub-style contribution graphs and advanced dashboards directly into profile and wiki pages, with full support for both desktop and mobile.

The script consists of three main components:

• GrassApp: Visualizes user contributions (Uploads, Approvals, Notes) on a GitHub-like calendar heatmap with support for hourly activity analysis, 12 themes, and per-theme grass color palettes.
• UserAnalyticsApp: Provides deep insights into a user's posting habits, including milestones, tag usage, tag cloud, created tags discovery, post scores with downvote filtering, and extensive distribution charts.
• TagAnalyticsApp: A specialized dashboard for Artist, Copyright, and Character tags. It analyzes extensive data including historical trends, popular posts, active uploaders/approvers, and milestones for any specific tag.

Installation

• Chrome/Firefox: Install Tampermonkey

Project page

• https://github.com/AkaringoP/Danbooru-Insights

Main script

• https://github.com/AkaringoP/Danbooru-Insights/raw/build/danbooruinsights.user.js

Wiki

• TBA

Usage notes

• Where it runs
• Profile pages (/users/*, /profile): GrassApp (contribution graph) + UserAnalyticsApp (📊 button next to username).
• Wiki pages (/wiki_pages/*) and Artist pages (/artists/*): TagAnalyticsApp (📊 button next to tag name).

• First-time setup
• GrassApp loads automatically on profile pages — no action needed.
• UserAnalyticsApp: Click the 📊 button next to the username. A one-time data sync runs on first use. Posts ≤1,200 sync instantly; larger accounts may take a few minutes. You can close the modal — sync continues in the background.
• TagAnalyticsApp: Click the 📊 button on a wiki or artist page. Data is fetched on first click and cached for 24 hours.

• Settings (⚙️)
• 12 themes (6 light / 6 dark), each with 4 selectable grass color palettes (48 total). Click an active theme icon to open the palette flyout.
• Contribution thresholds: Customize the 4-level color scale per metric (Uploads / Approvals / Notes).
• Settings are saved per-user in localStorage.

• Data & Caching
• Post metadata is cached locally in IndexedDB (Dexie.js) — no re-fetching on revisit.
• TagAnalyticsApp cache expires after 24h or when post count changes significantly (threshold configurable via ⚙️).
• Use the 🗑️ button inside the dashboard to full-reset and re-fetch.
• Stale data for inactive users is auto-cleaned after 14 days.
• API calls are rate-limited to 6 req/s (Token Bucket) to comply with Danbooru rate limits.

Final

Any suggestions or feedback is appreciated.

Latest edits

• (2026-04-21)
• Version 9.3.0 — GrassApp magnet snap-to-edge resize, structured logging with dual-gated logger & toast notifications, mobile diagnostic overlay, v9.2.4 cache revalidation, mobile layout fixes (stats clipping, scatter filter overlap, milestones grid, tap-only tooltip), DataManager integrity test coverage (30 cases, 185 total).

Versions

Pushed Version 6.5 which includes a structural UI overhaul and performance optimizations for TagAnalyticsApp:

UI: Redesigned UserAnalyticsApp with a new animated 3-pane summary card layout.
Performance: Extended TagAnalyticsApp fast-path calculation logic to optimize tags with up to 1,200 posts (up from 100).
Refactor: Cleaned up the CSS architecture by consolidating all scattered inline styles into a centralized GLOBAL_CSS.

Pushed Version 7.0 which is a full TypeScript migration of the codebase with no user-facing changes:

• Rewrite: Converted the entire ~12,000-line single-file script into 13 TypeScript modules (config, styles, types, core/*, ui/*, apps/*) with complete type annotations.
• Build: Introduced Vite + vite-plugin-monkey and tsc for bundling and type checking, replacing the hand-edited single file workflow.
• Tests: Added 55 automated unit tests (Vitest) covering core logic — settings, rate limiter, utils, analytics, and routing.

Starting from v7.0, development has moved from Gemini 3.1 Pro + Antigravity to Claude Code + VS Code.

Pushed Version 7.2.0 focusing on enhanced rating controls, a unified user history timeline, and thumbnail fetch fixes:

• UI/UX: Replaced basic SFW/NSFW tabs with granular G/S/Q/E rating tabs for the Most Popular Post widget, and maintained separate tab states across different widget modes.
• Features: Completely redesigned the "User History" card into a unified, chronological timeline that seamlessly merges join dates, milestones, and level changes into a single view.
• Bug Fixes: Resolved HTTP 422 errors when fetching pie chart thumbnails from user favorites, and fixed an issue where thumbnails failed to re-render upon data updates.

Pushed Version 8.0 with new widgets, expanded pie charts, a theme system overhaul, and various improvements.
Full changelog: GitHub

GrassApp

• Grass Color Picker: Each of the 12 themes now offers 4 selectable grass color palettes (48 total), inspired by d3-scale-chromatic (Viridis, Inferno, Plasma, etc.). Click an active theme icon to open the color flyout.
• New Themes: Added Lavender (light), Monokai (dark), and Ember (dark gradient). Removed Sunset.
• Hourly Panel Sync: The Hourly Distribution panel now follows the heatmap when you resize or move it.

UserAnalyticsApp

• Pie Chart — 3 New Tabs: Gender (Girl/Boy/Other/No Humans), Commentary (Commentary/Requested/Untagged), Translation (Translated/Requested/Untagged). Tabs are now arranged in two rows with hover tooltips showing full names.
• Milestones: New dropdown options — Repdigit (11, 111, 222, …, 11111) and Every 10k.
• Created Tags Widget: Discovers general tags the user was the first to create by parsing NNTBot's daily tag reports (topic #21649). Automatically searches previous usernames. Shows current status — Active, Aliased (with consequent tag post count), Deprecated, or Empty.
• Tag Cloud Widget: A d3-cloud word cloud showing the user's most characteristic tags. 4 category tabs (General, Artist, Copyright, Character) with crossfade transitions. General tags are selected by Cosine similarity rather than plain frequency, surfacing tags that define the user's style.
• Scatter Plot: Dragging a selection now shows the date range, score/tag count range, and post count in a tooltip above the box. Crosshair cursor added.

Architecture

• Monolithic app files split into data / charts / app modules (~5,000 lines reorganized).
• 112 automated tests (up from 86), including architecture fitness tests that enforce dependency direction and ban raw fetch().
• Git pre-commit hook runs the full build pipeline before every commit.

Development uses Claude Code + VS Code.

Pushed Version 8.1.0 focusing on multi-tab rate limit coordination and error page handling:

• Bug Fixes: The script no longer renders on nginx error pages (429, 502, etc.) that previously caused it to misparse the error title as a username.
• Features: Added cross-tab rate coordination via BroadcastChannel — multiple open tabs now automatically share the API rate budget equally instead of competing independently.
• Features: Added global 429 backoff — when any request is rate-limited, all tabs pause API requests for 5 seconds to let the server recover.

Thanks to @CommentaryRequest for reporting this issue.

Pushed Version 9.0 with full mobile support, a scatter plot overhaul, a schema migration, and various improvements.
Full changelog: GitHub

GrassApp

• Post Hover Preview Card (also in scatter plot popovers): Hovering a post in the approval detail popover shows a floating card with thumbnail, score, favs, rating, and first artist/copyright/character tag. Debounced + cached.

UserAnalyticsApp

• Scatter Plot — Tag Count Mode Y=10 Click: The "10" tick on the Y axis is now clickable and shows two counts (gentags:<10, tagcount:<10) with deep links. Points with t < 10 are highlighted in black on hover.
• Scatter Plot — Score Mode Downvote Filter: Four mutually-exclusive toggle buttons (>0, >2, >5, >10) above the chart filter by downvote count. Applies to both rendered points and the drag-selection popover.
• Scatter Plot — Drag Popover Improvements: Selection rectangle stays visible while the popover is open. Deleted/banned posts shown as gray dots with tooltip. Hover preview card on each list item.
• Next Milestone Card: A new dashed-border placeholder at the end of the milestones grid shows the upcoming milestone, posts remaining, and a progress bar. Respects the active step selector (Auto / 1k / 2.5k / 5k / 10k / Repdigit).

TagAnalyticsApp

• Next Milestone Card: Same placeholder card as UserAnalyticsApp, appended to the milestones grid.

Mobile Support (new in v9.0)

• Fullscreen Modal (100dvh), responsive layout for every widget under 768 px, TagAnalytics rankings switch to a horizontal swipe.
• Touch Interactions (consistent 2-step "tap → tooltip → action" pattern): CalHeatmap cells, pie chart slices, and tag cloud words all show their tooltip on first tap, then act on second tap. Scatter plot drag selection disabled on touch.
• Back Button Closes Modal via history.pushState / popstate. Escape key support also added to UserAnalyticsApp.

Repository Migration

As of v9.0.1, Danbooru Insights lives in its own dedicated repository at AkaringoP/Danbooru-Insights, split out of the original monorepo with full commit history preserved. Existing installations will self-migrate to the new update endpoint on the next update check — no action required.

It’s a very interesting userscript overall. Lots of stats to look at, mostly out of curiosity, but some can be helpful in gardening posts!

All I ask for is dark mode on UserAnalyticsApp and TagsAnalyticsApp. my eyesss

Pushed Version 9.2.0 focusing on GrassApp vertical drag layout, dashboard render performance, and theme improvements:

Click and drag the top-left corner to move the graph horizontally or switch between inline and below layout.

Click and drag the left or right edge to resize the graph width.

GrassApp

• Vertical Drag Layout: GrassApp can now be moved between inline (beside stats) and below (own row) positions by dragging the move handle vertically. Each mode independently remembers its width and horizontal offset. A glowing destination bar appears during drag to indicate the target position.
• Layout Fix: Users with very long Previous Names no longer have GrassApp forced below stats — the stats section is now width-constrained so both elements fit side by side.
• Theme: Replaced the Newspaper theme (which was actually light) with Dracula, a proper dark theme with Green, Pink, Purple, and Cyan grass options. Added a "Preview all" link in the settings popover that opens a GitHub Pages-hosted visual comparison of all 12 themes.

UserAnalyticsApp

• Render Performance: Dashboard render speed improved via stale-while-revalidate caching for Milestones, TopPosts, RecentPopular, and LevelChange data. Random posts moved off the critical render path. Fixed a race condition where the sync button could trigger a spurious partial sync on fast page loads.

Pushed Version 9.3.0 focusing on magnet snap-to-edge resize, structured logging & observability, and mobile layout fixes:

GrassApp

• Magnet Snap Resize: Container width snaps to the December edge with ±15px hysteresis when resizing. Togglable via "Snap to edge when resizing" checkbox in settings.

Structured Logging & Observability

• Structured Logger: Replaced all 123 raw console.* calls with a dual-gated structured logger (dead-code eliminated on main, runtime opt-in on dev).
• Toast & Diagnostic: Replaced 6 alert() calls with non-blocking toast notifications. Added mobile diagnostic overlay (#di_diag) with zero app dependencies.

Mobile Fixes

• Layout: Stats table no longer clipped on narrow viewports; scatter downvote filter no longer overlaps the chart.
• Tooltip: Grass tooltip uses tap detection — drag gestures only scroll, no accidental tooltips.

Internal

• Test Coverage: 30 new DataManager data integrity tests (remote/local count comparison, cache revalidation, pagination). 185 tests total.