KK Library Scene & Card Manager
All guide pages

Common questions

Answers about KK Library setup, files, duplicates, tags, authors and Koikatsu.

About KK Library

#

Is KK Library free?

#

KK Library is free to download and use. You don't need an account.

Is KK Library Windows only?

#

Yes. KK Library runs on 64-bit Windows 10 and Windows 11. There is no Mac or Linux version.

Does KK Library work with Koikatsu Sunshine?

#

Yes. KK Library reads scenes, character cards and outfits from both Koikatsu and Koikatsu Sunshine. It has a plugin for each game. Find similar compares a file only with files from its own game.

Do I need Koikatsu installed?

#

No. KK Library reads your files without the game. It needs your game folder only to load files into the game and to see which mods you have installed. More in Install the plugin.

Is KK Library safe?

#

Yes. KK Library only reads your files when it syncs, and changes them only when you ask (below). It doesn't send your scenes, cards, outfits, tags, ratings or favorites to an online service. It isn't code-signed, though, so Windows may warn Windows protected your PC the first time you open it. Download and open KK Library shows how to open it anyway and how to check your copy.

Where do I download KK Library?

#

KK Library downloads from its home page as a ZIP. Extract it and open KKLibrary.exe. There is nothing to install. Update KK Library when a new version is available.

Files and sync

#

Does KK Library change my files?

#

No. Sync reads your files. KK Library moves, renames or edits them only when you ask, for example with Organize files. Tags, ratings, authors and notes stay in your library data, not in the asset files. KK Library puts its plugin in the game folder when you connect it.

Which files does KK Library read?

#

KK Library reads scenes, character cards and outfits (coordinate cards) from Koikatsu and Koikatsu Sunshine. Files from Koikatsu Party, the Steam version of Koikatsu, count as Koikatsu. A sync looks only at PNG files, and it leaves out:

  • other PNG files, like screenshots
  • folders named _autosave
  • cards from other games, like AI-Shoujo, Honey Select 2 or Emotion Creators

A .zipmod file isn't an asset. KK Library reads your game's mods only to see which ones you have. See How a sync reads your folders.

Will KK Library cope with a large library?

#

Yes. In one test, KK Library synced 100,000 small test files in under two minutes. A real library on a hard drive, about 11,000 files and 240 GB, took under 50 minutes. These are examples, not promises. Time depends on your drive and files. The first sync reads every file to the end. The first step, which fills the grid, took one to three minutes. In the 100,000-file test, search showed results in under half a second and a sync with no changes took under six seconds. See Can I use KK Library while a large library syncs?

Can I use KK Library while a large library syncs?

#

Yes. You can browse while KK Library syncs. Analyzing assets (2/2) reads each file to the end and takes most of the time. If you close KK Library, sync continues the next time you open it. See How a sync reads your folders.

Why does KK Library use disk space?

#

KK Library keeps its own files in %APPDATA%\KKLibrary, apart from your scenes and cards. They are the library file, the thumbnail cache, restore points and edit backups. Storage and data in File ▸ Settings shows how much space each of them takes.

  • The thumbnail cache holds up to about 1 GB. You can clear it, turn it off or move it to another drive. See Thumbnail cache.
  • Library restore points hold your library file as it was before an upgrade or an import. KK Library also saves one when you start with a new library. It never deletes them by itself, so delete them when you no longer need them. See Restore points and edit backups.
  • Edit backups and removed animation data clear themselves after a while.

Does a file keep its tags when I rename or move it?

#

Yes, if you rename it or move it to any of your library folders. Select Sync and KK Library finds it again. If you move it outside your library folders, it shows File missing. Use Locate file to reconnect it and keep its library data (Locate a missing file).

Can I hide missing files when I browse?

#

Yes. KK Library hides them when you add the Missing file filter and turn its chip to NOT. Steps in Use Advanced filters.

How do I back up my library?

#

Close KK Library and copy the KKLibrary folder in %APPDATA%. It contains your library data, settings, author pictures, edit backups and the thumbnail cache stored there. A cache moved to another drive isn't included (Back up your library). An export is smaller. It holds your tags, ratings, authors and notes. It also works on another computer, because import finds files by their contents (Save your library data to a file). Neither one holds your scenes, cards or outfits, so back those up yourself.

