Skip to main content
Version: 0.0.45

Directory Structure

Shisho works best when each book has its own directory. All editions of a book (EPUB, M4B, PDF, CBZ, etc.) should live in the same directory.

/media/
└── Main Library/
    ├── [Andy Weir] Project Hail Mary/
    │   ├── Project Hail Mary.epub
    │   ├── Project Hail Mary.epub.cover.jpeg
    │   ├── Project Hail Mary {Ray Porter}.m4b
    │   └── Project Hail Mary {Ray Porter}.m4b.cover.png
    ├── [Andy Weir] The Martian/
    │   └── The Martian.epub
    ├── [Brian K. Vaughan] Saga Vol 1/
    │   └── Saga Vol 1.cbz
    └── [James Clear] Atomic Habits/
        ├── Atomic Habits.epub
        └── Supplement.pdf          ← discovered as a supplement file

Organize Files​

Shisho includes an optional "Organize Files" feature in library settings that can automatically organize your books into a consistent directory structure. When enabled, Shisho will move and rename files based on metadata — during scans, when you identify a book and apply a plugin search result (the target file is renamed to match the identified title), and when you manually edit a book's title (each main file whose stored name still matches the old title is renamed too; custom filenames that differ from the book title are preserved).

If you prefer to manage your own file organization, you can leave this disabled and Shisho will work with whatever structure you have. With Organize Files disabled, these actions still update the book's title and the corresponding files' stored names in the database, but no files are moved or renamed on disk.

Non-media files in a book's directory (like PDFs or text files) are automatically discovered as supplement files.