v0.3.0

Author: Amateur-God

.github/workflows/release.yml

@@ -154,65 +154,64 @@ jobs:
       - name: List artifacts (some may be missing if a job failed)
         run: find ./artifacts -type f -maxdepth 3 -print || true
 
-      - name: Extract release notes from CHANGELOG.md (robust heading match)
-        id: gen_notes
+      - name: Setup Node (for extractor)
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Extract release notes from CHANGELOG.md
+        id: extract
         shell: bash
         run: |
           set -euo pipefail
-          TAG="${GITHUB_REF_NAME}"     # e.g., v0.2.1
-          VER="${TAG#v}"               # 0.2.1
-          FILES=("CHANGELOG.md" "docs/CHANGELOG.md")
-          OUT="RELEASE_NOTES.md"
-          found=false
-
-          for f in "${FILES[@]}"; do
-            if [[ -f "$f" ]]; then
-              # Match any '##' heading that contains the version in common forms:
-              # "## v0.2.1", "## [v0.2.1]", "## 0.2.1", "## [0.2.1]" (date text allowed after).
-              start_line=$(grep -nE "^##[[:space:]].*[\[\(]?v?${VER}[\]\)]?([[:space:]]|$|[[:punct:]].*)" -m1 "$f" | cut -d: -f1 || true)
-              if [[ -n "${start_line:-}" ]]; then
-                tail_start=$((start_line + 1))
-                next_rel=$(tail -n +"$tail_start" "$f" | grep -nE "^##[[:space:]]" -m1 | cut -d: -f1 || true)
-                if [[ -n "${next_rel:-}" ]]; then
-                  end_line=$((tail_start + next_rel - 2))
-                else
-                  end_line=$(wc -l < "$f")
-                fi
-                sed -n "${tail_start},${end_line}p" "$f" > "$OUT"
-                if [[ -s "$OUT" ]]; then
-                  echo "has_notes=true" >> "$GITHUB_OUTPUT"
-                  echo "notes_path=$OUT" >> "$GITHUB_OUTPUT"
-                  found=true
-                  break
-                fi
-              fi
-            fi
-          done
+          TAG="${GITHUB_REF_NAME}"
+          # Try root CHANGELOG.md; if not found or no section, try docs/CHANGELOG.md
+          node ./scripts/extract-changelog.mjs "$TAG" "./CHANGELOG.md" "./CHANGELOG_RELEASE.md" || true
+          if [ ! -s "./CHANGELOG_RELEASE.md" ] && [ -f "./docs/CHANGELOG.md" ]; then
+            node ./scripts/extract-changelog.mjs "$TAG" "./docs/CHANGELOG.md" "./CHANGELOG_RELEASE.md" || true
+          fi
 
-          if [[ "$found" != "true" ]]; then
-            echo "has_notes=false" >> "$GITHUB_OUTPUT"
+          if [ -s "./CHANGELOG_RELEASE.md" ]; then
+            echo "found=true" >> "$GITHUB_OUTPUT"
+            echo "notes_path=CHANGELOG_RELEASE.md" >> "$GITHUB_OUTPUT"
+          else
+            echo "found=false" >> "$GITHUB_OUTPUT"
           fi
 
-      - name: Create GitHub Release (with CHANGELOG body)
-        if: steps.gen_notes.outputs.has_notes == 'true'
+      - name: Upload extracted notes (debug)
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: changelog-extract-${{ github.ref_name }}
+          path: CHANGELOG_RELEASE.md
+          if-no-files-found: warn
+          retention-days: 7
+
+      - name: Create/Update GitHub Release (CHANGELOG body)
+        if: steps.extract.outputs.found == 'true'
         uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ github.ref_name }}
           name: ${{ github.ref_name }}
