KK Library Scene & Card Manager
All guide pages

Trash and removing files

KK Library moves Koikatsu scenes, cards and outfits to its Trash and back, deletes their files or takes them out of your library, then finds files that went missing.

Where to find it
Trash and Missing files in the sidebar, and More actions ▸ Remove from library in the inspector

What it is

#
The sidebar's Library list, with Missing files marked 1 and Trash 2

An asset leaves the grid when you move it to the Trash (2), remove it from your library or its file goes missing (1). Each action affects the file and its library data differently. The table shows what each one keeps or removes.

What happensThe file on diskIts library data
Move to TrashStays where it is, unchangedKept. The asset leaves the Quick List and every other list, search and count
Restore from the TrashUnchangedKept as it was. The asset doesn't go back on the Quick List
Delete from the TrashGoes to the Recycle Bin, or is deleted permanently when it can'tDeleted with the asset
Remove from libraryStays, unless you turn on Also delete the files from diskDeleted with the asset
The file goes missingGone, or moved where KK Library can't find itKept. The asset waits under Missing files
Locate fileStays, or moves into a library folder you chooseKept, or merged with the asset that already had the file

What it can do

#

The Trash

#

Moving an asset to the Trash asks nothing, because you can restore it. Nothing leaves the Trash on its own.

  • Press Delete in the grid to move the selection. Only a selection made with Ctrl+A asks first, because it can cover tiles you haven't seen.
  • Scenes, character cards and outfits each have their own Trash.
  • Search or add a chip first to restore or delete only part of it.

Deleting files

#

A delete can't be undone in KK Library, so the file goes to the Windows Recycle Bin when Windows allows it.

  • Files on a USB stick, a memory card or a network drive are deleted permanently. So are files with a path of 260 characters or more, files too large for the Recycle Bin and files on a drive with it off. The confirmation counts them first.
  • A file on a drive that isn't connected stays, with its asset.
  • Getting a file back from the Recycle Bin doesn't bring back its tags.

Removing from your library

#

Each sync adds every file in your library folders, and KK Library keeps no list of the files you removed.

Missing files and Locate

#

A missing asset keeps its tags, rating and notes until you locate its file or remove the asset.

  • A rename or move inside your library folders doesn't make a file missing. The next sync finds it by its size and date, then by its fingerprint, a value worked out from its whole contents.
  • Locate the file yourself when it is outside your library folders, you saved it again in the game or it is already its own asset. Sync can't prove those are the same file.
  • An unplugged drive marks nothing missing. A library folder that was deleted or moved marks all its files missing.
  • Tags, notes, the Quick List and the Trash still work on a missing asset. Sending it to the game, renaming it and editing the card need the file.
  • A file that is already its own asset merges with the one you locate, and both sets of tags are kept. Neither a merge nor a Locate move can be undone.
  • Locate files matches many assets by fingerprint, then by file name. It never guesses, and leaves an unclear asset for you to locate on its own.

How to do it

#

Move assets to the Trash

#
The bottom of the inspector, with Trash marked 1
  1. Select a tile.
  2. Select Trash (1) at the bottom of the inspector. With several tiles selected, the button reads Move to Trash. The file stays on disk.
  3. The tile shows Moved to Trash until the grid refreshes, then leaves the list.

Restore assets from the Trash

#
The Trash. The Sort by box reading Date moved to Trash is marked 1, a Moved to Trash tile 2, Restore all 3 and Delete all permanently 4
  1. Select Trash in the sidebar's Library list. Each tile shows Moved to Trash (2), newest first (1). The tile's last line and the inspector say the day it moved.
  2. To restore everything shown, select Restore all (3). It doesn't ask first.
The bottom of the inspector for a trashed scene, with Restore marked 1
  1. To restore one asset, select its tile, then Restore (1). With several tiles selected, the button reads Restore selected.

Delete files from the Trash

#
  1. Select Trash in the sidebar. To delete only some, search or add a chip first.
  2. Select Delete all permanently. Narrowed, it reads Delete 3 assets permanently, with your count.
