# KK Library 0.1.0-beta.9.1

Released 2026-11-20

## Highlights

- **Search for exactly what you want.** Set a tag or author chip to NOT to hide what matches, or start
  a word with `-`. Search one field with a key like `filename:` or `title:`. Filter scenes by how long
  they play, or show only static scenes.
- **Export and import your library data.** Save your tags, ratings, favorites, notes and authors in
  one file. Import it on this PC or another one, and see what will change first.
- **Missing files keep their place.** A file that's gone from disk shows on the Missing files shelf
  with its tags. Put it back, or select Locate file… to show where it is now.
- **Authors are easier to manage.** Give an author aliases, and add links that show each site's icon.
  Right-click an author to open them in Author Manager. Dismiss merge suggestions you don't want, and
  list folder names that should never become an author.
- **Choose what loads in the game.** Load Asset Settings picks which parts of a card or outfit load,
  such as face, body, hair, outfits and accessories. KK Library asks before it opens the game, and the
  character editor takes cards of either gender.
- **Tags for each mode.** Choose whether a tag shows for scenes, characters or outfits. Set a tag color
  with a code like `#4A7BD8`.
- **Faster with big libraries.** Find similar takes seconds where it took minutes. Syncs are faster,
  and Trash jobs show progress with a Stop button.
- **Also fixed.** Thumbnails that stayed blank until you scrolled, a scene showing another scene's
  picture, Chara Maker refusing a card of the other gender and a freeze when selecting many authors.

## All changes


### Added

- Export your library data with **File ▸ Export library data…**. The file includes your tags, ratings,
  favorites, notes and authors. Import it on this or another computer with **Import library data…**.
  Review the changes before importing. If the file names folders that aren't in your library, choose
  which ones to add. KK Library adds and syncs them before importing. Select **Clear library data first**
  to rebuild your library from its folders before importing.

- **Remove from library…** takes assets out of your library but keeps their files on disk. Select
  **Also delete the files from disk** to delete them too. A kept file returns to your library at the
  next sync if it is still in a library folder.

- A missing file stays in your library with its tags, ratings and notes. Find it on the **Missing files**
  shelf. Put the file back and sync, or select **Locate file…** to show KK Library where it is now.
  **Locate files…** finds several missing files in one folder. You can also remove the asset from your
  library.

- If a library folder is deleted, its files show as missing. **Manage library folders** identifies it.
  If a drive letter points to a different drive, KK Library treats the folder as disconnected and
  keeps its files in your library.

- Tag and author chips in the search bar start with **IS**. Select **IS** to change it to **NOT** and
  hide matching assets. The **Animated**, **Mods** and **Missing file** filters work the same way. Start
  a search with `-` to exclude a word, tag or author.

- Search a specific field by putting its key before your text: `filename:`, `filepath:` or `text:`.
  For scenes, use `title:`. For character cards, use `firstname:`, `lastname:` or `nickname:`. For
  outfits, use `outfitname:`. You can use `*` and `?` in a value, for example `filename:maid*`.

- Animated scenes show their length in the inspector's **Duration** row and on the tile's animation
  badge. Sort by **Duration** or filter by length.

- Choose which parts of a card or outfit load in the game with **Load Asset Settings**. Open it from
  **View ▸ Load Asset Settings** or the Quick List. Choose face, body, hair, outfits, accessories, ABMX
  bone edits or overlays. Outfit parts load only when the game has Coordinate Load Option.

- KK Library asks before it opens Koikatsu or CharaStudio to load something. Select **Don't ask
  again** to stop the question. You can turn it back on in **Settings**.

- When KK Library is in Japanese, its plugin shows in-game messages in Japanese too.

- Organize files now has a **Gender / Author** preset for character cards. It puts cards in a
  `female` or `male` folder, then in a folder named for the author. Outfits already had this preset.

- Organize files can move files to another drive. KK Library copies each file and checks the copy before
  deleting the original. If a move stops early, it finishes the next time you open KK Library.

- Select ✕ to stop a move, copy or undo in **Organize files**. Closing the window or KK Library stops
  it too. **Undo** counts the files it puts back. Select it again to put back the rest.

- In **Tag Manager**, use **Show in…** to choose which modes list a tag: scenes, characters or outfits.
  Assets keep all their tags. The **Mode** box shows one mode's tags.

- Add aliases from **Aliases…** in an author's profile menu, then select **Save**. Search finds the
  author by any name. A folder named with an alias suggests that author. Point to the author in the
  sidebar to see their aliases.

