Frequently asked questions

Nyora is a free, open-source manga reader for nearly every platform — Android, iOS/iPadOS, macOS, Windows, Linux, and a no-install web app. It connects to 960+ online sources, downloads chapters for offline reading, translates whole pages with AI, and keeps your library in sync across all your devices. It reads manga, manhwa, and manhua.

Yes. Nyora is built on the open-source Kotatsu engine and gives you a similar experience to Tachiyomi and Mihon — a free, ad-free, extensible reader that pulls from many online sources with no account required. The difference is reach: where Tachiyomi/Mihon and Kotatsu are Android-only, Nyora is truly cross-platform — Android, iOS/iPadOS, macOS, Windows, Linux and a no-install web app, all sharing one synced library — and it adds whole-page AI translation. If you want a Tachiyomi- or Mihon-style manga reader on iOS, desktop, or the web, Nyora is it.

Yes, it is completely free forever with no ads, no premium tier, and no tracking. Every feature — AI translation, offline downloads, and cloud sync — is available to everyone at no cost. There is no subscription and nothing is paywalled.

No. Nyora is a reader, not a host — it does not store or own any manga. It connects to third-party online sources that you choose. Nyora is not affiliated with any of the sources it can access.

No. You can install Nyora and start reading immediately with no sign-up. An account is only needed if you want to sync your library across multiple devices, which is entirely optional.

It depends on the sources you browse — there are sources in many languages. For pages in a language you do not read, Nyora's whole-page AI translation can translate the text and place it back over the original art.

Android (6.0+), iOS and iPadOS (17+), macOS (Apple Silicon), Windows (x64 and ARM64), Linux (x86_64 and ARM64), and the web app in any modern browser. All of them share one synced library when you sign in. There are also developer SDKs for Node.js and Python.

Yes. There is a JavaScript/TypeScript SDK (nyora-sdk on npm) and a Python SDK (nyora on PyPI). Both let you browse sources, search, fetch manga details and chapters, resolve page image URLs, and download chapters as .cbz — without a JVM or the desktop app. They are tools for building on Nyora's source catalogue, not consumer reading apps.

Download the latest Nyora.apk from the Android releases page, allow installs from your browser or file manager when prompted, then open the APK to install. It is a single universal APK. Nyora supports Android 6.0 and newer, and adapts to both phones and tablets.

Download Nyora-Windows-x64.exe for most PCs, or Nyora-Windows-arm64.exe for ARM64 machines, and run the installer. A Java runtime is bundled, so there is nothing else to install. 32-bit Windows is not supported.

The easiest way is Homebrew, which installs without the security prompt: run brew tap Hasan72341/nyora, then brew trust hasan72341/nyora, then brew install --cask --no-quarantine nyora. Alternatively download the .dmg and drag Nyora into Applications. macOS is Apple Silicon only for now; Intel Macs are not supported.

The simplest path is the one-line installer, which auto-detects your distro and CPU: curl -fsSL https://raw.githubusercontent.com/Hasan72341/nyora-linux/main/install.sh | bash. You can also install a .deb (Debian/Ubuntu) with sudo apt install ./Nyora-linux-x86_64.deb, an .rpm (Fedora/RHEL) with sudo dnf install ./Nyora-linux-x86_64.rpm, or a portable tarball (extract it and run ./bin/Nyora). A Java runtime is bundled, and builds exist for x86_64 and ARM64.

The iOS/iPadOS app is distributed as a single universal IPA that you sideload using AltStore or Sideloadly, which re-sign the app with your own Apple ID. Download the Nyora-iOS .ipa from the iOS releases page and follow your sideloader's steps. It requires iOS/iPadOS 17 or newer. App Store distribution is not available; TestFlight is planned.

Because Nyora connects to third-party manga sources, it is distributed directly rather than through the official stores. On Android you install the APK directly; on iOS you sideload the IPA with your Apple ID. This keeps Nyora free and store-policy independent.

