komga/README.md

34 lines
1.1 KiB
Markdown
Raw Normal View History

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