KK Library Scene & Card Manager
All guide pages

Search

KK Library's search bar finds the Koikatsu scenes, character cards and outfits you want by name, folder, tag, author or filter and leaves out the rest.

Where to find it
The search bar above the grid

What it is

#

The search bar finds scenes, character cards and outfits by name, folder, author or note. It searches the mode you're in and the files already in your library. Select Sync to find files you added since the last sync (Get started).

The search bar with the Favorites row and a file name term. The Favorites chip is marked 1, the IS word of the filename: 2026* chip 2 and Clear all 3

The bar shows your text and chips (1, 2). Each chip is a search condition, such as a tag, author or filter. Remove a chip to broaden the results.

What it can do

#

Common searches

#

The searches players ask for most take one or two steps.

  • To hide R-18, open Advanced filters and select Safe and Unrated under Rating.
  • To see one author's work, select them under Authors in the sidebar. Or enter their name and select them in the list.
  • To see only animated scenes, select Animated in the sort bar above the grid.
  • To see everything in one folder, enter filepath: and the folder's name, like filepath:Downloads.
  • To find files that need mods, select Mods in Advanced filters. Which mods are missing shows on each asset's Mods line.

Every key and filter

#

Type a key to search one field. Both spellings work in either app language, with a half-width or full-width colon. A key counts only at the start of the text.

You typeJapanese formModeWhat it findsExample
Any text, no keySameAllThe text anywhere in the file's path (every folder and the file name), a card's name and nickname, an outfit's name, the confirmed author's names and the Title and Notes you wrote. Not the names of a scene's charactersschool uniform
- at the start-AllLeaves out the word, or a tag or author you select in the list. A - anywhere else is a letter-swim
filename:ファイル名:AllThe file name only, with its extensionfilename:2B
filepath:パス: or ファイルパス:AllThe whole path: every folder and the file name. / and \ are the samefilepath:Downloads
text:文字:AllThe same places as plain text, kept as a chip. To find two words in different places, keep one as a chip and type the othertext:beach
title:タイトル:SceneThe Title you gave the scene in the inspectortitle:beach
firstname:名:CharacterThe card's first namefirstname:Sakura
lastname:姓:CharacterThe card's last namelastname:ko*
nickname:ニックネーム:CharacterThe card's nicknamenickname:Saku
outfitname:衣装名:OutfitThe outfit name saved in the fileoutfitname:uniform
* after a keyHalf-width onlyAllAny number of characters. With a wildcard, the whole field has to matchfilename:2B* finds names that start with 2B
? after a keyHalf-width onlyAllExactly one characterfilename:img_??.png
" around the whole textHalf-width onlyAllThe text exactly as typed, with no key or minus"-beach" finds -beach

There is no author: or tag: key. Select authors and tags in the list under the bar instead. As text, a tag's name would match every file in a folder of that name.

ChipWhere it comes fromWhat it findsNOT
TagThe list under the bar, or Tags in the sidebarAssets with the tag. Several tag chips find assets with all of themHides assets with the tag
AuthorThe list under the bar, or Authors in the sidebarThe author's files, plus those KK Library suggests for them, in italics on the tile. Several author chips find files by any of themHides that author's files. Files with no author stay
? UnknownAuthors in the sidebarFiles with no author and no suggestionNone
A Library list rowThe sidebar's Library list, like FavoritesThat part of your library (Library)None
text: or a keyThe row you select after typing a keyThe text in that fieldHides files where it matches. Files where the field is empty stay
Similar toSimilar scenes in the inspectorScenes like the one you selected. It clears the rest of the searchNone
FilterModeWhat it findsNOT
Cast composition: Solo (female), Solo (male), All-female, All-male, Pair (female + male), Mixed groupSceneScenes by who is in them. All-female and All-male mean two or more. Mixed group means three or more, with bothNone
Gender: Any, Female, MaleOutfitWho the outfit is for, as you set it (Outfits)None
Game: Koikatsu, Koikatsu SunshineAllThe game the file was made inNone
Rating: Safe, R-18, UnratedAllThe asset's rating (Tags). Unrated means no rating yetNone
File size (MB): Min ~ MaxAllFiles within that size. Fill one box or bothNone
Duration: 0:00 ~ 0:00SceneHow long an animated scene plays. Enter 1:30 or 90. Static scenes never match. An animated scene with no length on its tile counts as 0:00None
AnimatedSceneScenes that move (Scenes)Static scenes
ModsAllAssets that need at least one modAssets that need none, including No (Plugins only)
Missing fileAllAssets whose file is gone (Trash)Hides them
Created: two datesAllAssets made between two dates, both days included, by the Created date on the tileNone
Sort bar AnimatedSceneThe same chip as Animated aboveSame as above
Sort bar Gender: All, Female, MaleCharacterThe card's sex, read from the fileNone
Sort bar Gender: All, Female, MaleOutfitThe same chips as Gender above, without AnyNone

