KK Library Scene & Card Manager
All guide pages

Library

KK Library shows your Koikatsu scenes, character cards and outfits as a grid you can narrow, sort and select from, with each asset's details in the inspector.

Where to find it
Scene, Character and Outfit at the top of the main window

What it is

#

KK Library shows the Koikatsu scenes, character cards and outfits (coordinate cards) in your library as a grid of tiles. It shows one mode at a time. Each mode remembers its own sidebar choice, search, selection, scroll position and sort order.

The grid shows files in your library. A new file appears after a sync. The refresh button reads your library again, but doesn't scan folders. Use the search bar to find an asset by name, tag or author. Get started shows the main window's parts.

What it can do

#

Read a tile

#

Each tile shows the asset's name, author, game, size and one date. Marks on the tile tell you more.

The Favorites grid. The animation badge with the length 0:05 is marked 1, a tile's name 2, its author line 3, its game and size line 4 and its last line 5, which reads Created and a date
PartWhat it tells you
Badge (1)The scene is animated. When KK Library knows how long it plays, the badge shows the length, here 0:05 (Scenes)
Name (2)A scene shows the Title you gave it in the inspector, or its file name until you give one. A card shows the character's name. An outfit shows the name saved inside it, so 制服.png can show 学生服
Author (3)A plain name is a confirmed author. A name in italics is only a suggestion. (Unknown Author) means there is nothing to suggest
Game and size (4)A scene also shows how many characters it holds
Date (5)The date the grid is sorted by: Updated, Added or Moved to Trash. Every other order shows Created
Note iconThe asset has a note. Point at the icon to read it
ClockKK Library is still analyzing the file. Until it finishes, the inspector shows Analyzing and you can't change the rating, favorite or author
File missing or Moved to TrashThe file is gone, or you moved the asset to the Trash

Pictures load as tiles come into view, so a fast scroll can show empty tiles for a moment.

#

The sidebar's Library list shows one part of the mode. Tags and Authors below it narrow the grid by tag or author.

RowWhat it shows
All scenesEverything in the mode except the Trash. It reads All characters or All outfits in the other modes
Recently addedWhat KK Library found in the last 14 days, by Added date. A scene saved years ago but downloaded this week is recent
DuplicatesEvery file that has an exact copy. Its number counts each of those files (Similar and duplicates)
FavoritesThe assets you starred (Tags, ratings and favorites)
UntaggedThe assets with no tag at all
Missing filesThe assets whose file the last sync couldn't find (Find missing files)
TrashThe assets you moved to the Trash (Trash and removing files)
  • The numbers count the whole mode and ignore the search, so the grid can show fewer.
  • Tags lists your tags by category, and Authors lists your authors. Select one to search by it (Search by tag or author). Manage opens the Tag Manager or the Author Manager.
  • When a change takes an asset out of what the grid shows, its tile leaves. Take the star off a scene in Favorites and it goes. The Trash keeps its tiles in view.

Choose an order

#

Sort by a date, a name, File name or File size. Each mode has its own name orders.

The Sort by box open in Scene mode, with Scene title marked 1, File name 2 and Duration 3
OrderModeHow it sorts
Created date, Updated date, Added dateAllBy the dates in How KK Library dates a file
Scene title (1)SceneBy what scene tiles show: your title, or the file name
First name, Last name, NicknameCharacterBy the card's names. The nickname isn't on the tile
Outfit nameOutfitBy the name saved inside the outfit
File name (2)AllBy the file name only, not the folder, so files with the same name sit together
File sizeAllBy the size of the file
Duration (3)SceneBy how long each scene plays. Static scenes count as 0:00, and so do scenes you marked Animated or Static by hand (Scenes)
Date moved to TrashTrash onlyBy when you moved each asset to the Trash

Each row of the Library list remembers its own sort in each mode. Recently added starts on Added date, the Trash on Date moved to Trash and the others on Created date, newest first.

See and change one asset or many

#

Select a tile to see its details in the inspector on the right, or select several to change them together.

  • At the bottom of the inspector, Open folder opens the file's folder and Copy path copies its path. Mod dependencies lists the mods the asset needs (Mods).
  • More actions at the top holds the other commands for the asset.
  • Right-click a tile to send it to the game or add it to the Quick List. When the tile has a confirmed author, Edit author in Author Manager opens that author (Authors).
  • Press and drag anywhere in the grid to scroll it, and flick to keep it moving.

