KK Library 0.1.0-beta.9.1
Released 2026-11-20

What this is
------------
A local desktop app for Koikatsu / Koikatsu Sunshine scene, character card
and outfit libraries. It scans your folders and puts everything in one
searchable list, so you can browse, find duplicates, clean up tags and
authors and organize files without opening each one in the game.

Scenes, character cards and outfits each get their own mode. An outfit is
read, searched, tagged, rated and organized like anything else, its details
show the clothes and accessories it carries, and you can name it and mark
who it is meant for. You can also pull outfits out of a character card and
load one straight onto a character in the game.

How to run it
-------------
1. Unzip this folder anywhere on Windows. It is portable, with no installer.
2. Run KKLibrary.exe.
3. Add one or more folders containing your scenes, cards or outfits.
4. Start browsing. The grid is usable while the scan finishes.

If Windows warns about an "unknown publisher", the app is not code-signed. A
signing certificate costs money and this is a free side project. Choose
"More info" > "Run anyway" to start it. To be sure, check your download
against SHA256SUMS.txt on the download page.

A good first pass
-----------------
- Use Review duplicates and Find similar to clear out repeated files and
  variants.
- Add tags, ratings and favorites and fix author names as you go.
- Explore or edit a card from its details panel. Advanced details lets you
  work with the textures and other supported appearance data inside it.
- Use Organize Files when you want a cleaner folder layout. It shows the full
  plan before moving files or copying a backup. Moves can be undone.

Work with the game (optional)
-----------------------------
In Settings, choose your Koikatsu folder. KK Library installs a small bridge
plugin into BepInEx/plugins so it can open scenes in CharaStudio, add or
replace characters from cards, dress the selected character in an outfit,
and open cards or outfits in Chara Maker for editing.

The bridge is the only thing KK Library adds to your game folder and it is
installed only when you connect the game. It does not change your mods,
scenes or saves.

Quick List
----------
Add scenes, cards or outfits to the Quick List while browsing. Keep it above
the game and drag files straight into CharaStudio or Chara Maker.

Your files are safe
-------------------
- Scanning only reads files. It never moves or renames them.
- Deleting sends files to a Trash you can restore.
- Organize Files shows the full plan first. Its moves can be undone.
- Card editing keeps a backup of the original card.
- Tags, ratings, favorites and authors stay attached through moves, renames,
  re-packs and edits made outside the app.

Privacy
-------
Your collection stays on your PC. There is no account.

License and disclaimer
----------------------
This build is distributed under the KK Library Noncommercial Software License.
See LICENSE.txt for the full terms.

In short:
- personal and other noncommercial use is allowed
- sharing exact, unmodified copies of the official release package is allowed
  for noncommercial purposes
- selling it, bundling it into paid products or services or redistributing
  modified versions is not allowed without permission

This software is distributed as is, with no guarantees or warranty. The
copyright holder is not responsible for damage, data loss or other problems
caused by using it.

Updates
-------
When a newer version is out, the app shows a note with a download link. Download
the new ZIP and replace this folder. Your settings and data stay where they are.
Nothing installs or updates itself in the background.

Removing it
-----------
It is portable. Delete this folder and it is gone, with no leftovers.

More
----
- RELEASE_NOTES.md: what changed in this version
- LICENSE.txt: the terms for this build
- THIRD_PARTY_NOTICES.md: notices for bundled third-party software
- Project website and downloads: https://kklibrary.dev
- Updates and announcements on X: https://x.com/kklibrarydev
