Axolotl Reader

Axolotl Reader

Self-hosted web comic reader-Easily organize and read your comics, Manga and Manhwa collections. Supports series management, online reading, metadata editing and cover management to provide a smooth and responsive reading experience

4GitHub
Description

**Axolotl Reader** is a modern web-side comic reader specially designed for personal comic collection management. ###Core features - ** Series management ** -intelligently organize your comic series - ** Automatic cover ** -Automatically extracts the first page of the book as the cover - ˇ ** Tag Classification ** -Flexible labeling and classification system - ** Multi-user support ** -Supports multi-user account and rights management - ** Responsive design ** -perfectly supports mobile reading - ** Self-hosting ** -Full control of your data privacy ###Applicable scenarios - Collection of personal comics - Manga/Manhwa enthusiasts - digital Library management - Offline reading needs --- ##First use ### 1ˇ Create an administrator account When accessing an application for the first time, you need to create the first user account (automatically become an administrator): 1. Access application address (for example: `https://your-domain.com/login`) 2. The system will automatically display the registration form 3. Enter your username and password 4. Click the **"Sign in"** button 5. Created successfully! You're already a manager ### 2ˇ Log in to the app After creating an account, you can log in using the same username and password. --- ##Guide to Importing Books ###Preparation ** Supported file formats **: - CBZ format (Comic Book ZIP) - 📌Other format support plan ** Document requirements **: - CBZ files should contain picture files (JPG, PNG, etc.) - Recommended file size no more than 50MB (single file) - Make sure the file name is clear and readable ###Import steps (important!) ####Method 1: Create a series and import it (Recommended) This is ** recommended import method **, which can keep your collection organized! 1. ** Enter the import page ** - Click on the left menu → **Import** - or access: `/import` 2. ** Select a book file ** - Click the **"Find Book(s) (.cbz) in your device"** button - Select one or more CBZ files - The file list will be displayed 3. ** Configure metadata **(key steps) ** Options that must be checked **: ``` ˇBooks are part of a series ˇUse the first page as cover ``` ** Fill in the information **: - **Authors **: Enter the author name, for example `Marvel Comics` - **Series Name **: Enter the series name, for example `Spider-Man` - **Tags **: Optional, such as `Superhero`, `Marvel` - **Series Position **: The sequential number of each book in the series (1, 2, 3...) 4. ** Adjust book information ** - You can modify the title of each book in the table - If it is a series, make sure each book has the correct location number - You can use the "Use template for title" function to name batches 5. ** Start importing ** - Click the **"Import X Book(s)"** button - Wait 20-30 seconds (large files may take longer) - ˇThe progress bar may not display accurately, just wait patiently - It will automatically jump after the import is completed 6. ** View the results ** - Visit the **Library** page - You will see the newly created series - Click on the series to view all the books included ####Method 2: Import a single book (not recommended) If you just import a single book, you don't need to create a series: 1. Select book file 2. ** Don't check the box ** "Books are part of a series" 3. Fill in the author information 4. click Import ˇ* * Note **: A single imported book will not be displayed on the Library page!

Screenshots
Screenshot 1
Screenshot 2
Screenshot 3
Mobile Screenshots
Mobile Screenshot 1
Mobile Screenshot 2
Mobile Screenshot 3
Mobile Screenshot 4
App Information
Version
1.0.0
Package Size
11.11 KB
Image Size
30.73 MB
Updated
December 2, 2025
Source Code
bastien2203
Platform Support
PCMobile