Documentation audit¶
Reviewed on 2026-09-18 against app version 1.2.0, repository commit b3291b8e, and the wiki available on that date. The wiki's most recent edit was 2026-07-28, but many individual pages still described earlier behavior.
This site rewrites the retained material around the current implementation. The wiki remains a historical source; it is not imported wholesale into the build.
Wiki disposition¶
| Wiki page / topic | Decision and current home |
|---|---|
| Home | Replace with a task-oriented home page and navigation |
| Features | Retain verified capabilities and add current features |
| Configuration | Replace stale tables with configuration guidance and generated source defaults |
| Environment Variables | Replace the old configuration-library workaround with current variables |
| API | Replace shared-key query examples with per-user Bearer tokens |
| RSS Feed | Retain filters; replace user-ID selection and unauthenticated private-feed examples with RSS token behavior |
| Archive | Retain the skip-history concept; replace text-file storage guidance with database archive behavior |
| Categories | Retain rules and templates; replace unrestricted absolute-path advice, and add existing-file reclassification in current category behavior |
| Notifications | Retain service integrations; add custom templates and event behavior |
| Reverse Proxy Setup | Replace old ports and incomplete subpath recipes with current proxy setup |
| Setting a MongoDB backend | Replace MongoDB-only assumptions with all supported database choices |
| Migrating between MongoDB and PostgreSQL | Retain empty-target and one-time migration rules; add explicit engine selection and verification steps |
| Update MongoDB to 8.x | Retain the need for a vendor-supported staged upgrade; do not reproduce version-specific shell/FCV recipes as universal instructions |
| Chrome Extension | Retain local installation; document current Manifest V3 packaging |
| Firefox Extension | Replace old store/Android collection assumptions with the current package, identity, and temporary-install limitations |
| iOS Shortcuts Workflow | Retire the unverified shared shortcut; use the current API for a shortcut that sends Bearer headers |
| Fixing 403 errors | Retain format/runtime/cookie diagnosis; correct downloader-update behavior in troubleshooting |
| Fixing 429 errors | Retain pacing and waiting; replace the old interval setting and cookie-extension links |
| Synology | Retain the useful firewall diagnosis in NAS and ARM hosts |
| unRAID | Replace pre-release/MongoDB-only instructions with current storage and database guidance |
| Raspberry Pi 4 | Retire the old 32-bit image and MongoDB 4 workaround as a new-install recipe |
| Contributing | Replace obsolete CLI and incomplete architecture sections with current development |
| Translate | Retain XLIFF workflow; use current extraction scripts and avoid assuming an external translation service tracks this fork |
Added coverage and implementation evidence¶
| Area | Primary implementation checked | Guide |
|---|---|---|
| Configuration precedence and retired settings | Config, startup | Configuration |
| Permissions, API tokens, feed tokens, shared media | Authentication modules, API spec | Accounts, API, RSS |
| OIDC, LDAP, ownership assignment | Authentication modules and startup ownership migration | Users, OIDC, and LDAP |
| PostgreSQL, migration, remote snapshots | Database layer, PostgreSQL adapter | Databases, migration, backups |
| Redis and proxy trust | Redis store, startup and route configuration | Databases, reverse proxy |
| Download pacing, chunks, cookies, runtime selection | Downloader, entrypoint | Downloads, updates |
| Subscription state and automatic playlists | Subscriptions, files, settings model | Subscriptions |
| Tasks, confirmations, schedules and timezones | Task engine, task interface | Tasks |
| Autoplay queue, theater, blackout, chapters, snips | Player, files module | Player |
| GPU encode/decode checks and fallback | Transcoding, entrypoint | Hardware acceleration |
| Category rules and archive records | Categories, archive | Categories, Archive |
| Webhook templates | Notifications | Notifications |
| Separate browser manifests and packages | Extension source | Browser integration |
Limits kept visible¶
- Public RSS and notification links can append the backend port behind a reverse proxy. The proxy guide records this behavior rather than claiming full external-origin support.
- The default and extended Compose examples use different PostgreSQL volume targets. The database guide ties the mount to the chosen image major version.
- The generated setting table guarantees parity with registered source defaults, not live provider compatibility or the semantics of every combination of options.
- Historical hosted shortcuts, extension listings, and host-specific recipes are not treated as verified just because the wiki linked to them.
- Docker is the documented deployment baseline. The repository's Helm chart is not presented as a validated current deployment guide in this audit.
Validation of this site covers its static build, internal links, assets, navigation, and browser rendering. Database migrations, external login providers, notification services, and GPU passthrough still need testing against the operator's actual environment.