Giter Club home page Giter Club logo

clovre's Introduction

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!

Screenshots

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 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.pigeonivy.com

  • 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

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 numericallys

I find 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

Tech Stack

App: Alpine.js, Twind.

It uses the new Filesystem Access API 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

clovre's People

Contributors

ayowel avatar rehhouari avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Forkers

shuxiaokai ayowel

clovre's Issues

Does it support cbz?

Also does it have auto tracking with anilist if so does it track reading by chapter name or?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.