The Remove from library window from the Trash. The message is marked 1, Also delete the files from disk 2 and Delete files 3
  1. Read the message (1). It says where the files go. If some can't go to the Recycle Bin, a line under it says how many are deleted permanently. If some are on a drive that isn't connected, a line says they can't be deleted. KK Library keeps those files and their assets.
  2. Leave Also delete the files from disk (2) turned on and select Delete files (3). The files go to the Recycle Bin, and the assets leave your library with their tags.

To keep the files, turn the box off. The button then reads Remove.

Remove an asset but keep its file

#
The inspector's More actions menu, with More actions marked 1 and Remove from library 2
  1. Select a tile. For several tiles, the panel's More actions has the same item.
  2. Select More actions (1), then Remove from library (2).
The Remove from library window. The message is marked 1, the line about library folders 2, Also delete the files from disk 3 and Remove 4
  1. The message (1) says the file stays where it is and its library data is deleted, like its tags and rating. If the file is inside a library folder, a line (2) says it comes back the next time you sync.
  2. Select Remove (4). To delete the file instead, turn on Also delete the files from disk (3).

Find missing files

#
The status bar after a sync, with Files no longer on disk marked 1
  1. Select Sync. If files went missing, the status bar starts with Files no longer on disk (1) and their count.
The sidebar and the grid on Missing files. Missing files is marked 1 and a File missing tile 2
  1. Select Missing files (1) in the sidebar. Each tile shows File missing (2).
  2. Select a tile. The box under the file name says File not found. It says The file can't be read. when the file is there but no longer reads as a scene, card or outfit.
  3. If the file went by mistake, put it back in its folder and select Sync. The tile is normal again, with everything on it.
  4. If you know where the file is now, select Locate file (Locate a missing file).
  5. If you meant to delete it, select More actions ▸ Remove from library to take it out.

To take every missing asset out at once, press Ctrl+A on Missing files, then use Remove from library. The confirmation says their files are already gone and offers no file choice. To check one asset without a sync, select More actions ▸ Force reanalyze in the inspector. It marks the asset missing or clears the mark.

Locate a missing file

#
The top of the inspector for a missing file. The line File not found. is marked 1 and Locate file… 2
  1. Select Missing files in the sidebar, then the tile. The box under the file name (1) says File not found.
  2. Select Locate file (2). The Windows file picker opens in the folder the file was in, or the nearest folder above it that still exists.
  3. Choose the file. If it is in a library folder and no other asset has it, the tile is normal again, with everything on it.
The Locate file window. The question is marked 1, the missing asset 2 and Merge 3
  1. If the file is already in your library as another asset, KK Library asks to merge the two (1). The asset you are locating (2) stays. Select Merge (3). The other asset's tags, rating and notes are added to it, and the other asset leaves your library.
  2. If the file is outside your library folders, a folder picker opens, Choose where to keep this file. Choose a folder inside a library folder, and the file moves there. Choose any other folder, and KK Library asks before it adds that folder to your library. Select Add folder. A file that was somewhere else moves into that folder.

Locate many missing files at once

#
  1. Select Missing files in the sidebar and press Ctrl+A.
The inspector with two missing scenes selected. The line 2 files not found. is marked 1 and Locate files… 2
  1. The inspector counts the selected files that are missing (1). Select Locate files (2). It acts only on those missing assets.
  2. Choose the folder the files are in now.
The Locate files preview. The line of counts is marked 1, the list 2 and Locate 2 files 3
  1. Read the preview. The first line (1) says how many files were found. When some weren't found or are unclear, it counts those too. The list (2) names each file and where it was found, under how it was found. Nothing has changed yet.
  2. Select the button with your count, like Locate 2 files (3).
  3. If some files are outside your library folders, a folder picker asks once where to keep them all. Choose a folder inside a library folder, and they move there. Any other folder asks first, as for one file.

To locate an unclear asset, select it on its own and use Locate file. Then you choose the file yourself.

Checked with KK Library 0.1.0-beta.9.1