Episort
Episort is a Windows-first desktop application built with Java and JavaFX. It analyzes show and movie folders, separates safe cases from ambiguous ones, and prepares a reviewable plan before any operation runs.
- Status
- In development
- Type
- Personal project
- Role
- Product design, architecture, Java/JavaFX development, and the safety strategy for file operations.
The initial problem
Organizing a large media library becomes hard once files are badly named, mixed together, or matched to the wrong episode order.
Context
Naming conventions vary, several shows can be mixed in one folder, and broadcast orders do not always line up. Blind automation can therefore damage an entire library.
Objectives
- Identify media without hiding uncertainty
- Prepare a verifiable plan
- Keep every destructive operation explicitly confirmed
The solution
A deterministic analysis chain classifies the files, enriches them through TVDB, then exposes a manual review. Moving files requires two confirmations and stays journaled so a run can be resumed.
Features
- Scans AVI, MP4 and MKV
- Detects shows, movies, unknown files and ambiguities
- Aired, DVD and absolute orders
- Manual review
- Source-to-destination plan
- Two-step confirmation
- Journaling and recovery
Architecture
A desktop application separating scan, analysis, enrichment, plan building, and execution. The interface never moves a file directly.
Technologies
Java · JavaFX · TVDB API
Key decisions
- Prefer an explainable result over opaque detection
- Keep the plan separate from its execution
- Treat ambiguity as a normal state
Challenges
- Interpreting inconsistent file names
- Handling several mixed release groups
- Reconciling different episode orders
Learnings
- Safe usage comes from how the flow is structured
- Reliable automation has to declare its uncertainty
Current state
The project is currently: in development. This reflects the state set in the administration area.
Next steps
- Harden recovery
- Broaden naming tests
- Add real media
Media