civitai-sync is a tool to download and explore your Civitai creations.<hr /><ul><li>Download generations from the Civitai generator</li><li>Download posts from your public profile</li><li>Browse your creations offline, with the mini-website Explorer</li><li>Data and media is saved in date-ordered folders.</li><li>Auto-updates for new versions</li></ul>Like it? Give a thumbs-up or review. ❤️<hr />See comments below, and the discussion page for ideas and issues: <a target="_blank" rel="ugc" href="https://civarchive.com/articles/5676">https://civarchive.com/articles/5676</a>The program comes in 2 parts:<ul><li>Command Line Interface (CLI). It runs in your computer terminal or command prompt</li><li>Explorer, a mini-website to browse your creations.</li></ul>Civitai saves your generations for 30 days, so use the tool regularly. Read on for installation instructions.<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>”)<code> </code>to the program folder, as above.</li><li>Run it by typing: <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>For access to your account, you need a Civitai API key.<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 Domain &gt; civitai.redThis setting is visible for .red users who have "Enable Mature Settings" (18+) enabled 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 generations" and "Download posts".See “Options” to change what is download and where it is saved. Download Location: inside the program folder in "data" and "media"; you can change to another location. Choose: to make folders for your ❤️ favorited and 👍 liked gens, or to download only data.Latest: download your most recent creations. Or download just “Favorite / Liked” gens.<h3 id="open-the-explorer">Open the Explorer</h3>☞ Click "Start Explorer"<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>The program is normally run as: <code>npm run cli </code>To download from an alternative account, specify a unique name for it:<code>npm run cli bob</code>Change the download directory to be different for each account, unless you want the data and media for the accounts to be merged.<h3 id="problems-thoughts-get-in-touch">Problems? Thoughts? Get in touch</h3>Make a comment, start a chat. @monkeypuzzle

civitai-sync

This version requires you to authenticate your Civitai account with your "secret key" that you can get from your browser (e.g. Firefox, Chrome). When you run the app, choose "Show info" for details about the key.

Files with SHA256: 9ec2869fe1afac55b3307d54d7263245dd508953decccb2eb2a1eee5604c0881