How chips work together

#

An asset must match every chip, with two exceptions.

  • Author chips find files by any of them. Selecting an author in the list replaces the one there. To add a second, hold Ctrl and select it under Authors in the sidebar.
  • Several boxes in Cast composition, Game, Rating or Gender find assets that match any of them. So these chips have no NOT: select the other boxes instead.

How text matches

#

What you type is one piece of text, spaces included. school uniform finds those two words side by side, not apart.

  • Upper and lower case match for Latin letters. Full-width and half-width letters match only in author names.
  • The list under the bar ignores case and width, and for tags spaces too. swim suit offers Swimsuit. It finds an author by any of their names, aliases included.

How to do it

#

Search by typing

#
The search bar with 2B typed in Outfit mode, the box marked 1, above the first three tiles: 2B - Pajamas (Male), 2B - Plain (Male) and 2B - Club (Male)
  1. Choose Scene, Character or Outfit at the top of the main window.
  2. Select the search bar and enter part of a name, a folder, an author or a note (1). The grid narrows as you type. You don't need Enter.
The right end of the search bar, with Clear all marked 1
  1. To start over, select Clear all (1). It removes the text and every chip, and goes back to the top row of the Library list.

Search by tag or author

#
The search bar with uniform typed in Outfit mode. The box is marked 1 and the Uniform tag row in the list 2
  1. Enter part of a tag's or an author's name (1). The list shows matching tags with their category, then matching authors.
  2. Select a row (2). Enter picks the highlighted row, so press Enter only when you want that row.
The Uniform tag chip in the search bar. Its IS word is marked 1 and its ✕ 2
  1. The tag becomes a chip (1) and your text clears. The grid shows only the assets with that tag.
  2. To remove the chip, select its ✕ (2), or press Backspace in the empty box.

Leave out a tag, author or word

#
The Uniform tag chip after its word was selected, with NOT marked 1
  1. Select IS on the chip. It reads NOT (1), and the grid hides the assets with that tag.
  2. Select NOT to include it again. You can also right-click the chip and choose Include, Exclude or Remove from search.
The list after -swim was typed. The NOT School Swimwear row is marked 1 and the NOT text: swim row 2
  1. To leave something out by typing, start with -, like -swim. The list offers matching tags and authors as NOT chips (1), and last the word itself (2).
  2. Select a row. The grid waits until you do.

Search one field with a key

#
The right end of the empty search bar in Character mode, with the ? button marked 1
  1. With the search bar empty, select the ? button (1). It shows what you can type in this mode. The list also opens by itself the first time you select the empty search bar in each mode.
The You can type list in Character mode, with the filename: row marked 1
  1. Select a key, like filename: (1). It goes into the search bar.
  2. Enter the value after the key, like ill*.
The list after filename:ill* was typed in Character mode, with its row marked 1
  1. The first row shows the chip it makes and says what it finds (1). Select it. Until you do, the grid doesn't use the key.

Use Advanced filters

#
The Advanced filters panel in Scene mode. The Advanced filters button is marked 1, Missing file 2, the IS word of the Missing file chip in the search bar 3 and Clear 4
  1. Select the Advanced filters button at the left of the search bar (1).
  2. Select what you want, like Missing file (2). Each box you select becomes a chip in the search bar. This one reads IS Missing file (3), and the grid shows only the assets whose file is gone.
  3. To get the opposite, select IS on the chip (3). It reads NOT, and the grid hides the missing files. The box stays selected.
  4. Select anywhere outside the panel to close it. To clear every filter in it, select Clear (4).
  5. To remove one filter, select the ✕ on its chip.

Checked with KK Library 0.1.0-beta.9.1