GenCatalog Support and Setup Guide

Popular Grok workflows

Fast paths for the Grok favorites, missing-media, and bulk-download questions people usually search before they install.

• Manage favorites in Grok and xAI
• Bulk download Grok favorites with prompts
• Save Grok prompts with images and videos
• Back up your Grok Imagine library locally
• Recover and protect Grok favorites that disappeared
• Fix missing Grok saved images or videos
• Organize a large Grok Imagine library locally

Installation & Setup

Get GenCatalog running in a few minutes.

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
• Active platform controls — Grok, Arcana Labs, Gemini, GPT Image, Rogue Studio, 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

Local Media Import

Bring downloaded images and videos into GenCatalog even when they did not come from the browser extension.

Use local import for ComfyUI output folders, API-generated videos, files you saved manually, old downloads, exported images, screen recordings, or media from a generator GenCatalog does not capture yet. GenCatalog copies those files into your selected catalog folder so they live beside the rest of your library.

How to Import Files

ComfyUI Metadata Import

When imported files include embedded ComfyUI prompt or workflow metadata, GenCatalog labels the item as ComfyUI and surfaces the workflow context in the item detail view.

• Prompt and workflow: positive and negative prompt text when present, plus the saved workflow metadata.
• Generation settings: checkpoint/model, seed, steps, CFG, sampler, scheduler, denoise, dimensions, and related settings when available.
• LoRAs: LoRA names plus strength, model strength, and clip strength values when the workflow includes them.
• Search behavior: ComfyUI remains the source/tool, while the checkpoint is searchable as the model.

If a file has no embedded ComfyUI metadata, it still imports as a normal local file that you can tag, rate, annotate, and search.

Supported File Types

• Videos: MP4, MOV, WEBM, and M4V
• Images: JPG, JPEG, PNG, WEBP, GIF, and AVIF

Duplicates and Undo

GenCatalog checks exact file hashes during import. If the same file is already in your catalog, it is skipped by default. You can still choose Import anyway from the review drawer when you intentionally want another copy.

If you import the wrong batch, click Undo from the import toast. GenCatalog removes the just-imported items and their copied files from the catalog.

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

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.

Upscaling Grok Imagine Videos

Grok video upscaling is available from the GenCatalog desktop app so you can choose exactly which saved videos to change. The Chrome extension does not bulk-upscale videos during scan or download.

You can also select multiple Grok videos in the desktop app, then use the selected-item Upgrade action to queue those chosen videos. For large libraries, review a small group first so you are confident the upgraded versions are the ones you want to keep.

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.

Arcana Labs

Capture your Arcana Labs image and video generations with prompt and project context.

Saving New Generations

Open Arcana Labs in Chrome with GenCatalog running. As your own generations complete, the extension captures Arcana's generation media and joins it with the matching prompt metadata when Arcana exposes it through the app.

Backfilling History

When you are signed into Arcana, open the GenCatalog extension popup on app.arcanalabs.ai and choose Backfill History. GenCatalog imports your account generations and skips community or showcase media that does not belong to your library.

What Gets Saved

• Image or video media from your Arcana generations
• Prompt and negative prompt when available
• Arcana model, suite, aspect ratio, seed, sampler, CFG, styles, and project context when Arcana provides them
• Prompt ID, generation ID, project ID, source label, and an Open in Arcana link when available

Current Limits

• Arcana support depends on being signed into app.arcanalabs.ai in Chrome.
• Backfill reads your own Arcana generation history; public discover/showcase media is intentionally excluded.
• Saved Arcana items stay local in GenCatalog, just like your other catalog media.

GPT Image

Scan current ChatGPT image conversations, import prompt-matched images, and repair missing prompts on existing GPT Image catalog items.

Scanning a Chat

Open a ChatGPT conversation that contains GPT Image outputs, then open the GenCatalog extension popup and click Scan. GenCatalog counts image outputs it can pair with a visible prompt on that chat.

Downloading New Images

After scan, click Download N new items when new prompt-matched GPT Image outputs are available. Items that are already in your catalog are not offered for duplicate download.

Updating Missing Prompts

If the chat contains GPT Image outputs that are already saved but missing prompt text in your catalog, the popup shows Update prompts. Use it to fill in the missing prompt metadata without re-downloading the images.

Held Items

Media-only images with no matched prompt are held back by default. This keeps your GPT Image imports useful and searchable instead of filling the catalog with promptless mystery files.

Gemini

Save visible Gemini image generations into your local library with prompt context and the highest-resolution file Gemini makes available.

Saving Gemini Images

Open the Gemini chat that contains the image you want to keep. When the GenCatalog save badge appears on the generated image, click it to save the prompt and image into your local catalog.

Best Time to Save

Gemini support is limited in the same practical way as GPT Image support: GenCatalog works best when you save the image while the generation is visible in the chat. We recommend clicking the save badge at generation time so the file, prompt, and context are yours forever.

Full-Size Downloads

