https://github.com/keiwen/dans-ma-bulle
Reader for local comic books
https://github.com/keiwen/dans-ma-bulle
comic-book comic-reader vue3 vuex
Last synced: 5 months ago
JSON representation
Reader for local comic books
- Host: GitHub
- URL: https://github.com/keiwen/dans-ma-bulle
- Owner: Keiwen
- Created: 2025-12-12T22:37:42.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-01-29T11:07:43.000Z (5 months ago)
- Last Synced: 2026-01-29T11:41:59.354Z (5 months ago)
- Topics: comic-book, comic-reader, vue3, vuex
- Language: JavaScript
- Homepage: https://keiwen.github.io/dans-ma-bulle/
- Size: 8.21 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Dans ma bulle
Comic reader dedicated to local books.
* When you may not have any network to read your comic book
* When you have a digital copy on your device
Here come Dans ma bulle! (french for "within my bubble")
This application will ask you to choose a directory on your device
that will be read (**no write action**).
>## Important compatibility note
> Dans ma bulle require, as first step, to select a directory from the user's device
>
> Regarding mobile devices, **only Chrome mobile browser** currently
> supports this requirement, and only since version 132,
> released around 2025-01-14.
> Other browsers does not plan to add this functionality soon (in 2025).
>
> Regarding PC browser, Dans ma bulle should be compatible with
> Chrome, Edge and Opera.
> The requirement is not supported by Firefox or Safari.
>
> You can refer to
> [showDirectoryPicker browser compatibility](https://developer.mozilla.org/en-US/docs/Web/API/Window/showDirectoryPicker#browser_compatibility)
> for more details
## Usage
### Setup
This is a Progressive Web App (PWA). If you are not familiar with this,
it is a web application that could act as a device application on
Android.
Simply open the [application link](https://keiwen.github.io/dans-ma-bulle/), your device should offer you to
'add to home screen' or 'install'.
### In-app
Choose your main directory as library.
The application will crawl files in this directory.
You can then choose a series, a book volume, and read it!
## Library architecture
It will be required to follow a specific architecture in this directory:
a folder per series, containing volumes.
A volume could be either:
* a folder containing an image file per page
* an archive file containing an image file per page.
It does not matter if images are included in a folder within
this archive. Supported archive format: ZIP ou CBZ
('Comic Book Zip', can simply be a zip renamed to cbz)
* a PDF file as a scan of all pages of the book
All kind of volumes may be mixed.
For example, your directory may look like:
* Comic series A name (directory)
* Volume 1 name (directory)
* Page 1 image
* Page 2 image
* ...
* Volume 2 archive
* Volume 3 name (directory)
* Page 1 image
* Page 2 image
* Volume 4 PDF
* ...
* Comic series B name (directory)
* ...
This application does NOT support RAR/CBR or EPUB files.
We recommend decompressing these archives and re-compressing
as ZIP/CBZ files instead.
## Mobile troubleshooting
### Library permission reset
Mobile browser currently revoke any permission granted to access your file,
for security reasons. Therefore, you'll 'lost' access to your library folder
each time you re-open the application. Whenever this is detected,
you are redirected to the setup page with a new button to restore permission.
By security reason again, you need to click on this button and it cannot be
automated.