civitai-sync is a tool to download and explore your Civitai creations.<hr /><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/8ec2910d-a444-460a-8081-937fb74a0013/original=true/8ec2910d-a444-460a-8081-937fb74a0013.jpeg" /><ul><li>Download generations (images, video, audio, 3D)</li><li>Download posts and comics</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 media for re-use</li><li>Auto-updates for new versions</li></ul>The tool is free. You may express your gratitude by tipping the model, giving a thumbs-up and leaving a candid review. Enjoy. <a target="_self" rel="ugc" href="https://emojipedia.org/folded-hands">🙏</a><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><hr /><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/4f02f26e-8d3e-4d87-9fd7-5b0510e445b1/original=true/4f02f26e-8d3e-4d87-9fd7-5b0510e445b1.jpeg" /><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/a6774b14-be28-40fa-8881-670860fc5e56/original=true/a6774b14-be28-40fa-8881-670860fc5e56.jpeg" /><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/462214cb-1587-4d03-bbd8-0cd3971db8e0/original=true/462214cb-1587-4d03-bbd8-0cd3971db8e0.jpeg" /><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/92b34efd-ef7c-4229-a002-612459364264/original=true/92b34efd-ef7c-4229-a002-612459364264.jpeg" /><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/a05e0157-6bec-45e6-8be3-16e2dcf89317/original=true/a05e0157-6bec-45e6-8be3-16e2dcf89317.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>Read on for installation instructions.<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="https://civarchive.com/user/account">https://civarchive.com/user/account</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.red-users">Change Domain: civitai.red users</h3>Go to Settings &gt; Change DomainThis setting is visible for users who have "Enable Mature Settings" set at <a target="_blank" rel="ugc" href="https://civarchive.com/user/account">https://civarchive.com/user/account</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.Set each account's download folder to be different, unless you want the data and media for the accounts to be merged.<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: A radically improved Explorer, to seamlessly browse your library.- Support for Audio, Comics, 3D.- Media sorted by the type of Workflow, e.g. T2I (Text to Image), I2I (Image to Image).- Input media: Image and video inputs are kept, in "Image to Image/Video" and "Video to Video" workflows.- Exports: Choose a set of filters (e.g. "Favorited, uses LoRA X, includes 'apple pie' in Prompt") and create a custom folder that will auto-update with new media 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.- Requires Node version 20 or above.

Files with SHA256: 13b288aa2d707755e5363a60b9eece8e66aa592067c9b7382b6a86c5034c22fc