2019-08-21 15:51:00 +08:00
|
|
|
# ![app icon](./.github/readme-images/app-icon.png) Komga
|
|
|
|
|
|
|
|
Komga is a free an open source comics/mangas server.
|
|
|
|
|
|
|
|
## Features
|
|
|
|
|
|
|
|
Komga just started, and for now it can:
|
|
|
|
|
2019-08-22 10:20:38 +08:00
|
|
|
- scan and index a folder containing comic book archives in `cbz` and `cbr` format. Rescan periodically.
|
2019-08-21 15:51:00 +08:00
|
|
|
- serve the individual pages of those books via an API
|
|
|
|
- serve the complete file via an API
|
|
|
|
|
|
|
|
## Status & vision
|
|
|
|
|
|
|
|
The first version is a simple server with only an API and no UI.
|
|
|
|
It's aimed to work with [Tachiyomi](https://github.com/inorichi/tachiyomi) through an extension.
|
|
|
|
|
|
|
|
Future versions may bring:
|
|
|
|
|
|
|
|
- support for PDF files
|
|
|
|
- support for multiple libraries (multiple folders)
|
|
|
|
- a web UI to administrate the server
|
|
|
|
- matching with online metadata sources (like ComicVine) to enrich information like description or genre
|
|
|
|
|
|
|
|
The long term vision is to offer something similar to Plex, but for comics!
|
|
|
|
|
2019-08-22 08:43:30 +08:00
|
|
|
## Installation
|
|
|
|
|
|
|
|
The easiest way to install Komga is to use Docker. You can have a look at the sample [docker-compose.yml](./doc/docker-compose.yml).
|
|
|
|
|
2019-08-21 15:51:00 +08:00
|
|
|
## Credits
|
|
|
|
|
2019-08-22 08:43:30 +08:00
|
|
|
The Komga icon is based on an icon made by [Freepik](https://www.freepik.com/home) from www.flaticon.com
|