Documentation
Documentation
Disc Scanning & Metadata Extraction
Drive Identification
Launches MakeMKV in “robot” mode to probe the inserted disc.
Parses DRV: lines to map the MakeMKV disc ID to the actual Windows drive letter.
Title Info Collection
Reads every TINFO:…9,0 line to capture title durations.
Reads every TINFO:…10,0 line to capture size estimates.
Reads TINFO:…2,0 lines for disc comments (angles, bonus markers).
Reads TINFO:…26,0 lines for segment maps (play order codes).
Disc Type Detection
Determines “Blu-ray vs. DVD” based on total size thresholds and CINFO flags.
Title Filtering & Grouping
Valid Episode Candidates
Filters out very short (< 10 min) and very long (> 70 min) titles.
Builds a set of plausible episode titles.
Size-Based Clustering
Groups valid titles by file-size similarity (±15%).
Scores each group on:
Count Match (did it find exactly the expected number of episodes?)
Sequential IDs (are the track numbers consecutive?)
Size Consistency (low variance within the group)
Duration Consistency (similar runtime)
Segment Simplicity (simple segment maps get higher marks)
Automatic Selection
Chooses the highest-scoring group; falls back to largest titles if no good group found.
For movies, it auto selects the largest valid title.
Title Correction
Title Selection
Presents a checklist of all found titles (with duration, size, segment & comment shown).
Pre-selects the automatically identified set.
User can add/remove to correct any incorrect selections.
Extras (Bonus Content)
After episodes are locked in, the remaining titles appear in a second dialog.
User may optionally select any extras.
Ripping with Progress Monitoring
Per-Title Monitor
For each title, kicks off MakeMKV’s mkv command to rip to a temp folder.
Launches a background task to watch the newest .mkv file’s size and timestamp.
Every half-second, computes:
Current rip percent (current size ÷ expected size)
Throughput (MB/s) over recent history
ETA
Reports those values into the GUI’s progress bar and label.
Step-Based Progress
Separately reports overall “steps” (scan, rip each title, rename, eject) so you see macro progress.
File & Folder Organization
Episode Sorting
By default: uses the simple segment map (numeric play order) to assign files to episode numbers.
Falls back to title-number order if segment maps are complex or missing.
Renaming Convention
TV: ShowName S00xxE00.mkv
Movie: MovieTitle (Year).mkv
Extras: ShowName S00D00 - Extra 00.mkv or MovieTitle (Year) - Extra 00.mkv
Transcoding Integration
HandBrake Presets
If transcode=true, each rip (main & extras) is queued to a separate transcoder (AutoRipperTranscoder.exe).
Regardless of handbrake preset selected, all audio and subtitle languages/tracks are passed through and framerate is set to Same as Source/Variable
Queue Management
You can choose to queue files and transcode 1 at a time, or allow multiple files to transcode at once.
FileBot Support
Organize-Only Mode
If Skip Filebot Renaming setting is checked, runs FileBot on just the main episodes (excludes Extras).
Renames with format “ShowName S00xxE00 - Episode Title.mkv”
Manual Extras Handling
After FileBot finishes, the “Extras” folder is manually moved into the library (preserving its naming scheme).
Direct-Move Mode
If Skip Filebot Renaming setting is unchecked or no FileBot path is set, simply moves files in place without external tools.
Disc Ejection
Tries multiple methods (PowerShell COM, WMI, CMD) to eject the drive letter.
Retries gracefully if mapping isn’t found.