Koikatsu & Koikatsu Sunshine
Free. Made by someone who got fed up with the whole scenes and cards folder mess.
Local app. Portable ZIP. No account. No telemetry.
Current release
Windows SmartScreen may warn on first launch. No malware.
Main window: scene grid, search, tags, authors and
inspector
What is it
If you have used KK or KKS for a while, your collection is probably a mess: nested folders, vague names, duplicate downloads, repeated saves and a lot of files you don't even remember anymore.
KK Library is a local desktop app that helps scan those folders, show what is inside, find duplicate or related files, clean up tags and author names and organize everything without opening each file in-game.
| Price | Free. Forever |
|---|---|
| Supports | Koikatsu and Koikatsu Sunshine (but not required) |
| OS | Windows 10 (x64) and Windows 11 (x64) |
| Size | ~130 MB (~52Mb zipped) |
| Free space | At least 150 MB for the app itself |
| Installation | Not required. Portable ZIP |
| Network | Not required (unless you want to) |
| Languages | English and Japanese |
If you liked the app, your support is appreciated.
Find assets across your folders
Switch between Scene and Character views, then search, filter and inspect your collection in seconds.
Main library view in Scene mode
Find duplicates and similar files
This is likely what you have been looking for. Find and get rid of all those duplicated scenes or variants without losing what is important to you.
Exact duplicate review in Scene mode
Tags, ratings, favorites and all that
Add tags, clean up author names and keep your own ratings and favorites attached to each file.
Tags, ratings, favorites and author
Edit character cards without the game
Open a clear view of the card's profile and appearance. Edit what you want without launching Chara Maker.
Character mode management
More tools
Build a cleaner folder layout for scenes or cards. Preview the full plan before moving files or copying a backup.
Open scenes in CharaStudio. Add or replace characters and send cards to Chara Maker for editing.
Mark scenes or cards Safe or R-18 and blur previews. Hide everything to the tray with Esc key.
Tags, ratings and authors stay attached through moves, renames, re-packs and edits made outside the app.
Select a pile of scenes or cards and tag, rate or fix the author on all of them at once.
Built for oversized, messy collections. Large scene and card libraries stay quick to browse and search.
Update supported profile details without opening Chara Maker. KK Library backs up the card before writing changes.
Preview, export or replace textures. Edit supported materials and overlays with every change reviewed before saving.
Stage scenes and cards while browsing, keep the list above the game and drag files straight into CharaStudio or Chara Maker.
F.A.Q
It's safe, it's just not code-signed. A signing certificate costs money every year and this is a free side project, so Windows SmartScreen flags it the same way it flags any small unsigned app. Choose "More info → Run anyway" to start it. If you want to be sure first, check your download against the SHA-256 on this page. Since the app is portable and offline, you can run it from a throwaway folder or a VM and watch what it does.
It does not touch your mods or saves. The one thing it adds to your Koikatsu folder is a small bridge plugin (in BepInEx/plugins), installed when you connect your game so the CharaStudio and Chara Maker actions can work. It sits alongside your other plugins and changes nothing else. If you never connect the game, it does not write there at all.
No. You can scan, browse and manage scene and character card files without the game. Koikatsu is only needed when you want to open something in CharaStudio or Chara Maker.
Scanning only reads files. It never changes them. File changes happen only when you choose an editing or organizing action. Deleting sends scenes and cards to a Trash you can restore. Organize shows the full plan first and its moves can be undone. Card editing keeps a backup so you can restore the original.
No. KK Library does not upload your scenes, character cards, tags, filenames, folder structure or other library data. There is no account and no telemetry. Your collection stays on your PC.
When a newer version is out, the app shows a small note with a download link. You grab the new ZIP and replace your old folder (Your settings and data stay where they are). Nothing installs or updates itself in the background.
It is portable, so there is nothing to uninstall: delete the folder and it is gone, with no leftovers. To carry your work across, export your tags, ratings and authors to a file and import it on the other machine (or after a re-pack).
Full Feature List
A closer look at what KK Library can do, where to find each tool and when it was added.
Scenes and character cards are supported now. Outfit support is planned, not available yet. "Early beta" means the feature shipped before this site started tracking every addition in detail.
| Feature | What it does | Where | Available since |
|---|---|---|---|
| Scene and Character libraries | Browse scenes and character cards in their own views, all from one catalog. | Scene and Character tabs | beta.6 |
| Folder scanning | Scan one or more folders into a single searchable library. Mixed folders are fine. | Main window, Add Library, Manage Libraries | Early beta |
| Scene details | Read the preview, cast, map, date, animation status and other details without opening the game. | Grid cards, Inspector | Early beta |
| Character card details | Read a card's name, profile, outfits, mod list and other details. Edit supported profile fields without opening Chara Maker. | Grid cards, Inspector | beta.6 |
| Card textures and materials | Browse, preview, export or replace textures. Edit supported material and overlay slots. Review every change before saving. KK Library backs up the card first. | Character Inspector / Advanced details… | beta.7 |
| Extract characters from a scene | Save characters embedded in a studio scene as regular character cards. | Scene Inspector / Extract characters… | beta.6 |
| Animated and modded scene detection | Find Timeline scenes, show modded or vanilla status and list required mods. | Grid badges, Inspector | beta.3 |
| Animated status correction | Mark a scene Animated or Not animated when automatic detection gets it wrong. Leftover Timeline data can be cleared and restored. | Scene Inspector / Animated | beta.7 |
| Background indexing | Start browsing quickly while indexing continues in the background. | Main window during Sync | Early beta |
| Installed / missing mod check | Check a scene's required zipmods against your Koikatsu install and mark each one installed or missing. | Inspector, Sync / Rescan mods | beta.5 |
| Reanalyze one scene or card | Refresh a scene or card after another tool changes it, without scanning the whole library again. | Inspector ⋯ / Force reanalyze | beta.7 |
| Inspector windows | Open several scene or card inspectors in separate windows and keep their edits in sync. | Inspector ⋯ / Open in new window | beta.7 |
| Feature | What it does | Where | Available since |
|---|---|---|---|
| Thumbnail library view | Browse scenes or character cards in a fast, resizable grid built for large libraries. | Main window | Early beta |
| Unified search and filters | Search by text, sort, filter and combine author, tag and "similar to" chips. | Top search bar, toolbar, sidebar | beta.3 |
| Faceted navigation | Browse by library, author, tag, favorites, duplicates and Trash. | Left sidebar | beta.3 |
| Sort and quick filters | Sort by name or date, reverse the order and show only animated scenes when needed. | Toolbar | Early beta |
| Feature | What it does | Where | Available since |
|---|---|---|---|
| Tags, ratings and favorites | Add color-coded tags, set Safe or R-18, blur previews and keep favorites for quick return. | Inspector, bulk panel, Tags sidebar, Favorites scope | Early beta |
| Tag management | Rename or delete tags everywhere. A multi-selection shows the tags shared by every selected item. | Inspector tag menu, bulk panel, Tags sidebar | beta.7 |
| Edits keep your library work | Tags, ratings, favorites and authors stay attached even when a scene or card is edited outside the app. | Across the library | beta.6 |
| Author management | Assign, confirm, rename, merge or remove authors, with "? Unknown" supported explicitly. | Inspector, Authors sidebar, Manage Authors | Early beta |
| Flexible author detection | Detect authors from folder layout, recognize known creators and tune rules per library. | During Sync, Manage Libraries, Settings | beta.4 |
| Feature | What it does | Where | Available since |
|---|---|---|---|
| Exact duplicate review | Group byte-identical files and let you choose which copy to keep. | Tools / Review duplicates | Early beta |
| Folder-based duplicate filters | Narrow duplicate and similar-scene results with path rules and wildcard matching. | Review duplicates, Find similar | beta.4 |
| Similar-scene review | Find scenes that look or behave like variations of each other, not just exact copies. | Tools / Find similar, Inspector / Find similar | Early beta |
| Character card duplicates | Find exact copies, the same character saved in different cards and close variants that reuse the same face or body. | Tools / Review duplicates, Find similar | beta.7 |
| Feature | What it does | Where | Available since |
|---|---|---|---|
| Trash bin | Move scenes or cards to Trash first, then restore or empty it later. | Inspector, Trash scope | Early beta |
| Organize Files | Build a folder layout for scenes or cards, preview the result and then move the files or copy them as a backup. The last move can be undone. | Tools / Organize Files | Early beta |
| Export / import my data | Back up and restore your tags, ratings, favorites and author work. | File / Export, File / Import | Early beta |
| Feature | What it does | Where | Available since |
|---|---|---|---|
| Open in CharaStudio | Send a selected scene straight into CharaStudio, with an option to import it into the scene already open there. | Inspector, scene tile menu | Early beta |
| Quick List | Add scenes and cards with the "+" side of the CharaStudio button. The window can stay above the game while you drag them into CharaStudio or Chara Maker. Clearing the current tab leaves the other tab untouched. | Quick List, Inspector, tile menu | beta.7 |
| Add or replace a character in CharaStudio | Send a character card into Studio, either as a new character or as a replacement for the one you selected. | Inspector, card tile menu | beta.6 |
| Edit a card in Koikatsu | Open a character card in the game's character editor, then come back with your changes still attached. | Inspector, card tile menu | beta.6 |
| Live CharaStudio load status | Show real progress while Studio starts and loads a scene, including queued loads and failures. | Status bar, Inspector | beta.5 |
| KK and KKS bridge support | Works with both Koikatsu and Koikatsu Sunshine when you point KK Library at the right game folder. | Settings, first-run setup | beta.6 |
| Bridge setup and updates | Configure the game folder once and KK Library keeps the bundled bridge installed and up to date for you. | Settings, first-run setup | beta.3 |
| First-run setup | Help new users connect Koikatsu and add their first library folder. | First launch, Settings | beta.3 |
If you liked the app, your support is appreciated.
