Discourse Bulk Topic Bookmark Manager

WHAT IT DOES

Discourse Bulk Topic Bookmark Manager is a forum productivity tool that streamlines the process of managing bookmarks on Discourse forums. Instead of manually clicking the bookmark button on each topic individually—a process that can be tedious when managing many topics—this script automates the entire workflow. It scans the current Discourse forum page for topic-like elements (titles, categories, authors, dates), aggregates them into a structured list, and presents them as a scrollable checklist. You can select individual topics, use Select All/Deselect All toggles, choose an action (Add Bookmarks, Remove Bookmarks, or Export List), and execute the action in configurable batches. The tool handles the complete interaction sequence: clicking the bookmark button, handling any confirmation modals, and tracking progress. This is ideal for Discourse forum users, community managers, and researchers who want to efficiently organize their reading lists.

WHERE IT RUNS

This script is universal—it runs on any Discourse forum website (*://*/*) as a userscript injected through the BotGentz extension. It operates within the context of your current browser tab and cannot access other tabs, bookmarks, history, or downloads. The script reads the page DOM to identify topics using Discourse's selectors (.topic-list-item, .topic-item, .topic-title), extracts topic metadata (title, category, author, date), and interacts with Discourse's native UI controls—bookmark buttons, more menus, and confirmation modals—to perform actions. All operations occur locally in your browser; no data is sent to external servers.

HOW TO USE

1. Navigate to any Discourse forum page that displays a list of topics (e.g., the main page, a category page, or the latest topics view).

2. Click the BotGentz extension icon and select "Discourse Bulk Topic Bookmark Manager" from the script list.

3. The panel opens on the right side of the page. It automatically scans the current page for topics.

4. Review the detected topics, showing titles, categories, authors, and bookmark status (📌 if bookmarked).

5. Select your action: "Add Bookmarks," "Remove Bookmarks," or "Export List Only."

6. Adjust the "Batch size" number (default 3) to control how many topics are processed per batch.

7. Toggle "Confirm before action" if you want a confirmation popup before each batch executes.

8. Check the boxes next to topics you wish to act on. Use "Select All" or "Deselect All" for quick selection.

9. Click "Execute Action" to begin. The script processes topics in batches, shows progress, and handles errors.

10. For export, the topic list is copied to your clipboard; for bookmark actions, the script interacts with the forum's UI.

WHY IT WORKS WHERE OTHERS FAIL

Many Discourse automation tools fail because they attempt to call Discourse's internal API endpoints or rely on brittle DOM selectors that change with every Discourse theme update. This script takes a resilient approach: it locates the actual interactive DOM elements Discourse renders—the bookmark button, the more menu, and any confirmation modals—and triggers native click events on them, exactly as a human would. When the bookmark button is directly accessible, the script clicks it. When the button is behind a more menu, the script opens the menu, finds the bookmark option, and clicks it. It handles any confirmation modals that may appear. Between operations, the script introduces controlled delays (300ms between actions and 500ms between batches) to mimic human interaction speed. By interacting at the UI layer rather than the framework layer, it remains functional across different Discourse themes and versions.

THE PANEL

The script uses BotGentz's BGPanel system, which provides a floating, draggable panel on the right side of your screen. Drag the panel by its header to reposition it anywhere on the page—the panel remembers its position per site and snaps to the nearest edge when released. Click the minimize button to collapse the panel to a small floating bubble; click the bubble to expand it back. Resize the panel vertically by dragging its bottom edge. Press the Escape key to close the panel entirely. All panel state (position, collapsed/expanded) is persisted locally using GM_setValue, so your preferences survive page reloads.

PLEASE NOTE

This userscript requires the free BotGentz browser extension—it is not a standalone application. The script works on Discourse forums but may require adjustments for heavily customized themes. The "Add Bookmarks" and "Remove Bookmarks" actions interact with the forum's UI and may trigger confirmation dialogs. This script does not store, transmit, or process any of your forum data outside your local browser. It does not access your password, hidden inputs, or file inputs. All bookmark actions are performed through the forum's own authenticated session using the official user interface. Use responsibly and review your selections carefully before executing actions.