add README

This commit is contained in:
2026-07-17 23:27:20 +02:00
parent e296cce001
commit 31bbc3bb93
+28
View File
@@ -0,0 +1,28 @@
# ImageViewer
The simple manga reader that is metadata aware.
## Usage
> [!WARNING]
> This app can take a long time to start after adding new manga because of metadata generation.
Create a folder for the manga and create a folder inside called volumes. Place your CBZ files inside volumes.
> [!NOTE]
> The app does not regenerate the metadata file if it already exists, even if there are new volumes.
When you first start the app, it will create a flatbuffer binary file with the metadata is has extracted from the entries in the zip.
You can modify this file yourself if you want. I recommend converting to JSON, modifying it with a text editor, and the converting back.
To convert the metadata file to JSON you can run a command similar to this:
```sh
flatc --json --defaults-json --raw-binary metadata.fbs -- metadata.fb
```
To convert back to binary you can run a command like this:
```
flatc --binary metadata.fbs metadata.json
```
Why do this?
To set metadata that is not found in the filename such as chapter name, volume name and other things such as release date.