https://github.com/rehhouari/clovre
Local manga & WebToon reading web app with AniList integration
https://github.com/rehhouari/clovre
alpinejs anilist manga manga-downloader manga-reader manga-tracker mangareader pwa spa tailwindcss webapp
Last synced: 5 months ago
JSON representation
Local manga & WebToon reading web app with AniList integration
- Host: GitHub
- URL: https://github.com/rehhouari/clovre
- Owner: rehhouari
- License: mit
- Created: 2021-09-25T00:34:04.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-10-23T21:39:57.000Z (8 months ago)
- Last Synced: 2025-10-23T23:32:29.231Z (8 months ago)
- Topics: alpinejs, anilist, manga, manga-downloader, manga-reader, manga-tracker, mangareader, pwa, spa, tailwindcss, webapp
- Language: HTML
- Homepage: https://clovre.pigeonivy.com
- Size: 477 KB
- Stars: 16
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Clovre - Local manga reader
Clovre is a web app with a clean uncluttered interface for reading downloaded manga & webtoons comfortably.
If you find this useful consider [following me](https://twitter.com/rehhouari)!
[Screenshots](https://imgur.com/a/XeLxKGD)
## Features
- Clutter-free responsive interface: every setting have a shortcut.
- Adjustable page width + full screen: no more zooming out!
- Dark mode toggle, accessible interface, and optional audio feedback.
- [AniList](https://anilist.co) integration to fetch covers & login to set progress etc., without leaving the app.
- Runs offline, loading covers and AniList login is optional. Offline toggle is provided.
## Usage
Visit: https://clovre.pages.dev
- You can open the help window any time by pressing shift space, there you can login to AniList and see shortcuts & toggle them.
- Simply click anywhere to open the directory that have your downloaded mangas (or drag and drop it)
- Make sure it follow this structure (no subdirectories for source etc.):
[Try downloading this example folder and open it! it doesn't include any copyrighted content](https://github.com/rehhouari/clovre/blob/main/example-folder-structure.zip)
```
Mangas (drop this)/
├── Manga 1/
│ ├── Chapter 1/
│ │ ├── 0.jpg
│ │ ├── 1.jpg
│ │ └── ..
│ └── Chapter 2/
│ ├── page-0.png
│ ├── page-1.png
│ └── ..
└── Manga 2/
├── c-4/
│ ├── image-1.jpg
│ ├── image-2.jpg
│ └── ...
└── c-5/
├── 0001.jpg
└── 0002.jpg
```
> Notice how the folders and images **can** have different naming conventions but what matters is they're all **orderd numerically**s
> I find [Hakuneko](https://github.com/manga-download/hakuneko) the best downloader and the folder structure is compatible with Clovre as well.
## Deployment
No build step, use a webserver with **HTTPS support**. like Caddy
example Caddyfile
localhost
root * /path/to/repo/clovre
file_server
## Why
I wanted a way to read manga comfortably on PC because it's been ages. After trying quite a few options, none met my special needs so I put this together over the weekend.
## License
[MIT](https://choosealicense.com/licenses/mit/)
## Tech Stack
**App**: [Alpine.js](https://alpinejs.dev), [Twind](https://twind.dev/).
It uses the new [Filesystem Access API](https://web.dev/file-system-access/) to access files with user permission. (drag & drop doesn't show a prompt if you're annoyed by that)
**API**: Generously provided for free by [AniList.co](https://anilist.co)