🎬 ReelArrange

ReelArrange is a Windows desktop helper that identifies downloaded movies and TV shows with TMDB, previews a Jellyfin-ready library layout, and copies or moves the media into place.

It is designed for the awkward gap between “the download finished” and “the media server understands it.” The interface handles matching, folder names, seasons, episode titles, sidecars, artwork, featurettes, trailers, collision behavior, and live transfer progress without requiring command-line use.

Important

ReelArrange is an early project. Always inspect the preview before moving media. Copy is the recommended transfer mode when a torrent should continue seeding.

Features

• Searches TMDB and requires confirmation of the selected title.
• Uses Jellyfin metadata identifiers such as [tmdbid-687163].
• Accepts a movie file, movie folder, selected episodes, season folder, or complete show folder.
• Produces Jellyfin-style movie, series, season, and episode names.
• Retrieves episode titles from TMDB when available.
• Preserves matching subtitles, NFO files, and artwork sidecars.
• Carries recognized extras including featurettes, trailers, deleted scenes, interviews, clips, shorts, samples, theme music, and backdrops.
• Keeps show-level and season-level extras in the correct place.
• Handles movie versions and common split-part names such as cd1 and cd2.
• Supports copy and move operations, including mapped drives and UNC paths.
• Provides add-missing, stop-on-conflict, and confirmed-overwrite policies.
• Displays live per-file byte progress and overall file progress.
• Encrypts the TMDB credential for the current Windows account.
• Does not overwrite anything unless the user explicitly selects and confirms overwrite.

Example layouts

Movie:

Movies/
└── Movie Title (2026) [tmdbid-123456]/
    ├── Movie Title (2026) [tmdbid-123456].mkv
    ├── poster.jpg
    └── featurettes/
        └── Making Of.mkv

TV show:

Shows/
└── Series Title (2026) [tmdbid-654321]/
    ├── trailers/
    │   └── Official Trailer.mkv
    └── Season 01/
        ├── Series Title (2026) S01E01 Episode Title.mkv
        └── behind the scenes/
            └── Episode Making Of.mkv

The naming behavior follows Jellyfin's current movie, TV show, and metadata identifier documentation.

Requirements

• Windows 10 or Windows 11
• Windows PowerShell 5.1 or newer PowerShell for development
• A free TMDB account and either an API Read Access Token or v3 API key
• Internet access for TMDB searches
• An existing Movies or Shows library folder, locally or over the network

ReelArrange does not need to run on the Jellyfin server itself. A mapped drive or UNC share such as \\server\media\Movies is supported.

Installation

The packaged ZIP includes a ready-to-run, icon-bearing ReelArrange.exe beside the PowerShell application and assets. It can be launched directly from the extracted folder.

Clone or download the repository, open Windows PowerShell in the project folder, and run:

Set-ExecutionPolicy -Scope Process Bypass
.\scripts\install.ps1

The installer:

1. Parses and tests the PowerShell application.
2. Builds an icon-bearing windowless executable from the included C# source.
3. Installs the executable, PowerShell application, logo, and notices under %LOCALAPPDATA%\Programs\ReelArrange.
4. Creates a ReelArrange shortcut on the current user's Desktop.
5. Creates ReelArrange and About ReelArrange shortcuts in the current user's Start menu.
6. Migrates settings from the original private “Jellyfin Media Prep” build when found.

The installed Desktop and Start menu shortcuts do not depend on the repository remaining in the same location. Their icon comes from the installed ReelArrange executable.

To upgrade after pulling a newer version, run scripts\install.ps1 again.

First run

1. Open ReelArrange from the Desktop or Start menu.
2. Choose Movie or TV show.
3. Select a file or complete release folder.
4. Paste a TMDB API Read Access Token when prompted. The dialog links directly to TMDB's API settings page.
5. Confirm the TMDB match.
6. Choose the Jellyfin library root and transfer behavior.
7. Inspect the complete destination preview.
8. Start the transfer and follow the live status window.

Selecting a complete release folder is recommended when the download contains extras or artwork. If a movie file is selected directly, ReelArrange detects recognized sibling extras folders and asks whether to include them.

If a folder contains same-named videos in multiple formats, such as matching MKV and MP4 copies of every episode, ReelArrange pauses before TMDB lookup and asks which format to keep. It recommends the format with the best episode coverage and larger source files, while making clear that file size is only a practical signal and not a full quality inspection. Unselected video copies remain untouched in the source folder.

Very long movie or multi-episode titles are shortened deterministically before transfer. ReelArrange preserves the identifying show and episode prefix, then adds a stable suffix to avoid collisions while keeping the complete destination path within reliable Windows limits.

Existing-file behavior

ReelArrange offers three policies:

• Add missing files; keep existing media — recommended for adding extras to a movie that was already transferred.
• Stop if any destination file exists — changes nothing when a collision is found.
• Overwrite existing files — transfers missing files first, then displays a final warning before replacing existing destinations.

When ReelArrange stops safely, the dialog explains the reason, confirms that no files changed, suggests the appropriate next step, and shows only a manageable sample of conflicting paths.

If a transfer stops after some files complete, run the same source again with Add missing files. Completed destinations remain untouched and only absent files are transferred.

Copy versus move

• Copy leaves the download intact and is the recommended choice while seeding.
• Move removes successfully transferred source files. Cross-drive moves can take several minutes for large files.

The transfer window reports the current file, byte percentage, transferred size, and overall file count.

About ReelArrange

Choose About from ReelArrange's opening window or About ReelArrange from the Start menu. The short About window shows the current version, what ReelArrange does, the author, license and service notices, and a link to the project repository.

Settings, logs, and privacy

User data is stored under %LOCALAPPDATA%\ReelArrange:

• settings.json contains the TMDB credential encrypted with Windows Data Protection for the current user, plus the last selected library roots.
• activity.log records file operations and errors. It never records the TMDB credential.

ReelArrange has no telemetry. See Privacy for the network and local-data model.

Uninstall

From the repository:

.\scripts\uninstall.ps1

The uninstaller removes the installed application plus its Desktop and Start menu shortcuts, but keeps settings and logs by default. To remove those too:

.\scripts\uninstall.ps1 -RemoveUserData

Development

Run the complete local checks with:

.\scripts\test.ps1

See Development, Architecture, and Contributing before submitting a change.

Reporting problems and requesting features

• Use the bug report template for reproducible defects.
• Use the feature request template for proposed behavior.
• Read Support before including logs or paths.
• Report vulnerabilities privately as described in Security.

Project status

The current version is 0.2.0. See CHANGELOG.md for changes and planned compatibility notes.

License and service notices

ReelArrange is released under the MIT License.

ReelArrange is not affiliated with or endorsed by Jellyfin or TMDB. “Jellyfin” and “TMDB” are used only to describe interoperability. This product uses the TMDB API but is not endorsed or certified by TMDB. See NOTICE.md.