Download · Main Repository · Report an Issue · Discord · Website · GitHub
Important
Please read the DMCA & Legal Disclaimer before using, modifying, distributing, or contributing to Nekomo.
This repository contains the source code for Nekomo, an anime and manga tracking client for Android and Android TV. The application itself does not host any anime or manga content.
- 🎌 AniList, MyAnimeList and Kitsu sign-in and sync (AniList is also the metadata catalogue)
- 🧩 Bring your own sources. Nekomo ships with no sources, repositories or extensions. You add a repository URL
yourself and install what you want. Supported: CloudStream (
.cs3), Zangetsu (JS), Aniyomi (anime APKs) and Mihon (manga APKs,index.min.jsonorindex.pb) - 🔀 Per-title source chooser, plus settings to show movies/TV shows and 18+ content (both off by default; the 18+ switch asks you to confirm your age)
- 📖 Built-in manga reader for Mihon sources
- 📱🖥️ Phone and Android TV flavors from one codebase, with stable / beta / debug channels
- 🔄 In-app updater that reads GitHub releases (stable or pre-release channel, configurable repositories)
- 🏠 Customizable home page: trending, popular, recently updated, recommended and genre rows. Choose your sources (AniList by default; optional MyAnimeList via Jikan and Kitsu; official-service link-outs such as Crunchyroll and HIDIVE; rows from your own CloudStream providers), switch rows on or off and reorder them
- 🔎 Search history, plus a rich title page (rating, status, genres, format, season, studio, release date, synopsis)
- 🛟 Backup metadata APIs: if AniList fails or rate-limits, Kitsu and MyAnimeList (Jikan) take over automatically
- 🎬 Movies and TV shows (TVMaze, plus TMDB with your own free key) when you turn them on, with episode lists for everything
- 🔽 Sources dropdown on every title page (your preferred source first), tracker-only mode with episode progress when no sources are installed
- 🪟 Pop-out (picture-in-picture) player and external player support
- 📚 Offline library that works without an account (export, import, or sync to AniList later)
- 🕶️ Incognito mode and an optional device-lock for the 18+ switch
- 📄 In-app About, DMCA notice and Rules pages that link to the full text on the website
- 🔒 Optional DNS-over-HTTPS for the app's own API traffic
- 🪵 Persistent in-app error log with one-tap GitHub issue reporting
All builds are collected in apks/: run ./gradlew assembleAllApks to build the six variants (phone/TV x stable/beta/debug) and refresh apks/latest.json.
Requires a JDK 17 and the Android SDK (versions per app/build.gradle). The app supports Android 7.0 (API 24) and newer.
./gradlew assemblePhoneDebug # phone build
./gradlew assembleTvDebug # Android TV build
./gradlew lintRelease outputs are named Nekomo-<phone|tv>-<release|beta|debug>.apk. Publish them as GitHub release assets with
scripts/publish-release.sh <version> [stable|beta] — the in-app updater matches those names. The website's direct-download links point at the apks/ folder of this repo (fixed file names, overwritten on every build), so rebuilt APKs are committed there.
Tip
On Windows/OneDrive, a first build can fail with AAPT: failed writing to ... R.txt. It's transient — just re-run the same command, one variant at a time.
Contributor and architecture notes live in AGENTS.md.
| Path | Description |
|---|---|
app/src/main/java/com/lagradost/shiro/ui |
Screens: player, settings, welcome gate, library |
app/src/main/java/com/lagradost/shiro/utils |
API clients, DoH, error logger, extractors |
app/src/main/java/com/lagradost/shiro/utils/cs3 |
CloudStream plugin manager and bridge |
app/src/main/java/com/lagradost/shiro/utils/zg |
Zangetsu (JavaScript) source engine |
app/src/main/java/com/lagradost/shiro/utils/aniyomi, utils/mihon |
Aniyomi / Mihon extension loaders and bridges |
app/src/main/java/com/lagradost/shiro/ui/manga |
Manga browse, details and reader screens |
app/src/main/java/eu/kanade, tachiyomi |
Vendored Aniyomi/Mihon extension API (Apache-2.0) |
app/src/main/java/khttp |
OkHttp-backed HTTP facade |
app/libs/cs3api.jar |
CloudStream API used by extensions |
| Link | |
|---|---|
| 💬 Discord | discord.com/invite/E4Ezmgg7Ka |
| 🐙 GitHub org | Nekomo-App |
| 📦 App releases | Nekomo-App/Nekomo |
| 🧑💻 Source code | Nekomo-App/neko-source |
| 🐛 Issues | Report a bug |
| 🌍 Website | nekomoapp.netlify.app |
Contributions are welcome — code, bug reports, docs, and testing. Use GitHub for code and issues, and the Discord for discussion.
Click to expand — read before using, modifying, distributing, or contributing
Nekomo provides anime and manga tracking functionality. It does not host, upload, store, or directly distribute anime or manga content.
Information displayed within the application — titles, artwork, descriptions, episode information, and other metadata — may be obtained from public third-party APIs such as AniList, MyAnimeList, and Kitsu.
Nekomo is not affiliated with, endorsed by, sponsored by, or officially connected to these services unless explicitly stated otherwise.
Any anime or manga links accessible through Nekomo may be provided by third-party plugins or external services. These plugins, links, and sources:
- Are not owned or operated by Nekomo
- Have no official affiliation with the Nekomo development team
- May change, become unavailable, or be removed without notice
- Are outside the control of Nekomo and its contributors
Users are solely responsible for how they use the application and any external services accessed through it. By using Nekomo, you agree to:
- Comply with all applicable laws and regulations
- Respect copyright and intellectual property rights
- Follow the terms of service of third-party providers
- Avoid using Nekomo to stream or download copyrighted content unlawfully
The Nekomo developers, maintainers, contributors, and staff are not responsible for misuse of the application or content accessed through third-party services.
If you believe content accessible through a third-party source infringes your rights, please contact the relevant source website, provider, or hosting service directly. Nekomo cannot remove, modify, or manage content that it does not host, own, operate, or control.
By downloading, installing, modifying, distributing, contributing to, or using Nekomo, you acknowledge and agree to the terms of this disclaimer.
- Nekomo began as a fork of Shiro (MIT, see
LICENSE); that notice is preserved. - The distributed app also contains GPL-3.0 components (the CloudStream API in
app/libs/cs3api.jar, NiceHttp, NewPipeExtractor and Zangetsu-derived code), so the app as a whole is distributed under the GNU GPL v3.0 or later (COPYING). The complete corresponding source is this repository. - Every third-party library and its license:
THIRD_PARTY_LICENSES.md(also in the app under Settings → About → Open-source licenses). Regenerate withscripts/gen_licenses.py. - Nekomo bundles no sources, repositories or extensions. Anything you install yourself keeps its own license.
- Website: https://nekomoapp.netlify.app (screenshots, sources guide)
- App: Nekomo and its code in Neko-Source
- Docs: Nekomo-Docs and Nekomo-Extensions
- Website source: Nekomo-Main-Web
- Legal: Nekomo-DMCA
- Companion app: NEX (Nekomo Extension Exchange), a manager for repositories and extensions across Nekomo, Mihon, Aniyomi, CloudStream and Zangetsu
- Brand: Nekomo-Branding
- Fun: Neko-Run (the pixel cat game on the website's 404 page)
- History: OG-Kuro-No-Source (archive) and Nekomo-Web (retired)