Frequently Asked Questions

General

What is Nymara?

Nymara is a professional-grade media library organizer for Windows. It scans messy download folders, matches files to TMDB, previews every change, and organizes them into a Jellyfin-compatible library structure. It's built for homelab owners who value safety, preview-before-execute workflows, and deep integration with the ARR ecosystem.

Is Nymara free?

Yes, the core product is completely free. Movies, TV, music, audiobooks, ebooks, TMDB metadata, Jellyfin sync, duplicate detection, health audits, and basic AI chat are all free. Pro tier ($25/year) unlocks adult & anime metadata, advanced AI agents, automation, and cloud sync. Lifetime ($75) is a one-time purchase for all Pro features released within 24 months.

Does Nymara run on Linux or macOS?

Not currently. Nymara is built on WPF and .NET 10, which are Windows-only. A cross-platform rewrite is not planned for the immediate future, but the core services are architected in a way that would allow porting if demand is high enough.

Does Nymara collect my data?

No. Nymara is a local-first application. Your library data, file paths, and metadata never leave your machine unless you explicitly enable cloud sync (Pro feature, opt-in). Error reports via Sentry are opt-out and contain no file names or paths.

Can I use Nymara without TMDB?

Yes, but TMDB is strongly recommended. Without it, Nymara can still organize files by parsing filenames, but it won't fetch artwork, canonical titles, NFO metadata, or collection groupings. Basic organization (move/rename by filename) works without any API keys.

Safety

Can Nymara delete my files?

Deletion is never enabled by default. By default, Nymara uses Trash mode: "deleted" files are moved to a .trash/ folder inside your media root. You can recover them anytime from the Recovery tab. Permanent deletion requires explicitly enabling it in Settings → Safety.

What is Dry Run mode?

Dry Run simulates every operation without touching files. It validates paths, checks for conflicts, estimates disk space, and shows you exactly what would happen. Use it on your first scan, on large batches, or whenever you're unsure. It's the default mode until you explicitly disable it.

What if I make a mistake?

Every operation is journaled. Use the Recovery tab to see a visual Undo Tree of all past operations. You can undo individual actions, entire sessions, or even branch to alternate recovery paths. Journals are stored in .journals/ inside your media root.

How do Protected Folders work?

In Settings → Safety, you can mark folders as Protected. Nymara will never move, rename, or delete any file inside a protected folder. This is useful for curated collections, manually organized series, or anything you don't want touched by automation.

Licensing

How does the trial work?

New installs get a 14-day Pro trial automatically. If you previously used the Python version with adult features enabled, you get a 90-day trial as a thank-you. The trial gives you full access to all Pro features. When it expires, you revert to Free tier features. No data is lost.

What happens when Pro expires?

Free features continue working exactly as before. Adult and anime tabs show a locked overlay. Your already-organized adult/anime files remain untouched. You just can't run new organization with metadata on those categories. You can hide locked tabs entirely in Settings.

Is the license per-device?

Per-user. You can activate your license on multiple personal devices. Commercial or shared-server use requires contacting us for a separate license. The license validation works offline, so you don't need an internet connection to use Pro features.

Advanced

How does hardlink mode work?

Hardlinks create additional directory entries pointing to the same underlying file data. They use zero extra disk space (as long as the original exists) and both paths remain fully functional. This means qBittorrent can keep seeding from its original download path while Jellyfin serves the organized path. Hardlinks only work on the same filesystem (drive letter).

What media formats are supported?

Nymara recognizes all common video formats: MKV, MP4, AVI, MOV, WMV, TS, M2TS, MPG, MPEG, and more. ffprobe (optional) enables deep probing of codec, resolution, HDR status, bitrate, and audio channels. For best results, use ffprobe from ffmpeg.

Can I run Nymara from the command line?

Yes. Pass the --cli flag with a source path: NYMARA.exe --cli "C:\Source\Media". CLI mode runs a headless scan and executes the plan using your saved settings. Useful for automation and scheduled tasks.

How do I migrate from the Python version?

The C# version auto-detects Python-version settings on first run and migrates them to settings.v2.json. Your library root, API keys, and preferences are preserved. The Python codebase remains untouched if you had it installed previously.