civitai-sync is a tool to download and explore your Civitai creations.<hr /><ul><li>Download Images, Video, Audio, 3D, in generations, posts, comics</li><li>Download input media (Image to Image, Image to Video, Video to Video)</li><li>Auto download, to a delay you set</li><li>Explore your library in an offline website</li><li>Media and data saved to the file system, sorted by date</li><li>Export filtered media to auto-updating file system folders, for re-use</li><li>Auto-updates to the latest software version</li></ul><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/0a97ffdc-6a53-4c03-822d-6b2cab09e437/original=true/0a97ffdc-6a53-4c03-822d-6b2cab09e437.jpeg" /><hr />Talk about Civitai-SyncSee comments below, and the discussion page for issues and ideas: <a target="_blank" rel="ugc" href="/articles/5676">https://civarchive.com/articles/5676</a>The tool is free, enjoy. You may express your gratitude by giving a thumbs-up and leaving a candid review. Buzz Tip the model for the joy it brings. <a target="_self" rel="ugc" href="https://emojipedia.org/folded-hands">🙏</a><hr />Generations: by batch or by media<img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/9cb3e92b-6fb6-4cc8-b255-f3fb7bf2c905/original=true/9cb3e92b-6fb6-4cc8-b255-f3fb7bf2c905.jpeg" />Media: image <img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/489b5668-d76b-4f0d-9e23-e411b8bc0392/original=true/489b5668-d76b-4f0d-9e23-e411b8bc0392.jpeg" />Posts: by post<img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/b88b3778-2d66-41dc-8a90-5e8bc5644789/original=true/b88b3778-2d66-41dc-8a90-5e8bc5644789.jpeg" />Posts: by media<img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/55f6e1b8-18cd-4681-93c6-27e032eef7da/original=true/55f6e1b8-18cd-4681-93c6-27e032eef7da.jpeg" />Models (media, by model)<img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/c5217ebd-a5f7-43b8-aca8-23020fe12d2e/original=true/c5217ebd-a5f7-43b8-aca8-23020fe12d2e.jpeg" />Model version (media, by model version)<img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/e46230d1-e7f9-4845-b166-f22765442c73/original=true/e46230d1-e7f9-4845-b166-f22765442c73.jpeg" />Overview (generations, posts, comics,3D) <img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/10ebdb6f-fb67-418c-8ce3-716984c5ac15/original=true/10ebdb6f-fb67-418c-8ce3-716984c5ac15.jpeg" />Post<img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/1c90fa8e-30f0-4635-89e1-6aab399e3bbe/original=true/1c90fa8e-30f0-4635-89e1-6aab399e3bbe.jpeg" />Generation batch<img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/73558528-5cb3-4662-8dfd-2088c9185eee/original=true/73558528-5cb3-4662-8dfd-2088c9185eee.jpeg" />Media: audio / video<img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/134cc5bb-d82a-44ab-999b-f9c5987ba306/original=true/134cc5bb-d82a-44ab-999b-f9c5987ba306.jpeg" />Media: 3D<img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/e4089350-927d-42d4-a25c-6b12b754648e/original=true/e4089350-927d-42d4-a25c-6b12b754648e.jpeg" />Exports <img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/29145060-45ed-4ba8-a2aa-f78ef136559d/original=true/29145060-45ed-4ba8-a2aa-f78ef136559d.jpeg" />Download <img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/6b18d79c-f9d2-41fe-bcd1-b31dcc3d8bfe/original=true/6b18d79c-f9d2-41fe-bcd1-b31dcc3d8bfe.jpeg" /><hr />The software is:<ol><li>A Command Line Interface (CLI). It runs in a terminal or command prompt, with interactive options and settings.</li><li>An Explorer, a website for browsing, searching and re-using your media.</li></ol>CLI: Main menu <img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/dc490bd7-3a2f-4214-873a-81d9452d5689/original=true/dc490bd7-3a2f-4214-873a-81d9452d5689.jpeg" />CLI: Download <img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/b887cfc0-9f3b-4a09-bb42-f09de4049592/original=true/b887cfc0-9f3b-4a09-bb42-f09de4049592.jpeg" /><hr /><h3 id="download-the-tool">Download the tool</h3><ol><li>Download the tool from this page. It's a zip file.</li><li>On your computer, Unzip (or “Extract”) the file. It will create a new folder; rename it “civitai-sync”. Move the folder wherever you want to keep it.</li><li>Install Node.js, download it from:<a target="_blank" rel="ugc" href="https://nodejs.org/"> </a><a target="_blank" rel="ugc" href="https://nodejs.org">https://nodejs.org</a> — if you already have Node, it needs version 18 or above.</li><li>If you have a nice new shiny clickable Node.js icon on your desktop or menu, don’t click it. You don’t need to. That’s for something else. Do this:</li></ol><h3 id="install-the-tool">Install the tool</h3>If updating from an earlier version, see "Manual software update" below.<ol><li>On Windows, double-click the "install_win" file to install. This will open a command prompt, install the software dependencies and then close. Or, install manually with the steps below.</li><li>On Linux, Mac, open your Terminal app. On Windows, your “<a target="_blank" rel="ugc" href="https://www.lifewire.com/how-to-open-command-prompt-2618089">Command Prompt</a>”.</li><li>Inside the terminal, change directory (“<code>cd</code>”) to the unzipped “civitai-sync” folder. Ensure this matches the name and location on your system. For example:<code> cd Downloads/civitai-sync </code> On Windows, use backslashes, not forward-slashes, e.g:<code> cd C:\Downloads\civitai-sync</code></li><li>Install the software dependencies by typing: <code>npm run setup</code></li></ol><h3 id="run-the-tool">Run the tool</h3>Now you can run the program.On Windows:<ol><li>Double-click the "Civitai-Sync" file.</li><li>To add it as a Desktop shortcut icon, right-click on it &gt; "Send to" &gt; "Desktop (create shortcut)".</li></ol>On Linux, Mac, or Windows:<ol><li>In the terminal app, change directory ("<code>cd</code>”) to the program folder, as above.</li><li>Run it by typing: <code>civitai-sync</code> This is an alias for: <code>npm run cli</code></li></ol><h3 id="manual-software-update-(optional)">Manual software update (optional)</h3>Since v4, software updates are automatically detected. When a new version is released, you will see an option to install the update.If you want to manually upgrade:<ol><li>Download the zip file, unzip it.</li><li>Copy the unzipped files into your existing “civitai-sync” program folder, overwriting the older files.</li><li>In the terminal app, change directory ("<code>cd</code>”)<code> </code>to the program folder.</li><li>Type: “<code>npm run setup</code>”<code>. </code>On Windows, double-click on “install_win”.</li></ol><h3 id="create-an-api-key">Create an API key</h3><ol><li>In Account Settings, see “API Keys” near the bottom of the page: <a target="_blank" rel="ugc" href="/user/account/security">https://civarchive.com/user/account/security</a></li><li>Click “Add API key”. Name it, e.g. “civitai-sync”. Click “Save”. <img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/fc3240da-d071-4638-8ea2-f50104a6c1c8/width=525/fc3240da-d071-4638-8ea2-f50104a6c1c8.jpeg" /></li><li>You will be shown the key only once &gt; Copy it.</li><li>In civitai-sync, choose "Set API key", and paste the key.</li></ol>(To paste, right-click &gt; "Paste", or press "Ctrl+V" or "Ctrl+Shift+V")Password protectionYou can set a password to encrypt your API key, e.g. if you are on a shared computer. You'll enter the password each time you run the program. Or press "Enter" for no password.<h3 id="change-domain:-civitai.com-or-civitai.red">Change Domain: civitai.com | civitai.red</h3>Go to Settings &gt; Change DomainThe setting is visible for users who have "Show mature content" at <a target="_blank" rel="ugc" href="https://civarchive.com/user/account/content">https://civarchive.com/user/account/content</a><h3 id="start-downloading">Start Downloading</h3>If your API key is saved, you can choose "Download". Check the "Settings" in the CLI to change download folder, etc.Civitai saves your generations for 30 days, so use the tool regularly.<h3 id="start-the-explorer">Start the Explorer</h3>Start the Explorer from the CLI.Or, without the CLI: <code>civitai-sync explorer [optional: account, e.g. "bob"]</code>This is an alias for:<code>npm run explorer [account]</code>On Windows, double-click <code>Civitai-Sync-Explorer</code> in the program folder; this uses the default config.<h3 id="data">Data</h3>Data is saved directly from Civitai's API, as text files (in “JSON” format). Prompts and metadata are already embedded in the media metadata (e.g. "EXIF" format).You can explore the generation parameters and details for images and videos, in the civitai-sync Explorer.<h3 id="multiple-accounts">Multiple accounts</h3>To download from more than one account, give a unique name: <code>civitai-sync bob</code>This is an alias for: <code>npm run cli bob</code>Or give a full path to anywhere on the file system, and the config file will be loaded from or created there.<h3 id="network-access">Network access</h3>By default the Explorer is only reachable from the machine it runs on. To access it from other devices on your trusted local network — a phone, tablet, or another computer — add the <code>--host</code> flag: <code>civitai-sync explorer [account] --host</code>This is an alias for: <code>npm run explorer -- [account] --host</code><h3 id="problems-thoughts-get-in-touch">Problems? Thoughts? Get in touch</h3>Make a comment, start a chat. @monkeypuzzle

civitai-sync

New Explorer: One Download button, auto download, rating and tag filters- One Download button, for Generations, Posts, Comics, 3D.- Auto download, on a delay you set from 5 minutes to 1 day.- Rating (PG, etc), post tags, and content tags.- Change the API key in the Explorer.- Recheck metadata on Posts and Comics, for published changes such as rating and tags.- Navigate a filtered gallery post by post, and image by image.- Support for Images, Video, Audio, Comics, 3D.- Media sorted by Workflow, e.g. T2I (Text to Image), I2I (Image to Image).- Input media: Image/video inputs are shown for "Image to Image/Video" and "Video to Video" workflows.- Exports: Choose a set of filters (e.g. "Favorited, uses LoRA X, Prompt includes 'apple pie'"), then create a custom filesystem folder that auto-updates with new downloads that match the filters. Existing Favorited, Liked and Disliked folders are converted to Exports.- Models: Filter media by model family, model type, your own models.- Posts: Scheduled and Draft posts.- Software upgrade displays better errors.- Errors persisted in <code>startup-report.txt</code> in the program folder.- More efficient migration for cloud filesystems.

Files with SHA256: 593d9ecb4af3b58499efedca52bb83427f4fd164cc8e3ea3cd5ee60705608616