Can I move my tags to another computer?

#

Yes. Export your library data, then import it on the other computer. The export does not include scene, card or outfit files, so copy those separately (Move your tags to another computer).

Why does Organize ask to add a folder?

#

KK Library syncs only library folders. If you move a file elsewhere, it can't find later changes to that file. Move files offers to add the destination folder to your library. See Move files to a folder outside your library.

Similar and duplicates

#

How do I delete the copies on one drive?

#

Enter a pattern like D:\* in Review duplicates to show groups with a copy on that drive. Choose which copy to keep. Select all recommended does not account for the drive. Follow Delete the copies on one drive.

Does Find similar compare pictures?

#

For scenes, KK Library compares the picture along with the mods, the map and the number of characters. The picture alone never makes a match. It compares character cards by their face and body, and outfits by their clothes. See What each tool compares.

Why aren't two scenes with the same picture duplicates?

#

Review duplicates lists files with identical contents. Two scenes can share a picture and have different scene data, so they aren't exact copies. See How KK Library compares files.

Authors

#

Why is the same author suggested for many files?

#

KK Library uses folder names to suggest authors. Add a folder name to Never suggested as an author in Settings (Never suggest a folder name as an author). You can also remove a remembered folder. For folders with several authors, select Don't suggest this author during review. See Review suggested authors.

Can an author have more than one name?

#

Yes. Add an alias in Author Manager. Search finds the author by any alias, and matching folder names suggest that author. See Add an alias to an author.

How do I stop KK Library suggesting a merge?

#

Select Don't suggest again on the pair's row. See how to ignore an author merge or dismiss a similar tag suggestion.

The game and the app

#

Can I open a male card in the female character maker?

#

Yes. The character keeps the card's gender, but some sliders may not fit the maker you opened. With the game closed, Edit in Koikatsu opens the matching maker. See Load a card or outfit in the character maker.

Does the plugin work in the main game or Free H?

#

The plugin loads files in CharaStudio and the character maker, not in Free H. Files sent from other game screens wait until you open the character maker. A card dragged from the Quick List uses the Drag & Drop mod if it is installed. See Where each asset loads.

Does KK Library download missing mods?

#

No. KK Library lists required and missing mods. You install them yourself. For a missing mod, KK Library opens its website or searches Google if the file has no link. See Find a missing mod.

Can I fold the mod list in the inspector?

#

Yes. Select Mod dependencies to close the list in every inspector. The heading still shows how many mods are missing (Close the mod list).

Can I open the Quick List from the notification area?

#

Yes. Select the KK Library icon in the notification area, then choose Quick List. The menu also opens Author Manager and Tag Manager (Use the notification area icon).

When something goes wrong

#

How do I report a problem?

#

Post it in the KK Library thread on the KKnow forum. The Support link goes there, and so does Support / feedback in Help ▸ About KK Library. Include:

  • your KK Library version. It shows in Help ▸ About KK Library and under Updates in File ▸ Settings.
  • what you did and what happened, step by step.
  • the details, if KK Library showed a message with Copy details. Select it and paste the text into your post.

If KK Library closed without a message, attach crash.log from %APPDATA%\KKLibrary. If the problem came while KK Library opened your library, for example at Preparing your data…, attach migration.log from the same folder too. The details and the logs can name your files and folders, so read them before you post.

What if KK Library says a newer version made the data?

#

You opened an older KK Library after a newer version upgraded your library. The older version can't read it. It shows A newer version made this data and leaves your library file unchanged. Do one of these:

  • Install the newer version again. Get the newer version opens the download page.
  • If you still have the library restore point from before the upgrade, go back to it. Changes you made after the upgrade aren't in it. See Go back to a library restore point.

Why does an author still show after their files are gone?

#

An asset whose file is gone stays in your library. It keeps its tags and author until you locate the file or remove the asset. So the author's count in the Authors list still includes it. Select Missing files in the sidebar to see these assets. See Find missing files.

Checked with KK Library 0.1.0-beta.9.1