{"id":37754230,"url":"https://github.com/keiwen/dans-ma-bulle","last_synced_at":"2026-01-29T13:01:53.947Z","repository":{"id":328859514,"uuid":"1115457128","full_name":"Keiwen/dans-ma-bulle","owner":"Keiwen","description":"Reader for local comic books","archived":false,"fork":false,"pushed_at":"2026-01-29T11:07:43.000Z","size":8608,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-29T11:41:59.354Z","etag":null,"topics":["comic-book","comic-reader","vue3","vuex"],"latest_commit_sha":null,"homepage":"https://keiwen.github.io/dans-ma-bulle/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Keiwen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-12T22:37:42.000Z","updated_at":"2026-01-29T11:07:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Keiwen/dans-ma-bulle","commit_stats":null,"previous_names":["keiwen/dans-ma-bulle"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Keiwen/dans-ma-bulle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Keiwen%2Fdans-ma-bulle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Keiwen%2Fdans-ma-bulle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Keiwen%2Fdans-ma-bulle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Keiwen%2Fdans-ma-bulle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Keiwen","download_url":"https://codeload.github.com/Keiwen/dans-ma-bulle/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Keiwen%2Fdans-ma-bulle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28877887,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-29T10:31:27.438Z","status":"ssl_error","status_checked_at":"2026-01-29T10:31:01.017Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["comic-book","comic-reader","vue3","vuex"],"created_at":"2026-01-16T14:26:45.961Z","updated_at":"2026-01-29T13:01:53.941Z","avatar_url":"https://github.com/Keiwen.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dans ma bulle\nComic reader dedicated to local books.\n\n* When you may not have any network to read your comic book\n* When you have a digital copy on your device\n\nHere come Dans ma bulle! (french for \"within my bubble\")\n\n![Dans ma bulle logo](https://raw.githubusercontent.com/Keiwen/dans-ma-bulle/master/src/assets/img/serene_light_logo_80.png)\n\nThis application will ask you to choose a directory on your device\nthat will be read (**no write action**).\n\n\u003e## Important compatibility note\n\u003e Dans ma bulle require, as first step, to select a directory from the user's device\n\u003e\n\u003e Regarding mobile devices, **only Chrome mobile browser** currently\n\u003e supports this requirement, and only since version 132,\n\u003e released around 2025-01-14.\n\u003e Other browsers does not plan to add this functionality soon (in 2025).\n\u003e\n\u003e Regarding PC browser, Dans ma bulle should be compatible with\n\u003e Chrome, Edge and Opera.\n\u003e The requirement is not supported by Firefox or Safari.\n\u003e\n\u003e You can refer to\n\u003e [showDirectoryPicker browser compatibility](https://developer.mozilla.org/en-US/docs/Web/API/Window/showDirectoryPicker#browser_compatibility)\n\u003e for more details\n\n## Usage\n### Setup\nThis is a Progressive Web App (PWA). If you are not familiar with this,\nit is a web application that could act as a device application on\nAndroid.\n\nSimply open the [application link](https://keiwen.github.io/dans-ma-bulle/), your device should offer you to\n'add to home screen' or 'install'.\n\n### In-app\nChoose your main directory as library.\nThe application will crawl files in this directory.\n\nYou can then choose a series, a book volume, and read it!\n\n## Library architecture\nIt will be required to follow a specific architecture in this directory:\na folder per series, containing volumes.\nA volume could be either:\n* a folder containing an image file per page\n* an archive file containing an image file per page.\nIt does not matter if images are included in a folder within\nthis archive. Supported archive format: ZIP ou CBZ\n('Comic Book Zip', can simply be a zip renamed to cbz)\n* a PDF file as a scan of all pages of the book\n\nAll kind of volumes may be mixed.\nFor example, your directory may look like:\n* Comic series A name (directory)\n  * Volume 1 name (directory)\n    * Page 1 image\n    * Page 2 image\n    * ...\n  * Volume 2 archive\n  * Volume 3 name (directory)\n    * Page 1 image\n    * Page 2 image\n  * Volume 4 PDF\n  * ...\n* Comic series B name (directory)\n* ...\n\nThis application does NOT support RAR/CBR or EPUB files.\nWe recommend decompressing these archives and re-compressing\nas ZIP/CBZ files instead.\n\n## Mobile troubleshooting\n### Library permission reset\nMobile browser currently revoke any permission granted to access your file,\nfor security reasons. Therefore, you'll 'lost' access to your library folder\neach time you re-open the application. Whenever this is detected,\nyou are redirected to the setup page with a new button to restore permission.\nBy security reason again, you need to click on this button and it cannot be\nautomated.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeiwen%2Fdans-ma-bulle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkeiwen%2Fdans-ma-bulle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeiwen%2Fdans-ma-bulle/lists"}