- Choose **Links…** from an author's profile menu to add, name, reorder and remove their links. Each
  link shows its site's own icon. Right-click a link to copy it instead of opening it.

- Right-click an author in the sidebar, on a tile or in the inspector to open them in **Author
  Manager**.

- To stop suggesting an author for a remembered folder, open the author in **Author Manager**. Select
  **More actions**, then **Folders…**.

- Add folder names or words to **Never suggested as an author** in **Settings**. KK Library won't
  suggest them as authors. It already skips the game's folders, cache and Trash folders. It also skips
  folders created by Organize files.

- Author Manager and Tag Manager no longer suggest a merge after you dismiss it. Choose **Dismissed
  suggestions…** to see it again.

- Enter a color code, such as `#4A7BD8`, to set a tag color.

- Select the **Mod dependencies** heading in the inspector to open or close the list. KK Library
  remembers your choice.

- Problem messages now show details and a **Copy details** button. Copy the details when you ask for
  help. You no longer need to find `crash.log`, and messages use plain language.

### Changed

- If KK Library is pinned to your taskbar, pin it again. A pin from an earlier version opens a second
  taskbar button when KK Library runs. Right-click the old pin and unpin it, then pin the running app.

- On first launch, beta.9.1 upgrades your library data before opening the main window. A
  **Preparing your data…** screen shows progress. KK Library saves a restore point before the upgrade.
  Find it in **Settings** under **Library restore points**.

- Some menu names have changed: **Author Management…** is now **Author Manager…**, and **Tag Management…**
  is now **Tag Manager…**. **Full rescan** is now **Full sync**, and **Rescan mods** is now **Sync mods**.
  **Add library** is now **Add library folder**, and **Manage libraries** is now **Manage library
  folders**. Colors, icons and notices are now consistent across windows.

- Esc now hides every KK Library window, even when a menu is open. The notification area icon stays
  available while KK Library runs. Use its menu to show or hide the app, or open Quick List, Author
  Manager or Tag Manager.

- The character editor now accepts cards of either gender. Loading a card of the other gender changes
  the character to match. Koikatsu sets up the editor's sliders when it opens, so they do not change
  and some may not fit the new character.

- Every window now shows the same game status, such as **Connected to CharaStudio** or **Choose your
  game folder**.

- The game-load notice now uses a Windows notification. Select it to bring the game to the front.

- **Find similar** now takes seconds instead of minutes on a large library. On the **Scene** and
  **Outfit** tabs, each group contains one file and similar files. The **Similarity** slider ranges
  from 70% to 95% and starts at 75%.

- When **Review duplicates** moves copies to the Trash, the kept copy gets the tags, favorite and notes
  from those copies. **Recommended** now depends on your work on each copy and its dates, not its name or folder.
  Organize files keeps the same copy. **Duplicates** now counts every file that has a copy.

- A tile now shows the date you sort by. In the Trash, the inspector shows when an asset was moved
  there. **Updated** always means when the file was last written, the date File Explorer shows as
  Date modified.

- Organize files now moves files only into your library. If a destination is outside it, KK Library
  asks to add that folder first. **Copy as Backup** won't copy into a library folder, so files don't
  appear twice. Library folders can no longer sit inside one another. Adding a folder that contains
  library folders replaces them and keeps your tags and authors. Sync also checks files outside your
  library folders and shows files no longer on disk as missing.

- A file you move in File Explorer now suggests the author of its new folder after a sync. A confirmed
  author stays.

- Before removing a library folder, KK Library tells you how many assets will leave your library,
  including assets in Trash. Removing a large folder no longer freezes the window. KK Library also
  asks before assets leave your library when you ignore a folder in Settings.

- Extracting characters or outfits into a folder you ignore in Settings now asks first.

- In Trash, **Restore all** and **Delete all permanently** act only on the assets shown by your search.
  Their labels show how many assets they will affect.

- Moving assets to Trash, restoring them and reviewing duplicates now show progress and a **Stop**
  button. They run faster, and the window stays responsive during large Trash operations.

- A sync with nothing to do is much faster with many library folders. New duplicates and search matches
  appear while sync runs, and the window stays responsive afterwards.

- Adding, renaming and searching authors stays fast as the author list grows.

- After an edit, selected files that no longer match your search or filter leave the grid at once. They
  stay selected so you can keep editing them.

- Closing KK Library with unsaved changes asks about each window that has them.

- Counts, sizes and rates of 1,000 or more now use a comma, including the search bar's size chip. A file
  just under 1 MB reads 1 MB instead of 1024 KB. English counts use the right singular or plural form,
  such as "1 author" instead of "1 authors".

