Getting started
Nyora runs on Android, Windows, macOS, Linux, iOS / iPadOS and the web — one library that syncs across all of them. Pre-built binaries are published to each build's GitHub Releases page. Prefer to compile it yourself? The build-from-source guide covers every target, and the FAQ answers the common follow-ups.
No account needed to read. Reading, browsing, downloading and local CBZ files all work fully offline. Signing in to your Nyora account is optional and only powers cross-device sync — see First run below.
Pick your platform
- Android & tablets — universal
.apk, Android 6.0+ - Windows — x64 / ARM64
.exe, Java bundled - macOS — Homebrew cask or
.dmg(Apple Silicon) - Linux — one-line installer, or
.deb/.rpm/ portable - iOS & iPadOS — sideloaded
.ipa, iOS 17+ - Web — nothing to install, open it in any browser
- Docker — self-host the whole reader locally,
docker run
Android & Android tablets
Stable. Ships as a single universal APK that adapts to phones and tablets, and supports Android 6.0+. It includes the mobile reader, offline downloads, library management, sync, and AI page translation.
- Download the latest Android APK from the releases page.
- Open it. If this is your first sideloaded app, Android prompts you to allow installs from your browser / file manager — toggle it on and return.
- Tap Install, then Open. That's it — no separate runtime or extra downloads.
On supported Android versions the UI uses Material You and adapts to your wallpaper. Continue to First run to add sources and (optionally) sign in.
Windows
Stable. Two architecture-specific installers are published — pick the one that matches your CPU. Java is bundled, so there is no separate JRE to install. 32-bit Windows is not supported.
- Download
Nyora-Windows-x64.exe(Intel / AMD x64) orNyora-Windows-arm64.exe(Windows on ARM). - Run the installer and follow the prompts. Launch Nyora when it finishes.
Optional: enable OCR languages for AI translation
Windows page translation uses the built-in Windows.Media.Ocr engine.
Recognising Japanese, Korean and Chinese needs the matching Language OCR
Features on Demand. Open PowerShell as Administrator and run:
'ja-JP','ko-KR','zh-CN','zh-TW' | ForEach-Object { Add-WindowsCapability -Online -Name ('Language.OCR~~~' + $_ + '~0.0.1.0') } This installs OCR packs for Japanese, Korean and Chinese (Simplified + Traditional), used for page recognition and text clustering. English works without extra packs.
macOS
Stable, Apple Silicon only (the build bundles an arm64 Java runtime; Intel Macs are not supported). There are two ways to install.
Homebrew (recommended)
The cask installs without quarantine, so you skip the Gatekeeper prompt entirely:
brew tap Hasan72341/nyora
brew trust hasan72341/nyora
brew install --cask --no-quarantine nyora Updates later are just brew upgrade --cask nyora.
Manual DMG
- Download the
.dmgfrom releases and open it. - Drag Nyora into the
Applicationsfolder.
The app is ad-hoc signed (not notarised yet), so macOS asks you to allow it once on first launch:
- macOS Sonoma and earlier: right-click the app → Open → Open.
- macOS Sequoia (15+): double-click it, then go to System Settings → Privacy & Security and click Open Anyway.
- Or, from Terminal — clear the download quarantine in one go:
xattr -dr com.apple.quarantine /Applications/Nyora.app
After allowing it once, it opens normally every time. (Homebrew with --no-quarantine avoids this step.)
Linux
Stable. A Java runtime is bundled, so no separate JRE is needed. Builds are available for x86_64 and ARM64. The desktop UI uses Material You.
One-line install (recommended)
The installer auto-detects your distro and CPU and pulls the right package:
curl -fsSL https://raw.githubusercontent.com/Hasan72341/nyora-linux/main/install.sh | bash Install a package manually
- Debian / Ubuntu — download
Nyora-linux-x86_64.deb, then:sudo apt install ./Nyora-linux-x86_64.deb - Fedora / RHEL — download
Nyora-linux-x86_64.rpm, then:sudo dnf install ./Nyora-linux-x86_64.rpm - Any distro (portable) — download
Nyora-linux-x86_64-portable.tar.gz, then extract and run:tar -xzf Nyora-linux-x86_64-portable.tar.gz && cd nyora && ./bin/Nyora
Page translation on Linux uses Tesseract OCR on-device; install your distro's Tesseract language data for the scripts you read.
iOS & iPadOS
Stable, native Swift app. Requires iOS / iPadOS 17+. It is not on the App Store (TestFlight is planned), so it is installed by sideloading a single universal IPA.
- Install a sideload tool that re-signs with your own Apple ID — AltStore or Sideloadly.
- Download the latest
Nyora-iOSIPA (v2.1.0) from releases. - Open the IPA with AltStore / Sideloadly and let it re-sign and install onto your device.
Sideloaded apps need periodic re-signing (roughly weekly, an Apple free-developer limit). Use AltStore's auto-refresh, or re-run the sideload manually, to keep Nyora launching.
Web
Stable and zero-install. Open nyoraweb.pages.dev in any modern browser to read, browse and manage your library. Sign in to your Nyora account to sync with your other devices. On mobile you can Add to Home Screen to run it as a PWA for an app-like experience.
Self-host with Docker
Run the whole reader on your own machine. The Docker image bundles the web interface and
the parser helper (the Kotatsu engine) in one container, so every source is
parsed locally — nothing hits the cloud to read. One command and you're on
localhost:8080:
docker run -d -p 8080:8080 -v nyora-data:/data hasan72341/nyora
For sources behind a Cloudflare challenge, use docker compose up from the
nyora-docker
repo — it adds a FlareSolverr sidecar. The image is on
Docker Hub.
Library sync is optional (self-host it or use a guest session); everything else stays on your
machine. Full config and topology are in the
repo README.
First run — set things up
However you installed Nyora, the first launch is the same three optional steps. None of them are required to start reading.
1. Sign in (optional)
Reading, browsing, downloading and opening local CBZ files all work without an account. Signing in turns on free Nyora Sync so your library, custom categories, reading history, bookmarks and reading progress (down to the exact chapter and page) follow you across Android, iOS / iPadOS, macOS, Windows, Linux and the web. There is no premium tier and no subscription — sync is completely free.
Note: downloaded chapter files are not synced — they live on each device's storage. Only your reading state syncs.
Nyora Sync — one account everywhere
Nyora Sync is one account across the whole ecosystem. The same
sign-in works in the native apps, the web app, and the Python and JavaScript SDK
TUIs — a title you favourite to your library on any of them shows up
everywhere else you are signed in. Under the hood it is OAuth2 + JWT against Nyora's
sync server, with last-write-wins merges, so the newest change always wins. Developers
can drive the same account directly through NyoraSync in the
SDKs.
2. Add sources to browse
Nyora connects to ~960 sources from one cloud catalog covering manga, manhwa and manhua (the same catalogue on macOS, Windows, Linux, iOS and the web). Open Explore / Sources, then enable the sources you want and pin your favourites. From there, browse Popular and Latest or search a source directly, and tap a title to add it to your library.
On Android you can go further and install native Tachiyomi, Mihon and Keiyoushi extensions on top of the built-in catalogue. Other platforms use the built-in catalogue only.
3. Restore your library
If you have used Nyora before on another device, just sign in with the same Nyora account — your library, categories, history, bookmarks and per-chapter / per-page progress restore automatically over sync, no manual import needed. Coming from a fresh install, add a few sources and titles and your library starts syncing from this device onward.
Optionally connect a tracker — AniList, MyAnimeList, Shikimori or Kitsu (availability varies by platform) — to push and pull reading progress with public reading lists. Trackers run side-by-side with Nyora's private cloud sync.
Reading basics
Open a title and start reading. Reader settings are remembered per title:
- Standard (paged): Left-to-Right or Right-to-Left, with optional double-page spreads.
- Webtoon: continuous vertical scrolling.
- Gestures: pinch to zoom, tap zones to turn pages, volume keys for paging.
- On-the-fly tuning: brightness, contrast and colour filters adjust live while reading.
- Themes: Light, Dark, System and true-black AMOLED.
Want to read offline? Use the in-app download manager (batch and
queue supported) to save chapters to device storage, or open a local .cbz
archive. For privacy, enable App Lock (PIN / biometric on mobile) or
Incognito mode to read without saving to history.
Where to next
- Build from source — clone, build and package every target yourself.
- FAQ — sources, sync, translation, privacy and troubleshooting.
- Developers — the Python and JavaScript SDKs, the Nyora cloud helper, the REST API and cloud sync.