Getting started

Mohyeong is a manga reader for Android. You install extensions, which are small scripts that teach the app how to read a particular website. Then you browse those sites, add what you want to your library, and read.

Three things need setting up once, and the app walks you through them the first time it opens:

Once that is done the app has no sources yet. Head to Browse and add an extension.

Installing

Both at once. Mohyeong does not use the same package name as Mihon, so having both installed side by side is fine. They keep entirely separate libraries.

Storage folder

Mohyeong asks for one folder and keeps everything of yours inside it: chapter downloads, automatic backups, and the local source if you use one. You choose it during setup and can change it later in Settings, Data and storage.

Pick a folder you will recognise later, for example Documents/Mohyeong. A dedicated folder is easier to back up and easier to delete.

Changing it does not move anything. Point the app somewhere new and it starts using the new place. Existing downloads stay where they are and the app stops seeing them. Move the contents yourself first if you want to keep them.

Extensions

An extension is a small JavaScript file that knows how to read one website: where the popular list is, how a chapter page is laid out, where the images are. One extension equals one source.

This is not the same mechanism Mihon uses. Mihon extensions are Android APKs installed through the system; Mohyeong's are scripts the app runs itself. Mihon extension APKs will not work here.

Manage them under Browse, Extensions: add one from a file, see what is installed, check for updates, or remove one. Removing an extension does not remove anything from your library, but entries from that source will not load until it is back.

A source stops working. Sites change their markup and an extension written against the old markup breaks. That is a fault in the extension, not in the app, and it is fixed by updating the extension.

Sources

Browse lists everything you can read from, each row wearing that site's own logo. Tap one to open its catalogue: Popular, Latest, and Search, with whatever filters that site offers.

The pin on the right keeps a source at the top of the list. The funnel in the header hides sources you never use, and the search icon runs one query across every installed source at once, one row of results per source, so a slow site never holds up a fast one.

Tap Browse again when you are already on it and global search opens directly.

Home

The first tab is built around reading position rather than around what you own, because the question a library app actually has to answer is what is next and where was I.

It has three parts: a rotating hero showing the series you are furthest through, Continue with what you are part way into and the position you left it at, and Tonight.

Tonight

Tonight is the updates surface. There is no separate Updates tab; this is it, and it carries the whole job: every chapter that has arrived, newest first, grouped by day.

From its header you can refresh the whole library, filter to unread or bookmarked, hide muted scanlators, search, and open Upcoming. Long press a row to select, then mark read or bookmark in bulk. Pull down to refresh.

No day header over today. The section is already called Tonight, so repeating today's date above the first group would only restate it.

Library

Everything you have added, as a grid of covers with an unread count. The header names the shelf and counts what is waiting on it.

Sort, filter and the number of columns live in Settings, Library, along with how often the app checks for new chapters and which categories it checks. Long press a cover to select and act on several entries at once.

Categories

Shelves for your library. A category can sit inside another one, so you can keep Reading, Reading / Weekly and Reading / On hold without three flat names that only look related.

Manage them in Settings, Library, Categories: create, rename, reorder by dragging, set a parent, delete. Dragging only reorders within one parent group, so a drag can never silently reparent something.

Reader

Tap the middle of the page to show or hide the controls. The edges turn pages, and which edge does what depends on the reading mode.

ModeBehaviour
Paged (left to right)Western order
Paged (right to left)Manga order
Paged (vertical)Top to bottom, one page at a time
Long stripContinuous scroll, no gaps between pages
Long strip with gapsContinuous scroll, pages separated
DefaultWhatever the global setting says

Mode can be set globally in Settings, Reader or per series from the reader's own settings sheet, which is where per series wins. That sheet also holds scale, rotation, background, crop borders, and the colour filter and brightness controls.

Settings, Reader additionally covers full screen, keeping the screen on, page number display, double tap zoom, tap zones and whether to invert them, and the flash on page change used to reduce ghosting on e ink.

Downloads

Download a chapter from a series page, or in bulk from the selection bar. The queue lives in More, Download queue, where you can pause, resume, reorder and cancel.

Settings, Downloads decides how much happens on its own: download new chapters as they arrive, restricted to chosen categories, and whether to delete a chapter once it has been read. Bookmarked chapters can be excluded from that deletion, which is the setting people usually want and rarely find.

Downloads live in your storage folder. Clearing app data does not touch them, but they are not part of a backup either. A backup records what you read, not the files.

Upcoming

A calendar of predicted release dates for series in your library, reachable from Tonight. A ring marks today and a dot under a date means something is expected then; tap a marked day to jump the list to it.

These are predictions, not announcements. The app measures how often a series has actually been updating and projects the next one, so a series only appears here once a library update has run and there is enough history to guess from. Irregular series will be wrong, and that is expected.

Tracking

Mohyeong can push your progress to an external tracker. Sign in under Settings, Tracking, then link an individual series from its details page.

TrackerSign in with
AniListAccount authorisation in a browser
MyAnimeListAccount authorisation in a browser
KitsuEmail and password
MangaUpdatesUsername and password
ShikimoriAccount authorisation in a browser
Komga, SuwayomiServer address and credentials

Linking is per series and nothing is sent until you link one. Progress is pushed as you read; you can also set status, score and dates by hand from the tracking sheet.

Local source

Read files already on the device. Point the local source at a folder and every subfolder becomes a series.

Mohyeong/local/
  Series name/
    Chapter 1.cbz
    Chapter 2.cbz
    cover.jpg

Each chapter is one .cbz or .zip archive, or a folder of images. RAR and CBR are not supported. A file named cover beside the chapters is used as the series cover; otherwise the first image of the first chapter is.

Chapter order comes from the name. The app reads a number out of the filename, so Chapter 2 sorts before Chapter 10 even though the text does not.

Migrating sources

When a site dies or a better one appears, migration moves your entries across without losing what you have read.

Chapter numbers have to line up. Progress is matched by chapter number, so a destination that numbers differently, or bundles chapters into volumes, can land you in the wrong place.

Backup and restore

Settings, Data and storage, Backup writes a single file containing your library, categories, reading history, chapter states, tracking links and per source settings. It does not contain downloaded images.

Automatic backups can be scheduled, with a limit on how many are kept. Restoring merges into what is already there rather than replacing it.

Restore what you can read. A backup records which source each entry came from. Restore onto a device without that extension installed and the entries are there but cannot load until you add it.

Sync

Sync keeps two devices agreeing about the same library. Backup is a file you keep; sync is a conversation between installs. Set it up in Settings, Data and storage, Sync.

BackendYou provide
SyncYomiServer address and API key
WebDAVURL, username, password
Google DriveAccount authorisation
DropboxAccount authorisation

Choose what takes part: library, categories, chapters, history, tracking. Sync can run on app start and on a schedule.

Merging is per row and by timestamp, so the most recently changed version of each entry wins rather than the whole of whichever device synced last. Removing something is recorded as an act with its own timestamp, so an entry you delete on one device does not come back from the other.

Leaving the sync screen with unsaved changes warns you first, because a half entered server address that silently discards itself looks exactly like sync being broken.

Security

Settings, Security can require your device lock to open the app, with a delay so switching apps for a moment does not lock you out. There is also an option to hide the app's contents in the recent apps switcher.

Incognito mode stops the app recording history while it is on. It is a toggle rather than a mode you can forget you are in: while it is active the app says so.

Lock when idle set to Never means the lock is only asked for on a cold start, not when returning from another app.

Appearance

Mohyeong is built dark. There is no light theme and no follow the system option, because there is nothing behind them: the whole interface is designed against a black ground with drifting aurora light, and a light variant would be a different application rather than a different setting. Rather than ship switches that move nothing, the settings are not there.

What Settings, Appearance does hold is the relative date format used across history and updates.

Idle decoration sleeps. The aurora stops drifting about ten seconds after you stop touching the screen and picks up exactly where it left off when you touch it again. This is a battery measure and it is not configurable.

Troubleshooting

A source shows nothing, or fails to load

Open the site in a browser first. If it is down or has moved domain, the extension cannot help. If the site loads in a browser but not in the app, it is likely a Cloudflare check; open the source once from Browse so the challenge can be solved, then try again.

A source has no logo, just a letter

The logo is fetched from the site itself, once. Sites behind a check can fail the first attempt and are retried within the hour. Some sites genuinely publish no icon at all, and those keep the letter permanently.

Covers load but pages do not

Usually the site rate limiting a burst of image requests. Wait, then retry the chapter. Downloading the chapter first is more reliable than reading it live on sites that do this often.

Library updates find nothing new

Check Settings, Library: updates can be restricted to certain categories, skipped for completed series, or limited to Wi-Fi and to charging. An update that is skipped is not an update that failed.

Downloads stop when the screen is off

Grant the battery optimisation exemption offered during setup, or in Settings, Advanced. Without it Android is free to kill long downloads.

The app asks for the storage folder again

The permission Android grants for a folder can be revoked if the folder is deleted, renamed, or lives on removed external storage. Pick it again.

FAQ

Can I use my Mihon extensions?

No. Mihon extensions are Android APKs; Mohyeong's are JavaScript files it runs itself. They are not interchangeable in either direction.

Can I restore a Mihon backup?

The backup format is compatible, so the library, categories, history and chapter states come across. What cannot come across is the sources: a Mihon backup refers to Mihon extensions, and you will need the matching Mohyeong extension for each source before those entries load.

Can I run Mihon and Mohyeong together?

Yes. Different package names, separate libraries, separate storage.

Where is the Updates tab?

It is Tonight, on Home. It does everything the separate tab did: refresh, filters, day grouping, search, bulk selection.

Why is there no light theme?

See Appearance. Briefly: there is nothing behind the switch, and a switch that moves nothing is worse than no switch.

Is this endorsed by the Mihon team?

No. Mohyeong is an independent project that follows Mihon's behaviour closely. Do not take problems here to them.