When Gemini exposes a full-size download, GenCatalog uses that download and moves it into your catalog instead of leaving a duplicate in your Downloads folder.

Current Limits

• Gemini support is chat-page focused. Bulk history import is not included.
• Prompt capture depends on the prompt context visible in the current chat.
• Saved Gemini items stay local in GenCatalog, just like your other catalog media.

Rogue Studio

Import loaded Rogue Studio media into your local library with prompts and asset metadata when available.

Scanning Loaded Media

Open Rogue Studio and load the media you want to keep. GenCatalog can scan loaded Rogue Studio media and identify items that are not already in your catalog.

Captured Metadata

• Detail-drawer prompt text when available
• Asset metadata exposed by Rogue Studio
• Source platform, save date, and local catalog metadata
• Rogue Studio as its own source in desktop filters

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

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.

What Gets Saved

For each Midjourney generation, GenCatalog preserves:

• Full prompt text (with --sref and --cref URLs 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

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, Arcana Labs, ComfyUI, Gemini, GPT Image, Rogue Studio, 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

Press Escape or click the checkbox icon again to exit multi-select mode.

Privacy Tools

GenCatalog's first privacy tools help keep your local library covered when someone else can see or use your computer.

What App Lock Does

App Lock requires confirmation before opening GenCatalog. On supported Macs, you can unlock with Touch ID or your App Lock password. On Windows, App Lock uses your App Lock password.

App Lock is designed for everyday desktop privacy: stepping away from your computer, sharing a workspace, or keeping your local catalog from opening casually.

Turn On App Lock

1. Open GenCatalog.
2. Go to Settings → Privacy.
3. Turn on App Lock.
4. Create and confirm your App Lock password.
5. On supported Macs, enable Touch ID unlock if you want biometric unlock.
6. Choose when GenCatalog should lock, such as on launch, idle, sleep, or manual lock.

What Privacy Mode Does

Privacy Mode gives you a safer way to browse, demo, or screen-share your catalog. It blurs sensitive previews and keeps videos muted while protection is on, so clicking a blurred video does not unexpectedly play audio.

You can turn Privacy Mode on from the app's Privacy controls. Turning it off requires App Lock confirmation when App Lock is enabled.

Important Security Boundary

App Lock, Privacy Mode, and Hidden Items protect against casual viewing inside the app. They do not encrypt normal library files on disk. For encrypted storage, move selected generations into Private Vault.

Private Vault

Private Vault is encrypted storage for generations that need stronger protection than hiding, blurring, or locking the app window.

What Private Vault Does

Private Vault creates a separate encrypted area inside your GenCatalog library. When you move an item into the Vault, GenCatalog encrypts that item's media file, thumbnail, prompt, and metadata, then removes the normal plaintext library copies.

While the Vault is locked, GenCatalog does not show Vault contents, counts, names, thumbnails, prompts, or metadata. Unlock the Vault when you need to view those items or move them back to your normal library.

What "Encryption at Rest" Means

Encryption at rest means the Vault data is stored in encrypted form while it is sitting on your drive. If someone browses your catalog folder in Finder or File Explorer while the Vault is locked, the Vault media and metadata should not be readable without unlocking the Vault in GenCatalog.

This is different from App Lock or Privacy Mode. App Lock controls access to the GenCatalog window. Privacy Mode blurs content on screen. Hidden Items keeps items out of the main grid. Private Vault is the feature that encrypts selected items on disk.

Set Up and Unlock

1. Open GenCatalog.
2. Click Private Vault in the sidebar.
3. Create a Vault password.
4. Save the recovery key somewhere safe.
5. On supported Macs, enable Touch ID if you want faster day-to-day unlocks.

Move Items In or Out

Use Move to Vault on a library item or selected group of items. To restore an item to the normal library, unlock the Vault and choose Move to Library. Moving an item out decrypts it and restores it as a regular, unencrypted library item.

Hidden Items

Keep private generations out of the main grid without deleting them.

Hidden Items removes selected content from your main catalog view. Nothing is deleted — your files, prompts, and metadata are preserved, and hidden content can be restored later.

Hiding Items

Open any item in the detail view and click Hide. The item disappears from the main grid immediately and moves to your hidden collection.

Accessing Hidden Items

Click Hidden Items in the sidebar. If App Lock is enabled, GenCatalog asks for the same App Lock confirmation used for the rest of your privacy controls. On supported Macs, that can be Touch ID; on Windows, it is your App Lock password.

If you have not enabled App Lock, Hidden Items can still use the older Hidden Items PIN flow. Once verified, hidden items appear in a separate grid view with the same browsing, search, and filter capabilities as the main catalog.

Restoring Hidden Items

While in the hidden view, hover over any item and click Unhide. The item returns to your main catalog.

Changing Hidden Access

For the simplest setup, turn on App Lock in Settings → Privacy and use that unlock flow for Hidden Items. If App Lock is not enabled, go to the sidebar → Hidden Items → Change PIN to manage the fallback PIN.

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

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.