Yes. Open nyoraweb.pages.dev in any modern browser and start reading — there is nothing to download. You can also add it to your home screen as an app-like PWA, and sign in to your free Nyora Cloud account (email and password) to sync with your other devices.

The web app covers core reading, browsing, your library, and Nyora Cloud sync, and runs entirely in your browser. Some platform-specific extras (like Android's broad extension support, on-device AI translation, or app-lock) live in the native apps, but for everyday reading the web app stands on its own.

The macOS build bundles an Apple Silicon (arm64) Java runtime, so it runs natively on M-series Macs. Intel Macs are not supported. On Apple Silicon you can install via Homebrew or the .dmg.

Nyora reads from a built-in catalogue of 960+ third-party online sources, with additional installable extensions on Android. You browse, search, and filter these sources inside the app. Nyora itself does not store any of the content.

On Android, Nyora's source system is compatible with Tachiyomi, Mihon, and Keiyoushi extensions, so the extensions you already trust work out of the box. On the other platforms you use the large built-in catalogue rather than installable extensions.

Every platform ships the same curated catalogue of 960+ built-in sources, and Android additionally supports installable Tachiyomi, Mihon, and Keiyoushi extensions on top. The built-in list is curated to include sources that work reliably on each device.

Sources run on the Nyora cloud helper, so parser fixes go live centrally the moment they land — when a site changes its layout, the fix reaches every device instantly, with no app update and nothing to download. The SDKs and apps simply call the cloud, so the catalogue (~960 sources) is always current.

Nyora is just a reader — like a web browser, it is a neutral tool. The legality depends on the specific sources you access and your local laws. You are responsible for how you use it and for respecting the rights of content owners and creators.

When a title you love is available officially, buying it or reading it through an official, licensed channel is the best way to support the artists and publishers who make it. Nyora does not pay creators, and supporting them directly keeps the industry healthy.

Yes. Nyora treats adult content carefully; for example it can prompt to open potentially adult titles in incognito mode, and offers an option to automatically use incognito for NSFW manga so it is not recorded in your history.

Yes. Sign in with Nyora Sync and your library, custom categories, reading history, bookmarks, and reading progress sync across Android, iOS/iPadOS, macOS, Windows, Linux, and the web. Finish a chapter on one device and resume from the exact chapter and page on another.

Sign in with Nyora Sync from within the app or the web version. Once signed in on two or more devices with the same Nyora Sync account, your reading state moves between them automatically.

Yes, completely free. It runs on Nyora's own sync service and there is no paid tier for it.

No. Sign-in is purely opt-in and exists only to move your reading state between your own devices. You can use Nyora fully offline and never sign in if you prefer.

Your library, custom categories, reading history, bookmarks, and reading progress (the exact chapter and page you are on). It carries your reading state — not the manga files themselves. Downloaded chapters are never synced and stay on each device's local storage.

No. Only reading state syncs. Downloaded files remain on the device you downloaded them to, so if you want a title offline on a second device you download it there as well. This keeps sync fast and your data usage low.

Yes. Sign in with the same Nyora Sync account on each device and they will share one library and stay in sync. That is the whole point — one library that lives on your phone, laptop, and the web at once.

Nyora Sync is the optional account system that keeps your library, history, bookmarks, and reading progress synced between your own devices. It is used solely for sync — not for ads, tracking, or analytics.

Left-to-right and right-to-left paged reading, plus a dedicated continuous vertical (webtoon) reader. It also supports pinch zoom and double-page spreads, with full gesture support throughout the reader.

Yes. The reader supports tap zones and, on supported devices, volume-key paging, alongside pinch zoom. You can read comfortably with one hand or without touching the screen at all.

Yes. Nyora has per-title settings, so each series can remember exactly how you like to read it — direction, layout, and more — independently of your other titles and persistent across sessions.

Light, Dark, System (follow your OS), and a true-black AMOLED theme that is easy on the eyes and saves battery on OLED screens. Android and Linux additionally use Material You, adapting accent colors to your wallpaper on supported systems.

While reading, tap the screen to bring up the overlay and open the settings to adjust brightness, contrast, and color filters live as you read. Nyora also applies dynamic color correction for crisp, balanced pages.

Nyora performs whole-page AI translation: it detects the text baked into a manga page with OCR, translates it, and typesets the translated result back over the original artwork — so you read the panel exactly as the artist drew it, just in your language. There is no separate subtitle track.

Android uses an on-device ML model with an offline fallback. Windows uses the built-in Windows.Media.Ocr (you install the relevant Language OCR packs). macOS uses Apple Vision plus a bundled MangaOCR CoreML model, fully on-device. Linux uses Tesseract on-device. iOS/iPadOS uses on-device OCR with Apple Intelligence refinement on supported devices. The engine differs per platform to make the best use of each device's hardware.

Windows translation relies on optional Language OCR Features on Demand. In an elevated (Administrator) PowerShell, run: 'ja-JP','ko-KR','zh-CN','zh-TW' | ForEach-Object { Add-WindowsCapability -Online -Name ('Language.OCR~~~' + $_ + '~0.0.1.0') }. This installs Japanese, Korean and Chinese (Simplified and Traditional) OCR so page recognition and text clustering work.

On platforms with on-device engines, yes. Where applicable you can download the ML models in Settings to act as an offline fallback when you have no connection. The exact behavior depends on the platform's translation engine.

It is automatic machine translation, so it is fast and convenient but not flawless — expect occasional awkward phrasing, especially with stylized or hand-lettered text. It is meant to let you enjoy raws and untranslated chapters, not to replace professional translation.

To browse and stream from online sources, yes. But chapters you have downloaded read with zero signal at full quality, and on platforms with on-device translation engines, downloaded models let translation work offline too.

Yes. Download chapters while you have signal and read them later with zero connectivity, at full quality. Offline downloads are a first-class feature on every platform, not a premium-gated add-on.

Yes. Nyora can open local CBZ archives (Comic Book Zip) from your device storage, so you can read a portable collection alongside online sources. The SDKs can also save chapters as .cbz for you.

Downloads are saved to your device's local storage and remain available with no connection. Because they are stored locally, they are not part of cloud sync — only your reading state syncs, not the files.

Yes. Nyora has an in-app download manager with batch and queue support, so you can queue a whole run of chapters, watch their progress, and remove them when you are done. You choose exactly which chapters to keep.

Long series and high-resolution pages can add up, but you control exactly which chapters you download and you can remove them when you are done. Manage your downloads from the in-app download manager.

No. Nyora contains zero ads, zero tracking, zero analytics, and zero telemetry. No account is required to read, and what you see in the open-source code is what runs on your device.

On mobile, yes. Nyora can require a PIN when you start the app, and use your fingerprint or biometric unlock if your device supports it. Turn this on under the app's protection settings.

Incognito mode lets you read without saving anything to your history or reading progress. You can also set Nyora to automatically use incognito for NSFW manga, and on iOS and Android optionally block screenshots while incognito for extra privacy.

Yes. Nyora Sync is optional and exists solely to carry your library, history, bookmarks, and progress between your own devices. If you prefer, you can never sign in and keep everything local.

Nyora can push and pull reading progress with AniList, MyAnimeList (MAL), Shikimori, and Kitsu, so your list stays accurate no matter where you read. Tracker availability varies slightly by platform — Android has the broadest support — so check your platform's settings for which services are wired up.

Sign in to your tracker account (AniList, MyAnimeList, Shikimori, or Kitsu) from Nyora's settings, then link your titles. From then on Nyora keeps your reading progress synchronized with that service in both directions.

Trackers (AniList, MAL, Shikimori, Kitsu) keep your public reading lists up to date on those services. Nyora's own Nyora Cloud sync carries your full private library state — library, categories, history, bookmarks, and exact progress — between your devices. They work side by side.

The source is open and auditable. The Android app is GPLv3 (it is a fork of Kotatsu); every other port — Windows, macOS, Linux, iOS, web, and the SDKs — is original code released under Apache 2.0.

Grab the latest build from your platform's GitHub releases page. On macOS you can update via Homebrew, and the web app at nyoraweb.pages.dev is always the latest version automatically. Sources run on the Nyora cloud helper, so parser fixes go live centrally with no app update and nothing to download.

Yes. The entire ecosystem is open and auditable. The Android app is licensed under GPLv3 (as a fork of Kotatsu), and every other port is original code released under Apache 2.0.

Yes. Each platform lives in its own repository under the Hasan72341 GitHub account. Android builds with Android Studio and JDK 17+ (./gradlew assembleRelease); the desktop ports share a Kotlin engine and build with Gradle (for example ./gradlew :desktopApp:run on Linux); iOS builds in Xcode with the Swift toolchain. See the build-from-source guide for the exact command per target.

Windows uses .\gradlew.bat :desktopApp:packageReleaseExe (x64 and ARM64 build separately). Linux uses ./gradlew :desktopApp:packageReleaseDeb, :packageReleaseRpm, or :createReleaseDistributable for a portable build. macOS uses ./macApp/scripts/build-dmg.sh, which produces build/Nyora.dmg. The desktop ports share a Kotlin engine as a git submodule, so clone with --recurse-submodules.

From nyora-ios/NyoraApp/, build a sideload-ready release with: xcodebuild -scheme Nyora -sdk iphoneos -configuration Release CODE_SIGNING_ALLOWED=NO build. For the simulator use -sdk iphonesimulator -configuration Debug. Then re-sign the resulting IPA with AltStore or Sideloadly to install it on your device.

Absolutely. Bug fixes, new sources, translation improvements, UI polish, and documentation are all welcome. Pick the repository for your platform, open an issue or pull request, and dive in — whether you write Kotlin, Swift, TypeScript, or Python.

Nyora is created and maintained by Md Hasan Raza, with thanks to everyone who contributes sources, translations, and feedback.

There are two: a JavaScript/TypeScript SDK (nyora-sdk on npm) and a Python SDK (nyora on PyPI). They wrap the same source parsers the apps use, so you can list sources, browse popular/latest, search, fetch manga details and chapter lists, resolve page image URLs, and download chapters as .cbz — from your own code or the command line. They are not consumer reading apps and they do not include the OCR/translation pipeline.

The JavaScript SDK needs Node.js 18 or newer; it is pure ESM with TypeScript types and is a thin cloud client over the Nyora helper (native fetch, no parser runtime, no JVM). The Python SDK needs Python 3.10 or newer and is pure Python with full type hints and both sync and async clients. Both also ship the NyoraSync client for cloud account + library sync.

JavaScript: npm install nyora-sdk for the library, or npm install -g nyora-sdk to put the nyora-cli (and nyora alias) on your PATH. Python: pip3 install nyora, which provides the library and a nyora-cli command.

Create a client and call its namespaces: const client = new Nyora(); then client.sources.list(), client.sources.find("id or fuzzy name"), client.manga.popular(sourceId), client.manga.latest(sourceId), client.manga.search(sourceId, query), client.manga.details(sourceId, url, options), and client.manga.pages(sourceId, chapterUrl). Call client.close() when done. Methods that hit a source are async.

Use it as a context manager: with Nyora() as client: source = client.sources.find("asura"); page = client.manga.popular(source.id, page=1); results = client.manga.search(source.id, "query"); details = client.manga.details(source.id, entry.url, title=entry.title); pages = client.manga.pages(source.id, chapter.url). An AsyncNyora client with the same namespaces is available for asyncio.

No. Both SDKs are thin clients over the Nyora cloud helper (api.nyora.xyz) — there is no on-device parser engine to maintain. When a site changes and the fix lands on the cloud helper, every SDK call picks it up immediately, with no package upgrade and nothing to download.

No. In v2 both SDKs are thin cloud clients: by default they call the hosted Nyora cloud helper at api.nyora.xyz (~960 sources), so there is nothing to run yourself. If you already have a Nyora desktop app open, it exposes the same REST contract on a local 127.0.0.1 helper you can point the SDKs at instead. Either way the routes are identical — /sources, /sources/popular, /sources/latest, /sources/search, /manga/details and /manga/pages.

Both ship a nyora-cli. Common subcommands: sources [--search Q], popular -s SRC, latest -s SRC, search -s SRC QUERY, details -s SRC URL, pages -s SRC CHAPTER_URL, download -s SRC -o OUT CHAPTER_URL (saves a .cbz), and version. Add --json to any command for machine-readable output you can pipe to jq. Running nyora-cli with no subcommand opens the interactive terminal reader (TUI), where 'sync' signs in and 'lib' opens your synced library.

They are close but not identical. The Python CLI adds a batch subcommand (batch -s SRC MANGA_URL [-o DIR]) to download every chapter of a title, and a nyora-tui entry point. On the JavaScript CLI the pages and download subcommands accept a --branch flag, and search/popular/latest accept -p N for paging. Run nyora-cli -h on either to see its exact options.

Yes. Running nyora-cli with no subcommand launches an interactive terminal reader (TUI) where you browse popular/latest/search, open a title, and page through chapters. In a non-interactive shell it prints a notice and exits cleanly instead of hanging.

They do not host a consumer reading UI, do not bundle the OCR/translation pipeline (translation lives in the consumer apps), and do not bypass any source access controls. They are focused on source and parser access, not on the full reading experience or trackers.

The app is ad-hoc signed (not notarised yet), so macOS asks you to allow it once. On Sonoma and earlier, right-click the app and choose Open, then Open again. On Sequoia (15+), double-click it, then go to System Settings > Privacy & Security and click Open Anyway. You can also run xattr -dr com.apple.quarantine /Applications/Nyora.app in Terminal. Installing via Homebrew with --no-quarantine avoids the prompt entirely.

When you open the APK, Android asks permission to install from your browser or file manager. Allow installs from that app when prompted, then tap the APK again to continue. This is normal for apps installed outside the Play Store.

Apps sideloaded with a free Apple ID are signed for a limited period (about a week) and need to be re-signed periodically. Open AltStore or Sideloadly and refresh or re-install Nyora to renew it. Using AltStore's background auto-refresh helps it renew automatically.

Online sources are run by third parties and can go down, change their site, or be temporarily unreachable. Check your internet connection, try again later, or use a different source for the same title. Because sources run on the Nyora cloud helper, parser fixes land centrally and reach every device without an app update.

Make sure you are signed in with the same Nyora Sync account on each device and that you have a connection. If sign-in fails, sign out and back in, and confirm you are on the latest build. Remember that only your reading state syncs — downloaded files stay on each device.

Whole-page translation needs a working OCR engine for your platform. On Windows, install the Language OCR packs for the languages you read (see the OCR question above). On platforms with downloadable models, fetch them in Settings for offline use. Results also vary with the source image quality and the language on the page.

For Android, run ./gradlew clean and restart Android Studio, and keep ksp.incremental=false if you hit KSP or caching issues. For the desktop ports, make sure you have JDK 17+ on your PATH and clone with --recurse-submodules so the shared engine submodule is present.

If the auto-detecting installer fails, install a package manually instead: sudo apt install ./Nyora-linux-x86_64.deb on Debian/Ubuntu, sudo dnf install ./Nyora-linux-x86_64.rpm on Fedora/RHEL, or the portable tarball on any distro — extract Nyora-linux-x86_64-portable.tar.gz and run ./bin/Nyora. Builds are available for x86_64 and ARM64.

Both SDKs resolve a source by id or fuzzy name — for example client.sources.find("asura") — so try a shorter or more distinctive fragment of the name, or list everything first (client.sources.list() in code, or nyora-cli sources, optionally with --search Q) to find the exact id. Source ids are stable; names can be fuzzy-matched.