https://github.com/pierrotthecat/mangasamurai2

Manga and comic reader for Android devices that cuts the pages into panels and displays them one by one
https://github.com/pierrotthecat/mangasamurai2

android-application app application comic-reader comics image-processing image-segmentation kotlin kotlin-android manga manga-reader mangareader panel panels splitter

Last synced: 4 months ago
JSON representation

Manga and comic reader for Android devices that cuts the pages into panels and displays them one by one

• Host: GitHub
• URL: https://github.com/pierrotthecat/mangasamurai2
• Owner: PierrotTheCat
• Created: 2024-05-10T17:39:41.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2026-02-22T21:14:46.000Z (5 months ago)
• Last Synced: 2026-02-23T02:04:20.572Z (5 months ago)
• Topics: android-application, app, application, comic-reader, comics, image-processing, image-segmentation, kotlin, kotlin-android, manga, manga-reader, mangareader, panel, panels, splitter
• Language: Kotlin
• Homepage:
• Size: 1.44 MB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
Inspiration

I love the Amazon Kindle Guided View, which zooms into interesting parts of the pages of graphic novels (mangas and comics). It provides a cinematic reading experience and highlights details that can be easily overlooked on small displays but it is limited to selected series. 

Therefore I tried to make a similar automated feature that can be universally applied und helps avoid page-wide spoilers.

My app aditionally features an automatic reading mode that displays the next panel after a dynamic amount of time, depending on the size and shape of the panel.


How to use


Controls and Features



  
show new graphic novel/chapter: tap on the three dot menu, tap on "choose folder", choose a folder, wait, tap to show first panel

  
show next panel: tap on the display

  

return to previous panel: long press on panel

  
zooming panel: pinching gesture or double tap

  
move panel: drag and drop

  
automatic reading mode: press "start automatic switching mode" in the menu to change the panel automatically and dynamically every 6 - 22 seconds depending on the panel shape and size. Tap the panel to cancel the mode. 

  
dynamic color: theme adapts to your Material You color scheme and light/dark mode

  
color filter overlay: open the menu, tap on color filter, adjust the argb values, save and tap on the panel to apply the color overlay

  
fullscreen view: fling the panel upwards quickly to hide the toolbar and navbar, fling downwards to make them reappear

  
choose "jump to.." in the menu to jump to  a specific page



Detailed Instructions



save the graphic novel pages you want to cut as .jpg, .jpeg, .webp or .png files in a folder on your Android smartphone or tablet

make sure the names of the pages look like this: 001.jpg, 002.jpg,...

download and install the apk, if you haven't already

start the app

tap on the three dot menu in the top right corner

tap on "choose folder"

navigate the folder picker dialogue until you've found the folder with the graphic novel pages and confirm your choice

wait until the loading circle is gone (cutting finished)

tap the display to show the first panel



Notes



No graphic novel pages are included

all graphic novel pages in the folder are sorted and cut in the order of their file names

make sure the names of the pages look like this: 001.jpg, 002.jpg,...

  
tested on Samsung smartphone and tablet