The easiest way to watch anime or read manga, light novels, and EPUBs with instant OCR/subtitle lookup. No scripts, no complex setupβjust download and go.
Discord Server: https://discord.gg/tDAtpPN8KK
Traditional setups for watching anime or reading manga with Japanese lookup can be complicated, often requiring users to install Python scripts, browser extensions (like userscripts), and configure local servers manually.
Manatan 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.
- Universal Language Support: Manatan supports every language.
- Built-in OCR: Just hover over text to get selectable text for dictionary lookups.
- Anime Support: Subtitle parsing with popup dictionary lookups while you watch.
- 1-Click Anime Cards: Generate Anki cards from anime sentences with a single click, with sentence audio.
- Light Novels & EPUBs: Read light novels and EPUBs with instant OCR/lookup.
- Cross-Platform: Run the exact same interface on your PC, Mac, Android, or iOS device.
- Browser Interface: Uses the familiar Suwayomi interface in your favorite web browser.
| Windows | Linux | macOS | Android | iOS |
|---|---|---|---|---|
| β | β | β | β | β |
π± iOS Users: The iOS app is currently in Public Beta. Please join our Discord Server to find the TestFlight invite link.
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 Manatan web interface.
video.mp4
- Package Manatan, OCR Server, and Suwayomi into a single binary
- Add Android Support #17
- Add iOS Support #19
- Add Anime Support
- 1 click anime/video cards
- LightNovel/Epub support
- Rust backend rewrite, faster load times, smaller binary, smaller ram usage
- Add Mangayomi, Aidoku, LNReader extension support, ontop of existing Mihon/Aniyomi extension support
- Add local .mkv video support
- Add 1 click setup local audio support for popup dictionary lookups
- Local OCR engine support
- Add Manga Immersion Stats page #1
- Suggest more features https://github.com/KolbyML/Manatan/issues/new
- Download the latest release for your platform from the releases page.
- Windows: Download the
.zipfile forwindows-x86, extract it, then launchmanatan.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.
- macOS: Download the macOS build, unzip it, then open
Manatan.app.- If macOS blocks the app because it is unsigned, go to System Settings > Privacy & Security and click Open Anyway for Manatan, then reopen the app.
- Windows: Download the
- A "Manatan Launcher" window will appear. Click "Open Web UI".
- Windows: Allow Windows Firewall connections if prompted.
- The Manatan 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 Mihon
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 Watching or Reading:
- Go to the "Sources" tab, click your installed source, and find an anime or manga.
- OCR and subtitle lookup are 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:
manatan-windows-x86(Your extraction folder)%LOCALAPPDATA%\Tachidesk%APPDATA%\manatan%Temp%\Suwayomi*%Temp%\Tachidesk*- Browser Data: Clear Site data & cookies for
127.0.0.1
Manatan's text overlay precision relies on a robust set of test cases. We are crowdsourcing data to fine-tune our engine, fix merging errors, and ensure text detection works perfectly across all manga styles.
We need your help! If you have examples of complex text bubbles, or just want to help us prevent future bugs, please contribute to our test suite:
π Contribute to KolbyML/ocr-test-data
Your submissions directly help us improve the reading experience for everyone.
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/Manatan cd Manatan -
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/Suwayomi-WebUI
Manatan 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
The WebUI folder is licensed under MPL-2.0. The rest of this repository is licensed under MIT unless otherwise noted.