Civitai Companion for Windows
A small desktop app that keeps an eye on your Civitai account, so you don't need the website open.
Version 1.0.25 · Windows 10/11 x64
[Download the latest release](https://github.com/Tar-Tarj/Civitai-companion/releases/latest) · [Source code on GitHub](https://github.com/Tar-Tarj/Civitai-companion)
Features
- Account at a glance: avatar, username, Blue / Yellow / Green Buzz balances and new followers today.
- Notifications: comments and replies, followers, reaction milestones, Buzz tips, model updates, collections and more, with filters, previews of images and videos, and mark-as-read.
- Choose what you hear about: switch off any notification group and it is silenced and marked as read for you.
- Windows toasts and sounds: several events at once become one "N new notifications" toast. Pick a different sound for site activity, tips and followers.
- THANKS button: when someone tips Buzz on one of your images or videos, one click posts a comment that mentions them @username) followed by your own message. It is sent once per user and image, so nobody gets thanked twice. You write the message in Settings.
- Buzz ledger: received and spent Buzz for Blue, Yellow and Green, with linked image previews.
- Tray app: keeps syncing in the background, with Show, Sync now and Quit in the tray menu. Optional start with Windows.
- Backup: export and import your preferences.
All links open on civitai.red, the full version of the site.
Download
Get one of these from the [releases page](https://github.com/Tar-Tarj/Civitai-companion/releases/latest):
- Setup (installer): normal installation.
- Portable: a single .exe, no installation needed.
The builds are not code-signed yet, so Microsoft SmartScreen may show a warning. Compare the file with the SHA-256 values in SHA256SUMS.txt on the release page if you want to verify it.
Setup
1. Create an API key at https://civarchive.com/user/account/security .
2. Open the app, go to Settings → Account & Security and choose Configure API key.
3. Paste the key and run Test connection.
API key permissions
| UserRead | Your account, avatar and username |
| BuzzRead | Buzz balances and the ledger |
| NotificationsRead | Notifications and unread count |
| NotificationsWrite | Marking notifications as read |
| MediaRead | Thumbnails in notifications |
| SocialWrite (optional) | The THANKS button, which posts a comment for you |
Without SocialWrite everything else works and the THANKS button stays disabled. To add it later, create a new key with that permission and replace the old one in the app. Settings shows which permissions your key currently has.
Civitai limits comments to roughly 10 per hour. The app only posts when you click THANKS.
Privacy
- Your API key is stored in Windows Credential Manager and never reaches the app interface.
- No telemetry, no analytics, no automatic updater, and no browser or cookie access.
- The app talks only to Civitai. Preference backups never contain your API key.
Open source
The full source is public so you can read exactly what it does. If I ever stop maintaining it, anyone can inspect the code or adapt it to future Civitai API changes.
I built this tool because I needed it myself. Feedback is welcome.
Description
Civitai Companion 1.0.27
Windows 10/11 x64.
New
Update check: once at startup the app looks for a newer release on GitHub and shows a small card (Go to GitHub / Maybe later). It is silent when you are up to date and can be switched off in Settings > Behavior. Nothing is downloaded.
THANKS is optional: the button is off by default (Settings > Notifications & Sounds) with a warning about Civitai's comment limits. A new "Mark all tips as thanked" button records tips you already thanked by hand.
Buzz Dashboard: renamed from Buzz transactions, with a link to the website dashboard, a compact balance, a shop icon on sales and rewards split into Liked and Collected.
Notifications: remix and sticker placements open the placements panel (pending) or the image (resolved) and appear in Miscellaneous; Crucible, bounty, post and featured-image notifications now open their page; models, articles, posts and bounties show a cover preview; new icons for remix, Crucible and articles.
Window: the app remembers its size; the opening size is the minimum.
Usability: "back to top" button on long lists, SAVED! confirmation when a setting changes (and settings pages keep their scroll position), F3 no longer opens the WebView search, F5 also refreshes notifications. GitHub link in About.
Fixed
Toasts reporting too many new notifications: the server sometimes re-serves old notifications, which were counted as new. Only notifications created since the previous sync are announced.
Reset cached data now keeps the thanks history and reloads your account at once, without Test connection.