How KK Library dates a file

#

KK Library keeps three dates for each file, and you can sort by any of them.

DateWhat it is
Created dateThe oldest of three: the date in a file name the game wrote, like 2026_0628_0756_05_632.png, the day the file was created and the day it was last written. A copy gets a new created day, so the oldest date is closest to when the file was made. A renamed file keeps the date from its old name
Updated dateThe day the file was last written. File Explorer shows it as Date modified, so you can check it against the file
Added dateThe day KK Library first found the file. A later sync, even a full sync, keeps it

How to do it

#

Show one part of your library

#
The sidebar's Library list with Favorites selected. Recently added is marked 1, Favorites 2, Untagged 3 and Missing files 4
  1. Choose Scene, Character or Outfit at the top of the main window.
  2. In the sidebar's Library list, select Recently added (1), Favorites (2), Untagged (3) or Missing files (4). The grid shows only those assets.
The search bar with the Favorites chip marked 1
  1. The search bar shows your choice as a chip (1). Any search you had stays.
  2. To see everything again, select the ✕ on the chip, or All scenes at the top of the Library list.

Sort the grid

#
The sort bar. The Sort by box is marked 1, the direction button 2 and the Size slider 3
  1. Select the box beside Sort by (1) and choose an order.
  2. To reverse the order, select the button beside it (2). It reads Descending ↓ or Ascending ↑.
  3. To change the tile size, move the Size slider (3).
The Sort by box set to Updated date, marked 1, above two tiles. A tile's last line, marked 2, reads Updated and a date
  1. Check the last line of a tile (2). It names the date the grid is sorted by, here Updated date (1).

See an asset's details

#
The inspector with a scene selected. More actions is marked 1, the file name 2, Title 3 and Created date 4
  1. Select a tile. The inspector on the right shows it.
  2. To see the dates, scroll the middle of the inspector down to Created date (4). Updated date and Added date are below it.
  3. To rename the file, select its name (2), enter the new name and press Enter. The file on disk is renamed.
  4. To give a scene a title, select No title beside Title (3), enter the title and press Enter. The title is kept in your library, not in the file.

More actions (1) holds the other commands for the asset, like Open in new window.

Keep an asset open in its own window

#
The More actions menu open, with Open in new window marked 1
  1. Select a tile.
  2. Select More actions at the top of the inspector, then Open in new window (1).
  3. A window named Inspector: and the file name opens. It keeps showing that asset while you select others in the grid, and you can make changes in it.

Select several assets

#
  1. Select a tile. Ctrl+click adds or takes away one more, and Shift+click selects every tile between.
  2. To select everything the grid shows, including the tiles further down, press Ctrl+A.
The inspector with several scenes selected. The count is marked 1, Favorite 2 and Move to Trash 3
  1. The inspector says how many are selected (1). A change there applies to all of them.
  2. To star them all, select Favorite (2). It turns gold when all of them are favorites, and selecting it then takes the star off all of them.
  3. To move them to the Trash, select Move to Trash (3), or press Delete while the grid has focus. The files stay on disk.
  4. To clear the selection, click an empty part of the grid.

Use keyboard and mouse shortcuts

#

Keyboard shortcuts work in the part of the window you selected last. Select a tile before using the grid shortcuts. The table also lists mouse actions for selecting tiles and sidebar rows.

KeyWhat it doesWhere
Arrow keys, Home, EndSelect the next, first or last tile. Hold Shift to select every tile betweenGrid
Ctrl+click, Shift+clickAdd or take away one tile, or select every tile betweenGrid
Ctrl+ASelect every asset the grid shows, including the tiles further downGrid
DeleteMove the selected assets to the Trash. The files stay on disk (Trash and removing files)Grid
Ctrl+click, Shift+clickAdd a tag or author to the search or take it away, or select every row betweenTags and Authors in the sidebar
BackspaceRemove the last chip when the box has no textSearch bar
EnterSave a new file name, title or note. In a note, Shift+Enter starts a new lineA box in the inspector
EscHide every KK Library window (Hide KK Library at once). With Panic key off, Esc closes a list, cancels an edit or clears the search text (Use Esc for lists and boxes)Any window
EnterLoad the selected asset through CharaStudioQuick List
DeleteTake the selected asset off the list. Its file staysQuick List

Checked with KK Library 0.1.0-beta.9.1