- A message about a problem now has a Close button instead of OK. Enter closes any message with one
  button.

### Fixed

- Tags now stay with a file in more cases when you move or rename it outside KK Library: between
  library folders, into a folder you add later or over another file with the same name.

- A library folder reached through a folder link lists each file once. Links that point back up their
  own path no longer stop sync. Deleting a linked copy no longer deletes the original file.

- A folder KK Library can't open is skipped and named in the sync report. Its files no longer show as
  missing.

- A whole drive, such as `D:\`, can now be a library folder. Sync counts its assets, skips unchanged
  files and suggests authors.

- A folder added twice with different capitalization or with and without a final `\` no longer lists
  its files twice.

- A renamed file keeps its Created date.

- KK Library no longer closes if a search starts with certain rare characters or emoji, another app
  holds the clipboard during a copy or you resize the window during sync. If KK Library can't read a
  library file, it shows a message instead.

- Tiles no longer stay blank after a mode switch, a sync or while scrolling a large grid. Scrolling up
  after sync no longer freezes the grid.

- Select all now shows the tags and rating shared by the selected assets. Tiles stay selected as you
  scroll through them.

- Author Manager and Tag Manager now open over the main window. A detached inspector stays on screen,
  and a message opens over the window you are using.

- Dates now read the same under any Windows region setting. Organize files no longer writes Thai or
  Saudi years in folder names.

- Repeating **Copy as backup** no longer copies files twice. Folder names keep any braces you type.

- Organize files no longer freezes when a drive or network folder doesn't respond. Files that trade
  places no longer both get `(2)` in their names. If one file in a swap can't move, the others return
  to their original folders.

- The free space warning in Organize files now includes the whole operation, including backup copies.

- Organize files now explains why it can't move a file.

- Organize files no longer adds a code to an author's folder after you delete or merge another author
  with that name.

- Deleting an author in the Authors panel now also deletes the author's downloaded picture, as Author
  Manager does.

- Selecting many authors no longer freezes KK Library. Arrow keys move from the selected author.
  Typing a new author's name creates that author. Saved links keep the text after `?` or `#`. Author
  Manager updates when sync finds new files.

- Sync still shows warnings about unreachable folders and missing files when it finds new authors.

- Cards can be saved while KK Library reads them. A failed texture preview no longer erases an earlier
  edit.

- Selecting text in the inspector no longer scrolls it. A detached inspector now shows Trash moves at
  once.

- A trashed asset leaves the Quick List.

- Extracting no longer overwrites a file that appeared after you opened the window.

- Adding the first character after CharaStudio opens no longer shows an error.

- Game errors now appear in plain language instead of code words.

- KK Library now replaces incorrect thumbnails without clearing the cache.

- What's New now offers **Open in browser** if it can't show a page in its window.

## What KK Library does

KK Library is a free Windows app for your Koikatsu and Koikatsu Sunshine scenes, character cards and
outfits. It reads the folders you choose, so you can browse, search, tag and clean them up without
opening the game.

- One library across all your folders, read straight from the scene, card and outfit files.
- Scene, Character and Outfit modes, each with its own grid, filters and details.
- Search by name, folder, tag, author or note, and hide what you don't want.
- Tags, ratings, favorites and authors for one asset or many. KK Library suggests authors from your
  folder names and a list of known creators.
- Review duplicates finds exact copies and Find similar finds look-alikes. Files you move to the
  Trash can be restored.
- Organize files sorts your files into folders by author or tags. It shows a preview first and can
  undo the last run.
- Load a scene, card or outfit into CharaStudio or the character maker through the KK Library plugin.
  Add a scene to the one already open, or see which mods an asset needs and which are missing.
- English and Japanese, R-18 blur and an Esc panic key that hides every window.
- An optional check for new versions.

## Good to know

- Windows may show an "unknown publisher" or SmartScreen warning, because this build isn't
  code-signed. It is safe to run. You can check the ZIP against `SHA256SUMS.txt`.
- Sync only reads your files. Files in the Trash stay on disk, and Organize files shows a preview and
  can undo.
- Some menus have new names, such as Full sync and Author Manager.

## Install / update

- Unzip anywhere on Windows and run `KKLibrary.exe`. It's portable, with no installer.
- To update, replace the app's folder with the new one. Your library and settings are kept outside
  that folder, so they stay.
- The first launch of a new version upgrades your library data and saves a restore point before it
  starts.
