How to Use GenCatalog
A complete guide to capturing, organizing, and browsing your AI-generated content across Grok Imagine, Higgsfield, Midjourney, and Digen.
See latest release notes and update details.
Installation & Setup
Get GenCatalog running in a few minutes.
Mac: Download the DMG from gencatalog.app, open it, and drag GenCatalog to your Applications folder.
Windows: Download the installer (.exe) from gencatalog.app, 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 shows:
- Status indicator — green "Running" = ready; red "Not Running" = open the desktop app
- Catalog stats — total items and video count
- Platform tabs — Grok, Higgsfield, Digen with controls for each
- Open Catalog — opens your full catalog in the browser
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 bar shows real-time status.
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.
See how many items have been cached from the current page.
Saves all cached items to your catalog at once.
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
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, or Digen 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 100 saved items
- 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]