-          body_path: ${{ steps.gen_notes.outputs.notes_path }}
+          body_path: ${{ steps.extract.outputs.notes_path }}
+          generate_release_notes: false
+          make_latest: true
+          allow_updates: true
           fail_on_unmatched_files: false
           files: |
             artifacts/linux/**
             artifacts/windows/**
             artifacts/flatpak/**
 
-      - name: Create GitHub Release (auto-generated notes)
-        if: steps.gen_notes.outputs.has_notes != 'true'
+      - name: Create/Update GitHub Release (auto-generated notes)
+        if: steps.extract.outputs.found != 'true'
         uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ github.ref_name }}
           name: ${{ github.ref_name }}
           generate_release_notes: true
+          make_latest: true
+          allow_updates: true
           fail_on_unmatched_files: false
           files: |
             artifacts/linux/**

CHANGELOG.md

@@ -3,7 +3,7 @@
 All notable changes to this project will be documented in this file.
 The format roughly follows Keep a Changelog, and dates are in YYYY-MM-DD.
 
-## [v0.2.2] — 2025-10-18
+## [v0.3.0] — 2025-10-18
 
 ### Added
 - New engines
@@ -59,7 +59,7 @@ The format roughly follows Keep a Changelog, and dates are in YYYY-MM-DD.
 - Lightbox video playback may not work on some Linux builds lacking proprietary codecs (H.264/AAC). Use “Open Media” or replace Electron’s `libffmpeg.so` with the distro’s `chromium-codecs-ffmpeg-extra` variant.
 - Danbooru video thumbnails may look softer (site only serves small static previews for videos).
 
-[v0.2.2]: https://github.com/Amateur-God/StreamBooru/releases/tag/v0.2.2
+[v0.3.0]: https://github.com/Amateur-God/StreamBooru/releases/tag/v0.3.0
 
 ## [v0.2.1] — 2025-10-18
 

README.md

@@ -1,22 +1,42 @@
 # StreamBooru
 
-StreamBooru is a fast desktop viewer for multiple “booru” engines (Danbooru, Moebooru/Yande.re/Konachan, Gelbooru, Zerochan). It merges and navigates posts across sites, supports round‑robin cross‑site search, has a lightbox with keyboard navigation, and lets you save favorites locally or via site APIs.
+StreamBooru is a fast desktop viewer for multiple booru engines (Danbooru, Moebooru/Yande.re/Konachan, Gelbooru family, e621/e926, Derpibooru). It merges and navigates posts across sites, supports round‑robin cross‑site search, has a lightbox with keyboard navigation, a bulk “Download All”, filename templates, and local favorites. Zerochan support has been removed.
 
 ## Highlights
 
-- Multi‑site: Danbooru, Yande.re/Konachan (Moebooru), Gelbooru, Zerochan
-- Views:
-  - New: globally merged by recency (ties: favorites, score)
+- Engines
+  - Danbooru
+  - Moebooru family: Yande.re / Konachan(.com/.net) / Hypnohub / TBIB
+  - Gelbooru family: Gelbooru.com, Safebooru.org, Rule34 (rule34.xxx), Realbooru, Xbooru
+  - e621/e926
+  - Derpibooru
+- Views
+  - New: globally merged by recency (ties: favorites, score) with per‑site round‑robin append
   - Popular: globally merged using a normalized popularity model (per‑site P95)
   - Search: round‑robin interleaving by your site order (1,2,3,1,2,3…)
   - Favorites: local favorites view with search filter
-- Lightbox viewer: Next/Prev, Open Post/Image, Download, Favorite (local/remote), keyboard: Esc/←/→
+- Bulk download
+  - “Download All” saves everything currently loaded in the active view (New/Popular/Search/Favorites)
+  - Right‑click or Shift‑click “Download All” for options (filename templates)
+  - Single folder chooser, optional per‑site subfolders, concurrency‑limited downloads
+  - Correct Referer headers for common image CDNs (Danbooru, Moebooru, e621/e926, Derpibooru)
+- Naming templates
+  - Presets: `site-id`, `site-score-artist-copyright-character-id`, `site-id-original`, `site-id-rating`, `site-id-widthxheight`
+  - Custom templates with tokens:
+    - Basics: `{site} {site_type} {id} {score} {favorites} {rating} {width} {height} {index} {ext} {original_name}`
+    - Date: `{created} {created_yyyy} {created_mm} {created_dd} {created_hhmm}`
+    - Tags (best‑effort): `{artist} {copyright} {character}`
+- Lightbox viewer
+  - Next/Prev, Open Post/Media, Download, Favorite (local), keyboard: Esc / ← / →
 - Fixed topbar (tabs + search + manage)
-- Smart CDN handling for Danbooru (Referer headers + proxy fallback)
-- Site Manager:
+- Site Manager
+  - Presets for common sites
   - Per‑site rating and default tags (rating:* is managed by the dropdown)
-  - Auth support: Danbooru (login + API key), Moebooru (login + password_hash)
-  - Test shows API reachability, Auth status (with account name/level/id), and Danbooru rate limit
+  - Auth support: Danbooru (login + API key), Moebooru (login + password_hash), Gelbooru (user_id + api_key), e621 (optional)
+  - Test shows API reachability, Auth status (with account/name/level if available), and Danbooru rate limit
+  - Quick links: “Open Account Page” and “API Help”
+- Smart CDN handling
+  - Automatic Referer headers for cdn.donmai.us, files.yande.re, konachan.com/.net, static1.e621.net/e926.net, derpicdn.net, etc.
 
 ---
 
@@ -102,32 +122,50 @@ If you run Wayland only and see issues:
 
 ## Usage
 
-- Launch the app
 - Manage Sites → add/edit sites, set ratings/tags, and add credentials:
   - Danbooru: login + API key (Profile → API)
   - Yande.re/Konachan: login + password_hash (shown on your account page)
+  - Gelbooru.com: user_id + api_key required for API; Safebooru.org works without auth
+  - e621/e926: auth optional for browsing
 - Tabs:
   - New / Popular render merged feeds
   - Search: enter tags (space‑separated), hit Search; results interleave by site order
   - Favorites: shows local saved posts; the search box filters favorites
+- Download All:
+  - Left‑click to download everything currently loaded in the active view
+  - Shift‑click or Right‑click for options (naming template)
+  - Files are saved to a single folder; optionally sub‑foldered by site
 - Lightbox:
   - Click image to open
   - ←/→ to navigate; Esc to close
-  - Buttons: View Post, Open Image, Download, ♥ Save (local) / Favorite (remote)
-- Right top: Manage Sites (sticky while scrolling)
+  - Buttons: View Post, Open Media, Download, ♥ Save (local)
+
+---
+
+## Notes per engine
+
+- Danbooru
+  - Card thumbnails prefer the larger sample image to avoid blur; videos still show small static previews (site limitation).
+  - Test shows API status, Auth, and rate‑limit (remaining/limit and reset time).
+- Gelbooru family
+  - gelbooru.com typically requires `user_id` + `api_key` for JSON/XML API access. Many clones (e.g., Safebooru.org) work without auth.
+- Derpibooru
+  - Defaults to `q=score.gte:0` when the query is empty. Optional `filter_id` is supported if you want to bypass your default site filter.
+- e621/e926
+  - Browsing works without auth; account features (favorites, etc.) are not implemented in this app.
 
 ---
 
 ## Troubleshooting
 
-- Danbooru images are blank or 403:
-  - The app injects proper Referer headers and falls back to a proxy fetch if blocked.
-- Search shows only Danbooru:
-  - We use engine‑native search; some sites may return 0 for plain tags. We auto‑retry with ranking tags (e.g., `order:score`) for Moebooru/Gelbooru.
-- Manage Sites “rating:safe” appears in tags:
-  - The UI strips any `rating:*` tokens from the tags field; set rating only via dropdown.
-- Authentication:
-  - Manage Sites → Test shows API, Auth (with account name/level/id), and Danbooru rate‑limit status.
+- Danbooru images look blurry in cards
+  - Fixed: cards now prefer `sample_url` (the larger preview, e.g., large_file_url on Danbooru) before `file_url`, with `preview_url` as a last resort. Videos still use small static previews.
+- Gelbooru returns 401 or “No results”
+  - Add `user_id` and `api_key` in Manage Sites (Gelbooru.com), or use https://safebooru.org
+- Search shows only some sites
+  - We use engine‑native search. For Moebooru/Gelbooru variants, the app retries with ranking tags (e.g., `order:score`) if plain tags return 0.
+- “rating:safe” appears in tags
+  - The UI strips any `rating:*` tokens from the tags field; set rating via the dropdown instead.
 
 ---
 
@@ -137,7 +175,7 @@ Requirements: Node.js 20+, npm
 
 ```bash
 npm ci
-# run in development (adjust to your start script)
+# run in development (adjust to your scripts)
 npm run start
 # build packages (uses electron-builder.yml)
 npx electron-builder --linux deb tar.gz

package.json

@@ -1,6 +1,6 @@
 {
   "name": "streambooru",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "StreamBooru — Electron app to browse multiple booru sites with New and Popular feeds, merged across sources.",
   "main": "electron/main.js",
   "author": {

renderer/components/postCard.js

@@ -1,9 +1,12 @@
-(function () {
-  function openExternal(url) {
+(() => {
+  const openExternal = (url) => {
     if (url) window.api.openExternal(url);
-  }
+  };
+
+  // Prefer larger sample/large image for sharp cards; preview last.
+  const pickThumb = (post) => post.sample_url || post.file_url || post.preview_url || '';
 
-  function buildActions(post, idx) {
+  const buildActions = (post, idx) => {
     const wrap = document.createElement('div');
     wrap.className = 'actions';
 
@@ -43,9 +46,9 @@
     wrap.appendChild(btnFav);
     wrap.appendChild(btnDownload);
     return wrap;
-  }
+  };
 
-  window.PostCard = function (post, index = 0) {
+  window.PostCard = (post, index = 0) => {
     const card = document.createElement('div');
     card.className = 'card';
     card.dataset.key = `${post?.site?.baseUrl || ''}#${post?.id}`;
@@ -55,8 +58,17 @@
 
     const img = document.createElement('img');
     img.loading = 'lazy';
+    img.decoding = 'async';
     img.alt = String(post?.id ?? '');
-    img.src = post.preview_url || post.sample_url || post.file_url || '';
+    const thumbUrl = pickThumb(post);
+    img.src = thumbUrl;
+
+    // Provide a simple srcset so the browser can pick a sharper file when available
+    const candidates = [];
+    if (post.sample_url) candidates.push(`${post.sample_url} 1x`);
+    if (post.file_url && post.file_url !== post.sample_url) candidates.push(`${post.file_url} 2x`);
+    if (candidates.length) img.srcset = candidates.join(', ');
+
     img.addEventListener('click', () => {
       if (window.openLightbox) window.openLightbox(post);
     });
@@ -65,13 +77,18 @@
     const meta = document.createElement('div');
     meta.className = 'meta';
     const left = document.createElement('div');
-    left.textContent = `♡ ${isFinite(post.favorites) ? post.favorites : 0} ★ ${isFinite(post.score) ? post.score : 0}`;
+    const favs = Number.isFinite(post.favorites) ? post.favorites : 0;
+    const score = Number.isFinite(post.score) ? post.score : 0;
+    left.textContent = `♡ ${favs} ★ ${score}`;
     const right = document.createElement('div');
     const siteA = document.createElement('a');
     siteA.href = '#';
     siteA.className = 'site';
     siteA.textContent = post?.site?.name || post?.site?.type || 'site';
-    siteA.addEventListener('click', (e)=>{ e.preventDefault(); if (post.post_url) openExternal(post.post_url); });
+    siteA.addEventListener('click', (e) => {
+      e.preventDefault();
+      if (post.post_url) openExternal(post.post_url);
+    });
     right.appendChild(siteA);
     meta.appendChild(left);
     meta.appendChild(right);

renderer/components/siteManager.js

@@ -64,7 +64,7 @@
     return b;
   };
 
-  function msToClock(ms) {
+  const msToClock = function(ms) {
     if (!Number.isFinite(ms) || ms <= 0) return '';
     const s = Math.round(ms / 1000);
     const m = Math.floor(s / 60);
@@ -75,9 +75,9 @@
       return `${h}h ${mm}m`;
     }
     return `${m}m ${r}s`;
-  }
+  };
 
-  function fmtInfo(x) {
+  const fmtInfo = function(x) {
     if (x == null) return '';
     // If adapters return a structured object, show a friendly summary
     if (typeof x === 'object') {
@@ -92,7 +92,7 @@
       try { return JSON.stringify(x); } catch { return String(x); }
     }
     return String(x);
-  }
+  };
 
   const siteCard = function (site, idx, onChange, onDelete, onTest) {
     const s = {

renderer/js/bulk-download.js

@@ -2,14 +2,13 @@
   // A getter your view can register to supply the current tab's posts
   let getCurrentPosts = null;
 
-  // Call this from your view code when you load/render results:
   //   window.registerResultsProvider(() => currentPostsArray);
   window.registerResultsProvider = function (fn) {
     if (typeof fn === 'function') getCurrentPosts = fn;
   };
 
   // Map a post object to a downloadable item
-  function toDownloadItem(post, i) {
+  const toDownloadItem = function(post, i) {
     // Prefer the original file if present, fallback to sample/preview
     const url = post?.file_url || post?.sample_url || post?.preview_url || '';
     if (!url) return null;
@@ -30,9 +29,9 @@
       siteName: post?.site?.name || post?.site?.baseUrl || 'unknown',
       fileName
     };
-  }
+  };
 
-  async function onDownloadAllClick() {
+  const onDownloadAllClick = async function() {
     try {
       if (!getCurrentPosts) {
         alert('No results are loaded yet.');
@@ -69,7 +68,7 @@
       console.error('Download all error:', e);
       alert(`Download error: ${e?.message || e}`);
     }
-  }
+  };
 
   const btn = document.getElementById('btnDownloadAll');
   if (btn) btn.addEventListener('click', onDownloadAllClick);