Skip to content

A simple command line-based program for assisting in reading image-based comics

Notifications You must be signed in to change notification settings

mistekko/manga-reader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 

Repository files navigation

manga-reader

This project is a simple python manga-reader that uses the "viewnior" image viewer (support for others might come in later versions). I'm sure it's not for everyone, but I find it essential to have one that

  • Automatically goes to the next folder when a chapter is finished
  • Is simpler than soil
  • Is CLI-based
It's primarily a personal project, so I WILL NOT maintain it regularly, but I do expect to update it occasionally. If you've got a feature request or suggestion for my code (I am very amateur, I expect it to be mediocre), open an issue or pull request and I'll be more than happy to review it when I've got time.

Installation:

Download manga-reader and run chmod +x manga-reader in whatever directory it ends up in. Then, either add the installation directory to your PATH (NOT recommended since it bloats your $PATH), move manga-reader to a location on your $PATH, or link it to a location on your $PATH. I like to link it to ~/.local/bin/mr, which is generally a good place to install executables that should be accessible from everywhere but aren't managed by a package manager.

Usage:

manga-reader takes two arguments, one required and one optional:

  1. The directory containing the manga
  2. The chapter at which you would like to start, which defaults to 0000 if nothing is provided

it will look for chapters based off of a four-digit naming scheme (i.e., 0001, 0231, 0019, etc.), which is a very limited method, but I've yet to generalise it... it ought to work with [mangal](https://github.com/metafates/mangal), which is likely the best manga downloading app on linux at the moment.

Some example uses:

  • manga-reader . 12
    • opens chapter 12 of whatever manga exists in your current directory
  • manga-reader ~/Documents/books/manga/Usuzumi_No_Hate
    • starts (opens first chapter of) whatever manga is located in ~/Documents/books/manga/Usuzumi_No_Hate

Possible Upcoming Features:

  • Improve help output
  • Support for different image viewers/some way to set image viewer
  • Save and resume most recent chapter number
  • Better chapter folder selecting
  • Going to a previous chapter
  • It would be cool if it ran from emacs, but then again, that can be achieved with moderate ease by simply using EXWM
  • There needs to be a more normal way to install it

About

A simple command line-based program for assisting in reading image-based comics

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages