Feature guide One app, the whole journey
Nooklet brings discovery, requests, download orchestration, import, and day-to-day operations into one self-hosted workspace. Each screen is designed to answer a simple question: what is ready, what is happening, and what should I do next?
The complete loop
Nooklet keeps each transition visible. A queued download is not presented as a completed request; availability is only confirmed after import and library reconciliation.
Browse current titles, search directly, or ask an optional AI provider for ideas.
Request a movie, a complete season, or selected episodes into the right destination.
Search verified Newznab sources and send a compatible release to Nooklet's built-in engine.
Retry eligible failures, preserve progress, and surface repair steps when infrastructure blocks the plan.
Verify, repair, extract, safely import, scan, and record the final file as available.
Core capabilities
Core request functionality stays independent of recommendations, history, notifications, and external library context. Add the optional pieces that improve your household without turning them into prerequisites.
Discover
Search TMDB, browse filtered catalog views, inspect artwork and context, and generate personal ideas through any compatible AI provider.
Library
Scan movie and TV destinations, reconcile files with title records, monitor wanted content, and keep availability grounded in the filesystem rather than download intent.
Requests
Select a title, season, or episode, review its destination and releases, and follow one durable request through search, queue, transfer, processing, and import.
TV resilience
Nooklet tries alternate complete-season releases for eligible content failures, then automatically falls back to missing aired episodes. Completed work is preserved while unavailable episodes wait.
Download engine
Connect directly to a news server, persist queue state in Nooklet, control queued work, and let the container perform PAR2 verification, repair, and archive extraction.
Storage + import
See the effective staging filesystem, available space, active reservation, and final destinations. Imports remain inside approved canonical roots, refuse unsafe traversal or silent overwrite, and recover claimed cross-filesystem partials without deleting unrelated replacements.
Operations
Setup Center evaluates the real request path. Health, storage, jobs, audit history, and Activity turn failures into bounded states with the next corrective action.
Shared instance
Every administrator edits one canonical infrastructure configuration and shared-service set. Managed users can discover and request without receiving access to service credentials or instance-wide configuration; personal services such as Trakt remain user-scoped.
Designed for the awkward cases
Nooklet separates the user’s desired outcome from individual release attempts. Content failures can advance automatically; storage, credentials, paths, or service failures pause with a repair action instead of generating a storm of doomed episode requests.
Exclude the unusable candidate, try the next eligible pack, or continue with individual episodes.
Preserve the candidate and retry after persisted backoff instead of consuming an attempt.
Block the plan with a corrective message; fix the boundary, then resume recovery from Activity.
Connect what you already use
A complete request path needs metadata, an indexer, a downloader, writable storage, and a healthy worker. Everything else enriches the experience without holding it hostage.
| Capability | Connection | Required? | What it adds |
|---|---|---|---|
| Identity + discovery | TMDB | Core | Title identity, search, artwork, genres, cast, trailers, and discovery. |
| Release search | Newznab indexer | Core | Movie, season, and episode acquisition candidates. |
| Download | Usenet server | Core | Native TLS NNTP transfer through Nooklet's built-in downloader. |
| TV metadata | TVDB | Optional | Additional TV identity and episode metadata. |
| Recommendations | OpenAI-compatible provider | Optional | Personalized ideas using a hosted or local compatible model. |
| Watch context | Plex, Tautulli, or Trakt | Optional | Viewing history and improved recommendation context. |
| Notifications | Discord, Apprise, or webhook | Optional | Completion and attention events outside the app. |
Clear fit, honest boundaries
Nooklet deliberately optimizes for a compact household or personal deployment. Knowing the boundary is part of a frustration-free experience.
A strong fit
Know before installing
Ready when your request path is ready
The User Guide takes you from storage mounts and first administrator through a controlled first request, daily operation, and the exact recovery steps for common failures.