VynodeArr

Movies and television, managed together.

VynodeArr is a self-hosted media-management application with one account system, one interface, and dedicated movie and television services operating behind its secure gateway. It brings library management, discovery, monitoring, acquisition, activity, and administration into a consistent VynodeArr experience.

Why VynodeArr

Feature tour

Rich movie and television libraries

• Poster, list, and compact layouts remembered independently for movies and television
• Artwork-backed detail pages with monitoring, search, refresh, edit, and location controls
• Movie filters for title, year, genre, and collection
• Show, season, and episode monitoring with color-coded availability
• Bulk profile, root-folder, availability, refresh, and removal actions

Search, acquire, and follow progress

• Automatic and interactive search for movies, shows, seasons, and individual episodes
• Release results with quality, size, source, status, and rejection reasons
• Wanted views grouped by show and season
• Sortable, filterable queue with download-client status and bulk actions
• Unified calendar, history, health, and scheduled-task views

Flexible collections

Build hand-picked collections or combine smart rules such as title, year, decade, genre, monitoring state, file availability, and an existing movie collection. Preview matches, keep earlier selections while trying new rules, and remove individual movies before saving.

Administration without configuration files

• First-run administrator creation and secure local accounts
• User roles, active sessions, encrypted credentials, and engine-key controls
• Visual root-folder browser, quality profiles, indexers, and download clients
• Movie and television settings kept separate where their behavior differs
• Backup creation, download, upload, and restore from the VynodeArr interface
• Actionable health issues with direct links to the setting that needs attention

Install

Unraid

The container image is:

ghcr.io/minerport/vynodearr-unified:latest

1. Install VynodeArr from Community Apps, or import templates/vynodearr.xml.
2. Keep /config mapped to a persistent appdata folder.
3. Map writable movie, television, and download folders.
4. Open the WebUI on port 8686.
5. Create the first administrator.
6. Confirm root folders, then add indexers and download clients under Service Settings.

Keep /config when updating or recreating the container. It contains the application state and both service databases.

For normal Unraid HTTP access, leave VYNODEARR_SECURE_COOKIES=false. Enable secure cookies only when VynodeArr is always accessed over HTTPS.

Windows

Docker Desktop with Linux containers is required.

1. Download VynodeArr-Windows-x64-<version>.zip from the latest release.
2. Extract it to a permanent folder.
3. Run Start-VynodeArr.ps1.
4. Open http://localhost:8686.
5. Create the first administrator and complete the same guided setup.

Run Stop-VynodeArr.ps1 to stop VynodeArr without removing its data.

First-run checklist

1. Open Service Settings → Root Folders and confirm the movie and television locations.
2. Review the quality profiles for each library.
3. Add at least one indexer and download client.
4. Ensure the same completed-download folder is visible to VynodeArr and the download client.
5. Add or import media and choose monitoring behavior.
6. Open Health from the dashboard to resolve any remaining setup issues.

Connect Seerr or another request application

Use the VynodeArr server address and port 8686 for both services:

Administrators can reveal or generate the individual API keys under Account Settings → Engines. Regenerating a key requires updating every external application that uses it.

Updates, backups, and removal

• On Unraid, update the container to pull the newest image.
• Never remove the persistent /config mapping during an update.
• Create and download both backups from System → Backups before uninstalling.
• A new installation can upload and restore downloaded backup files.
• Library media remains in /movies and /tv; it is not stored inside the application container.

Troubleshooting

Development

Copy-Item .env.example .env
docker compose up --build -d

The development interface opens at http://localhost:4310.

Run the full verification suite:

npm run verify

More documentation:

• Architecture
• Authentication and accounts
• Management gateway
• Interaction parity
• Packaging and licensing

License and acknowledgements

VynodeArr source code is licensed under the Apache License 2.0. Bundled third-party components retain their respective licenses and notices; see THIRD_PARTY_NOTICES.