Skip to content
forked from deceptions/no

About

The open-source Kotlin codebase for Nekomo, including its Android and Android TV apps, source integrations, media player, manga reader, and tracking features.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

 
 

Repository files navigation

Nekomo logo

Nekomo Source Code

The open-source codebase for the Nekomo application

Kotlin Platform Discord Stars

Download · Main Repository · Report an Issue · Discord · Website · GitHub

Important

Please read the DMCA & Legal Disclaimer before using, modifying, distributing, or contributing to Nekomo.


✨ About

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.json or index.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

🛠️ Building

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 lint

Release 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.


🗂️ Project Layout

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

🌐 Socials

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
Join the Nekomo Discord server

💬 Community & Contributing

Contributions are welcome — code, bug reports, docs, and testing. Use GitHub for code and issues, and the Discord for discussion.


⚖️ DMCA & Legal Disclaimer

Click to expand — read before using, modifying, distributing, or contributing

📚 Content and Metadata

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.

🔗 Third-Party Plugins and Sources

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

👤 User Responsibility

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.

📩 Copyright Concerns

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.

✅ Agreement

By downloading, installing, modifying, distributing, contributing to, or using Nekomo, you acknowledge and agree to the terms of this disclaimer.


📜 License

  • 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 with scripts/gen_licenses.py.
  • Nekomo bundles no sources, repositories or extensions. Anything you install yourself keeps its own license.

Nekomo logo

猫も — Nekomo — Cat too.

Track responsibly. Respect copyright. Follow applicable laws.

Project links

About

The open-source Kotlin codebase for Nekomo, including its Android and Android TV apps, source integrations, media player, manga reader, and tracking features.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages