How to Use GenCatalog
A complete guide to capturing, organizing, and browsing your AI-generated content across Grok Imagine, Higgsfield, Midjourney, Digen, and Venice.ai.
See latest release notes and update details.
Popular Grok workflows
Fast paths for the questions people usually search before they install.
Installation & Setup
Get GenCatalog running in a few minutes.
Mac: Download the DMG from gencatalog.app/get, open it, and drag GenCatalog to your Applications folder.
Windows: Download the installer (.exe) from gencatalog.app/get, run it, and follow the setup steps.
On first launch, GenCatalog asks you to select a folder where all media and metadata will be stored. Choose anywhere — an external drive works great for large collections.
GenCatalog uses FFmpeg to generate video thumbnail previews. During setup, a prompt will appear — here's what to expect:
Mac: GenCatalog can install FFmpeg for you automatically. The process takes about a minute and requires no technical steps.
Windows: You'll be directed to a download page to grab the FFmpeg files you need. Follow the on-screen instructions to complete setup.
Image thumbnails work immediately without FFmpeg. This step only affects video previews.
Install the GenCatalog extension from the Chrome Web Store. Works in any Chrome-based browser (Chrome, Brave, Edge, Arc, and more).
GenCatalog lives in your menu bar (Mac) or system tray (Windows). As long as it's running, the extension is active and ready across all supported platforms.
System Requirements
- macOS 10.15 (Catalina) or later
- Apple Silicon (M1/M2/M3/M4) or Intel Mac
- Any Chrome-based browser (Chrome, Brave, Edge, Arc, and more)
- Windows 10+ (x64) — download here
The Chrome Extension
The bridge between AI platforms and your local catalog.
Click the GenCatalog icon in your browser toolbar to open the popup. It now centers the status and controls that matter for the platform you're on:
- Connection state — if the desktop app is open, the popup connects automatically; if not, open the app and wait a few seconds
- Trial or license state — the chip and banner explain whether you're licensed, in trial, offline, or at a save limit
- Platform strip + action rail — Grok, Midjourney, Higgsfield, Digen, and Venice each show the controls that apply to that site
- Recent saves — your latest captured items and save confirmations
- Open Catalog / Settings — launch your catalog or manage persistent download preferences
Grok Imagine
Full support for saving images and videos — individually or in bulk from your favorites.
Saving Individual Generations
When viewing any Grok Imagine generation, a blue GenCatalog save button (⊞ grid icon) appears on the media. Click it to save instantly. The button shows a spinner while saving, a green checkmark on success, or orange if it's already in your catalog.
Bulk Downloading Your Favorites
Make sure you're logged into your Grok account.
GenCatalog scans all your favorites and compares against your existing catalog. You'll see: total favorites / already saved / new to download / previously deleted (skipped automatically).
Downloads only items not already in your catalog. Progress strip shows real-time status as the batch runs.
Pause a bulk download and resume it later. Progress is preserved — already-saved items won't be re-downloaded.
Multiple Grok Accounts
GenCatalog supports saving from multiple Grok accounts into a single catalog. Each item is automatically tagged with the account it came from, so you can filter your catalog by account. To save from another account: log out of Grok, log in to your second account, and use the extension as normal.
Smart Sync & Exclusion
When you delete an item through GenCatalog, it's added to a permanent exclusion list and will never be re-downloaded during future bulk scans — even if it's still in your Grok favorites.
Higgsfield
Save images and videos from your Higgsfield library — individually or all at once.
Where Save Buttons Appear
- Detail pages — grid icon ⊞ appears next to the native Download/heart/share buttons
- Grid / browse pages — a save badge appears on each thumbnail in your library, explore feed, and profile
- Modals / lightboxes — save button appears automatically when you open any generation in a lightbox
Bulk Saving Your Library
Browse your personal library or any grid page. GenCatalog caches items as they appear on screen.
Use this the first time to read the current cache and initialize the Higgsfield counts.
Refresh Count updates the cache totals after you've scrolled farther, and Sync New saves only items that are not already in your catalog.
Hit the Griddy Helper Script
If you are working through a large Higgsfield detail-view gallery, this helper can click GenCatalog's save button, wait for the save to finish, then advance to the next item.
Download Hit the Griddy
Use this from the Higgsfield page while the GenCatalog desktop app and Chrome extension are running.
Download hit-the-griddy.js- Open Higgsfield and navigate to the first item in a detail view.
- Open Chrome DevTools with
Cmd+Option+Ion Mac orCtrl+Shift+Ion Windows. - Open the Console tab, paste the full script, and press Enter.
- To stop early, type
stopSync()in the console and press Enter.
Captured Metadata
- Prompt text
- Model name (e.g., Seedream 4.5, Nano Bana Pro 2)
- Preset information
- Character name (if used)
- Asset UUID for reliable deduplication
- Full-resolution media file
Venice.ai
Limited support for saving visible generations from Venice.ai chat pages.
Saving Chat Items
Open a Venice.ai chat and scroll to the generation you want to keep. A GenCatalog save badge appears on visible image generations, and on video generations after the video has rendered on the page.
Click the badge to save the image or video into your local GenCatalog library. GenCatalog captures prompt and model details when Venice exposes them near the visible generation.
Videos Need to Be Played First
For Venice.ai videos, press play before saving. Venice does not always render the video element until playback starts, so GenCatalog may not have a media target to attach to until the video has been played once.
What Gets Saved
- The visible image or video file
- Prompt text when Venice exposes it on the chat page
- Model details when they are visible or recoverable from the page
- Source platform, save date, and local catalog metadata
Current Limits
- Venice.ai support is chat-page only. Public feed capture and bulk import are not included.
- For videos, press play first so the save badge can attach to the rendered video.
- Prompt and model capture depend on what Venice exposes in the visible chat layout.
- Saved Venice items stay local in GenCatalog, just like your other catalog media.
Midjourney
Save individual images or scan your entire Midjourney generation history at once.
Saving Individual Items
A Save button appears on each image as you browse Midjourney. Click it to save the image with its full prompt, model version, and parameters.
Scanning Your Full Library
GenCatalog can import your entire Midjourney generation history in one go — no need to save items one at a time.
Make sure you're logged in and on the main Midjourney web app. Wait a moment for the page to fully load.
GenCatalog reads your generation history from the page — no separate network request. You'll see Total, Saved, and New counts.
Saves all new items to your catalog with full metadata. Re-scanning will only pick up items not yet saved.
What Gets Saved
For each Midjourney generation, GenCatalog preserves:
- Full prompt text (with
--srefand--crefURLs stripped for readability) - Model version (
--v), aspect ratio (--ar), chaos, seed, style, and all other parameters - All four image variants per generation
- Image dimensions and generation date
Digen
Save your Digen AI generations individually or in bulk.
Saving Individual Items
A blue GenCatalog save button appears on each generation on digen.ai. Click it to save the image or video with its metadata.
Bulk Saving
Click the GenCatalog icon while on digen.ai and switch to the Digen tab.
Counts available items on the current page.
Saves all scanned items to your catalog.
Browsing & Search
Find anything in your catalog instantly.
Open your catalog via Open Catalog in the extension popup, or go to http://localhost:8080 in your browser.
Search
Type in the search bar to filter your entire catalog by prompt text. Search is instant across all platforms.
Filters
- Platform — show only Grok Imagine, Higgsfield, Midjourney, Digen, or Venice content
- Media type — images or videos only
- Favorites — show only starred items
- Tags — click any tag to filter by it
- Source image — find all generations made from the same img2vid source
- Account — filter by Grok account
Other Tools
- Rediscover ✨ — opens a random item from your catalog
- Slideshow — auto-plays through your collection. Images advance on the timer you set; videos play to their full natural duration before advancing.
- Compare — select 2 items in multi-select mode to compare side by side
Tags & Favorites
Favorites
Click the ⭐ on any item to favorite it. Filter to favorites-only using the sidebar. Bulk-favorite items using multi-select mode.
Tags
Open any item and click the tag field to add custom tags. Tags are fully searchable. Good uses: style names, project names, character names, or any workflow category you need.
Notes
Add personal notes to any item — useful for recording what worked, variations to try, or any context you want to preserve alongside the prompt.
Bulk Operations
Multi-Select Mode
Enters multi-select mode.
Selected items show a blue border. Use Select All / Deselect All for quick selection. Shift+click to select a range.
Available: Favorite Selected, Delete Selected, Compare (exactly 2 items).
Press Escape or click the checkbox icon again to exit multi-select mode.
Trash & Deletion
Deleting an item moves it to Trash first — nothing is immediately gone.
Managing Trash
- Click View Trash in the sidebar to see deleted items with deletion dates
- Restore any individual item using the button on each row
- Restore All — one-click button to recover everything in trash at once
- Multi-select — click items to select them, then use the floating action bar to Restore Selected or Delete Permanently
- Empty Trash to permanently delete all trashed items
Exclusion List
Every item deleted through GenCatalog is permanently added to an exclusion list. It will never be re-downloaded during future bulk scans — even if it still exists in your Grok favorites.
Duplicate Detection
GenCatalog scans your entire catalog.
See how many duplicates were found before confirming.
GenCatalog removes duplicates, keeping the oldest version of each item.
Detection uses two methods: exact URL matching, and platform UUID matching (works even if the URL format changes between captures).
Mobile Access
On Your Home Network
Your catalog is accessible from any device on your Wi-Fi. GenCatalog shows a QR code in the catalog sidebar — scan it with your phone to open your catalog instantly. Or type your Mac's local IP (shown in the sidebar) into your phone's browser followed by :8080.
From Anywhere
Install Tailscale (free) on both your Mac and phone. Once set up, you can access your full catalog from anywhere in the world — coffee shop, travel, anywhere — as long as your Mac is on and running GenCatalog.
License & Activation
After purchasing, you'll receive a license key by email. To activate: open GenCatalog → click the menu bar icon → select License → enter your key and click Activate. Requires internet for initial activation.
License revalidation happens approximately every 7 days, with a 30-day offline grace period. Your files and catalog data are never affected by license status.
Free Trial
- Duration: 7 days from first launch
- Item limit: up to 250 generations
- Trial ends when either limit is reached
- After expiry: saving new items is paused until license activation
- Your existing library, files, prompts, and tags are always accessible — nothing is ever deleted
You can activate your license at any time during or after the trial. Purchase at gencatalog.app.
Need more help?
If something isn't working or you have a question not covered here, we're happy to help. We respond within 1–2 business days.
Email [email protected]