AniLit — Help & FAQ


Frequently Asked Questions

About & Usage

What is AniLit?

AniLit is an open-source native Android application for anime discovery, library management, watch tracking, and peer-to-peer torrent streaming. It combines local-first data management, adaptive playback, and third-party anime tracker integrations in one application.

Does AniLit host or upload media content?

No. AniLit is a client application and does not host or operate its own media distribution service. Streaming relies on external sources and peer-to-peer connections where supported. Users are responsible for ensuring that their use of external sources complies with applicable laws.

Does AniLit require an account?

AniLit does not require a CodeNest Duo account. You can use its local library and profile features without registering for a developer account. Connecting third-party anime tracking services is optional and requires the relevant service’s authentication where applicable.

Does AniLit work offline?

Yes, for features that rely on locally stored data. You can access available library information, profiles, watch history, progress, ratings, and notes without an internet connection. Online discovery, tracker synchronization, metadata retrieval, and streaming require network access.

Profiles

Can I use multiple profiles in AniLit?

Yes. AniLit supports multiple independent user profiles on a single device, allowing different users to maintain separate libraries and viewing preferences.

Do profiles share watch history or continue-watching queues?

No. Each profile maintains its own watch history, playback positions, favorites, personal scores, and notes.

What is Kids Profile mode?

Kids Profile mode applies content-filtering rules to help restrict mature or age-restricted titles. Filtering depends on the metadata and classification information available, so it should not be treated as a guaranteed parental-control or content-blocking system.

Can I clear my watch history without losing my list?

Yes. AniLit provides separate library management actions:

  • Clear Watch History: Resets watched episode markers and resume positions while retaining the relevant list entries and other personal data according to the action’s behavior.
  • Remove from List: Removes a title from the relevant tracking list while preserving watch progress.
  • Delete Entry: Removes the title and its associated library data from the active profile.

Always review the confirmation prompt before performing a deletion.

Anime & Tracking

Which anime tracking services does AniLit support?

AniLit supports integrations with AniList, Kitsu, and MyAnimeList, with additional tracking integrations planned or potentially supported as development progresses.

Available integrations may differ by application version.

Can AniLit synchronize my anime progress automatically?

AniLit can synchronize supported information, such as watched episodes, list status, and personal scores, with connected tracking services. The exact fields and synchronization behavior depend on the integration and its API capabilities.

Synchronization requires an internet connection and valid authorization. Conflicts, API limitations, or third-party service outages may affect updates.

How does AniLit display episode details and thumbnails?

AniLit uses external metadata sources to retrieve available episode information, such as titles, summaries, air dates, and thumbnail artwork. Coverage and localization vary by source and series.

What episode view modes are available?

AniLit offers multiple episode layouts to suit different viewing and browsing preferences:

  • Seat Grid: A compact, high-density grid for quickly navigating long-running series.
  • Card Grid: Visual episode cards featuring available thumbnails and titles.
  • Detailed List: An expanded list with episode summaries, air dates, and progress indicators where available.

Streaming

How does peer-to-peer torrent streaming work?

AniLit uses a peer-to-peer streaming approach to retrieve media from available sources and peers rather than relying on a single centralized video server. Playback can begin before the entire media file has downloaded, depending on the streaming implementation, torrent metadata, peer availability, and network conditions.

Does AniLit download the entire episode before playback?

Not necessarily. Its adaptive streaming pipeline is designed to prioritize media data around the current playback position, allowing playback to begin without waiting for the entire file to buffer. Startup time and playback smoothness still depend on source availability and network conditions.

What is adaptive stream buffering?

Adaptive stream buffering is AniLit’s approach to prioritizing the media data needed for playback. Its windowing pipeline focuses on data around the playback position to help reduce startup delays and maintain smoother playback.

Actual performance depends on the source, available peers, connection speed, and device capabilities.

Does peer-to-peer streaming expose my IP address?

Potentially, yes. Peer-to-peer connections may expose your IP address to other participants in the same swarm. Your network activity may also involve external discovery services or trackers, depending on the implementation.

Use external sources responsibly and review your network privacy requirements before streaming.

Which playback engines does AniLit support?

AniLit supports AndroidX Media3 ExoPlayer and an optional MPV playback engine. The available engines provide different playback capabilities and compatibility options.

Does AniLit support styled anime subtitles?

AniLit supports subtitle playback capabilities that depend on the selected engine and media format. The MPV engine can provide advanced styling support for ASS/SSA subtitles, including typesetting, custom fonts, and karaoke effects where supported.

Does AniLit remember where I stopped watching?

Yes. AniLit stores playback progress and resume positions locally for supported episodes, allowing you to continue watching later.

When is an episode automatically marked as watched?

An episode is marked as watched when playback reaches the configured completion threshold. You can also manually mark individual episodes or ranges as watched or unwatched.

Privacy & Security

Does AniLit contain advertisements?

AniLit is designed without in-app advertisements.

Does AniLit collect analytics or telemetry?

AniLit is designed to avoid developer analytics and user-tracking telemetry. However, network activity required for external metadata, tracker synchronization, and peer-to-peer streaming may communicate with third-party services and other peers.

Is my watch history stored online?

Watch history and profile data are managed locally by AniLit. If you connect an external tracking service, supported information may also be synchronized with that service according to your settings and its policies.

Where can I read the Privacy Policy?

Read the AniLit Privacy Policy for information about local data storage, permissions, external integrations, and network operations.

Troubleshooting

Why is a stream slow to start or keep buffering?

Peer-to-peer playback depends on the availability and responsiveness of sources and peers, as well as your network connection and the media itself.

Try the following:

  • Check your internet connection.
  • Try another available source if one is offered.
  • Allow time for peer connections and media data to become available.
  • Check whether the issue occurs with other episodes or sources.
  • Try the alternative playback engine if available and appropriate for the media format.

Adaptive buffering can help prioritize playback data, but it cannot compensate for a source with insufficient availability or bandwidth.

Why is an episode unavailable even though I can find its title?

Catalog metadata and playable media are separate. An episode may have metadata but no available torrent source, insufficient peers, invalid metadata, or an unsupported media format.

Why are some episode titles showing generic numbers?

Episode metadata may be missing, incomplete, or unavailable from the upstream providers. In those cases, AniLit may fall back to standard episode numbering until more information becomes available.

Why is tracker synchronization not working?

Check your internet connection and the authorization status of the connected service. Synchronization may also be affected by API restrictions, expired credentials, rate limits, or third-party outages.

If the issue persists, verify that your AniLit version supports the integration and the data you are trying to synchronize.

Where can I report a bug or suggest a feature?

For bug reports, feature requests, and feedback, contact CodeNest Duo at [email protected].

Include your AniLit version, Android version, device model, and a brief description of the issue. Screenshots or relevant logs can also help with troubleshooting, but remove personal information before sharing them.