The easiest way to read manga with instant OCR lookup. No scripts, no complex setupβjust download and read.
Discord Server: https://discord.gg/tDAtpPN8KK
Traditional setups for reading manga with Japanese lookup (OCR) can be complicated, often requiring users to install Python scripts, browser extensions (like userscripts), and configure local servers manually.
Mangatan simplifies everything into a single app:
- Zero Configuration: No need to install "Monkey scripts," configure Optical Character Recognition (OCR) tools, or mess with command lines.
- Built-in OCR: Just hover over Japanese text to get selectable text for dictionary lookups.
- Cross-Platform: Run the exact same interface on your PC, Mac, or Android phone.
- Browser Interface: Uses the familiar Suwayomi interface in your favorite web browser.
| Windows | Linux | macOS | Android | iOS |
|---|---|---|---|---|
| β | β | β | β | π§ (Coming Soon) |
Download the latest release for your platform from the Releases page.
Run the executable, then visit http://127.0.0.1:4568/ in your web browser to access the Mangatan web interface.
video.mp4
- Download the
.zipfile forwindows-x86from the releases page. - Extract the
.zip, and inside it launchmangatan.exe.- Note: If prompted by Windows Defender SmartScreen, click More info > Run anyway. If it doesn't run on double-click, right-click the file > Properties > Unblock.
- A "Mangatan Launcher" window will appear. Click "Open Web UI".
- Allow Windows Firewall connections if prompted. The Suwayomi web interface (
127.0.0.1:4568/) should open in a new browser tab.- Please wait ~30 seconds for the initial setup to finish. Reload the page to access the library.
- Adding Sources:
- Go to Settings > Browse > Extension repositories > Add Repository.
- Paste a valid Suwayomi
index.min.jsonextension repository URL (search "mihon extension repos" on Google to find one) and click OK.
- Installing Extensions:
- Go to "Browse" on the left sidebar, then the "Extensions" tab.
- Click "Install" on your desired source.
- Start Reading:
- Go to the "Sources" tab, click your installed source, and find a manga.
- OCR is automatically active! You can use tools like Yomitan immediately.
- For Yomitan Users:
- To ensure sentences are parsed correctly for Anki cards, go to Text parsing in Yomitan's settings (enable Advanced), and set Sentence Termination to "Custom, No New Lines". This prevents OCR line breaks from being treated as sentence endings.
- Disabling ellipsis
β¦as a sentence terminator is also recommended.
You can also read manga files stored locally on your device. To set up local manga:
- Set your local manga directory in Settings β Browse β "Local source location"
- Use one of these paths depending on your platform:
- Android Internal Storage: Use paths like
/storage/emulated/0/YourFolder/ - Android SD Cards: Use
/storage/[SD_CARD_ID]/YourFolder/where [SD_CARD_ID] is the unique identifier Android assigned to your SD card (you can find this using file manager apps like X-plore) - Windows: The default local manga directory is at C:\Users[YourUsername]\AppData\Local\Tachidesk\local)
- You will then be able to find your local manga under Browse β Sources β Local source
Refer to the Suwayomi Local Source documentation for details on how to structure your folders.
To fully clear cache and data from previous installs, delete the following folders and try again:
mangatan-windows-x86(Your extraction folder)%LOCALAPPDATA%\Tachidesk%APPDATA%\mangatan%Temp%\Suwayomi*%Temp%\Tachidesk*- Browser Data: Clear Site data & cookies for
127.0.0.1
- Package Mangatan, OCR Server, and Suwayomi into a single binary
- Add Android Support #17
- Add iOS Support #19
- Add Manga Immersion Stats page #1
- Suggest more features https://github.com/KolbyML/Mangatan/issues/new
We have detailed build instructions for each platform. Please refer to the specific documentation below to set up your environment:
- Windows: Building on Windows (WSL2)
- macOS: Building on macOS
- Linux: Building on Linux
- Android: Building for Android
-
Clone the repository:
git clone --recursive https://github.com/KolbyML/Mangatan cd Mangatan -
Run in Development Mode: Assuming you have the prerequisites installed, you can use the Makefile to setup dependencies and run the app:
make dev-embedded
The following links, repos, companies and projects have been important in the development of this repo, we have learned a lot from them and want to thank and acknowledge them.
- https://github.com/kaihouguide/Mangatan
- https://github.com/exn251/Mangatan/
- https://github.com/Suwayomi/Suwayomi-Server
- https://github.com/Suwayomi/Mangatan-WebUI
Mangatan does not collect, transmit, or share any user data. All data including imported comics, reading progress, bookmarks, and saved vocabulary words are stored locally on your device and never leave it.
The only external communication occurs during OCR which is optional and uses Google Cloud Vision API. When enabled, selected image regions are sent over HTTPS for text recognition only. No user accounts are used, and images are not linked to personal identity. OCR can be disabled at any time in Settings.
No analytics, tracking, or telemetry data is collected.
Last updated: 12/23/2025