Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
pics
.gitignore
CHANGELOG.md
LICENSE
README.md
logo.png
test

README.md

Notice

This project is inactive until further notice :'(

In the meantime, people have recommended https://github.com/manga-download/hakuneko. I haven't used it myself, but it seems quite good!


mofu

mofu is a modern manga reader that can be run on any computer with Java!

Join us on Discord to see sneak peeks for upcoming features, give suggestions & feedback, or just hang out!

I'm basically always online while I'm awake, and I try to respond to everyone who @mentions me or PMs me!

What is mofu?

tl;dr mofu is a modern manga reader for desktop computers. Features (completed & planned) include tracking reading progress, notifications on new chapters, reader appearance settings, convenient hotkeys, customizable color themes, and much more!

Reading manga on a smartphone or tablet nowadays is such a pleasure. There are so many great apps to choose from; just look at how much tachiyomi can do!

Unfortunately, the same awesome browsing experience doesn't really exist (yet!) for computers. And that's pretty weird, since normally you'd think that desktops should be able to do everything that phones can, and more.

For whatever reason, the only programs available for Windows/Mac/Linux look and feel like they were designed 5+ years ago (because, well, many of them were). Most of them aren't even for manga, they're just kind of generic comic book readers that load in folders of images. Aside from having to use laggy, ad-ridden aggregate readers or resorting to clunky browser extensions, there aren't many options to choose from.

The goal of mofu is to close the gap and bring an awesome manga reading experience to desktops and laptops!

Got any screenshots?

Yup! Just go to the pics directory or click here :)

Table of Contents

Features

  • Vertical (one long page) reading mode
  • Search through supported sources for manga to read (currently limited to searching by title only)
  • Loads full chapters in just a couple seconds
  • Automatically find the scanlators for a manga and credit them if found
  • One click to instantly download a chapter you're currently reading
  • Download manager in search results page to download multiple chapters - it takes just 3 clicks to download an entire series!
  • Many other features planned & in progress!

Supported Sources

  • MangaHere.co
  • KissManga.com
  • more coming soon!

Setup Instructions

Important! You may be asked for permissions to run PhantomJS. I know it sounds super sketchy, but I promise it isn't haha.
PhantomJS is this pretty large & reputable project: http://phantomjs.org. It's basically a browser that doesn't have any UI so it runs invisibly.
It's used in misakachan to get past pesky Cloudflare blocks (those "pls wait 5 seconds" things like on KissManga.com) without spamming you with new browser windows.
If you want to make sure it's not doing anything shady (better safe than sorry!), the relevant code is in WebAccessor.java.

  1. Install Java 8 if you don't already have it. misakachan requires Java 8, and won't work properly with Java 7!
  1. Download the latest version from the Releases page
  2. If you have Java 8 installed correctly, you should be able to simply double click the JAR.
  • If that doesn't work for you, try opening Command Prompt (Windows), Terminal (Mac), or Bash (Linux).
  • Go to the directory that has misakachan.jar and type java -jar misakachan.jar.
  • If that still doesn't work, post an issue here or contact me on Discord and I'll try to help!
  1. Click Launch Browser and you should see the misakachan main page!
  • If Launch Browser doesn't work, just open your web browser and go to this URL: http://127.0.0.1:10032/. (It should almost always work, though.)

Download

Just in case you missed it in "Setup" above lol.

Download the latest version of mofu from the Releases page

Of course you can also fork the repo and build from source.

FAQs

What's PhantomJS? A virus?

Please see "Setup Instructions" (relevant section copied here).

Important! You may be asked for permissions to run PhantomJS. I know it sounds super sketchy, but I promise it isn't haha.
PhantomJS is this pretty large & reputable project: http://phantomjs.org. It's basically a browser that doesn't have any UI so it runs invisibly.
It's used in misakachan to get past pesky Cloudflare blocks (those "pls wait 5 seconds" things like on KissManga.com) without spamming you with new browser windows.
If you want to make sure it's not doing anything shady (better safe than sorry!), the relevant code is in WebAccessor.java.

Is this ready for use?

I use a super relaxed version of Semantic Versioning, which basically means I'm too lazy to stick to all those specific rules but misakachan's versioning will look vaguely like that.

Basically, if misakachan is still on version 0.x.x, it's not technically ready for release and I can't make any guarantees on stability.

Feel free to play around with it before v1.0.0 arrives though!

How does this work?

Please see "Setup" above for installation instructions! If you want details on the internal stuff, look through the code or see "Tech Stack" below.

Can you add ____ source?

New sources are pretty painful to code, although they typically are similar to other sources. Post an issue here on GitHub and I'll do what I can. If you can code, making a new source is as simple as extending AbstractSource and filling in the methods. If you can write the code yourself, send a PR and I'll probably accept it. You can use the existing sources as reference for what each method is supposed to do; the project is not very well documented at the moment, unfortunately.

Can you add ____ feature?

Probably, if it's nothing too wild. The best way to make sure your suggestion isn't forgotten is to post an issue here on GitHub.

Do you accept pull requests?

Yes! But in the current stage the code is not very well structured and changes frequently, so please keep that in mind.

Tech Stack

Here's a quick overview of the specific tools and technologies used in misakachan, for anyone interested:

  • Electron - desktop app framework
  • Typescript - implementation language
  • React - UI stuff
  • cheerio - DOM parsing
  • Javascript & jQuery - sprinkled in here and there
  • SASS - CSS preprocessing
  • PouchDB - local data storage
  • PhantomJS - mostly used for bypassing cloudflare and getting dynamically loaded content

License

mofu is available under whatever license is currently in the root directory (probably the MIT license).