WebUI Basics

WebUI Basics

This page covers the screen layout, the workflow common to all modes, the menus, the keyboard shortcuts and the shared dialogs. The three mode pages assume this material.

The screen

RemuxForge is a single-page Blazor application. Web, Docker and Desktop render the same interface; there are no page reloads and the advanced editors open as modal workspaces.

┌──────────────┬───────────────────────────────────────────────────┐
│ RemuxForge   │ Mode title                    File … Help          │
│              ├───────────────────────────────────────────────────┤
│ Remux        │ Scan  Analyze  Process …                  Stop    │
│ Split        ├────────────────────────────┬──────────────────────┤
│ Metadata     │ work list                  │ inspector            │
│              │ episodes/files            │ detail and preview   │
│              │                            │                      │
│              ├────────────────────────────┴──────────────────────┤
│              │ Log                                               │
│ Info         ├───────────────────────────────────────────────────┤
│              │ Global / current progress                         │
│              ├───────────────────────────────────────────────────┤
│              │ F2 Config  F5 Scan … F12 Stop                    │
└──────────────┴───────────────────────────────────────────────────┘

Area	What it does
Navigation rail	Switches between Remux, Split and Metadata and opens Info. Its toggle collapses it to icons only. The last mode is restored on the next launch.
Header menu	File, Actions, Settings, Theme, Language and Help. Contents change per mode; keyboard mnemonics remain available.
Command toolbar	Exposes the main commands for the active mode without opening a menu. At narrow desktop widths it scrolls horizontally instead of hiding actions.
Master/detail splitter	Left: the work list. Right: detail, plan or preview for the selected row. Drag the separator to change their relative width.
Log	Selectable and copyable operation log, automatically scrolled to the bottom. Read this when something looks wrong.
Progress	Two bars, Global across the batch and Episode within the current file. Shows Ready / No operation running when idle.
Shortcut bar	The same actions as the menu and toolbar, with their shortcut keys. Its labels are clickable buttons.

The three modes

Mode	Use it when
Remux	You have two releases of the same content and want to combine them, import an audio dub or subtitles from one into the other. Works on folders, matching files into episode pairs, or on a single file per side.
Split	You have one big MKV and want several smaller ones, a disc rip cut into episodes, or an intro trimmed off. Works on a file, or a folder for a batch.
Metadata	You want to change titles, languages, flags or tags across many files, or rename files. Works on a folder of .mkv files.

Switching mode does not discard the other modes' state: each keeps its own configuration, file list and log until you clear it.

Common workflow

Configure (F2)  →  Scan (F5)  →  Analyze  →  Process

1. Configure: tell it what to work on and how. In Remux and Split this is the configuration dialog (F2); in Metadata it is the toolbar above the file list, and F2 opens the input picker.
2. Scan (F5): find the files and, in Remux mode, pair them up. Nothing is read deeply and nothing is written. Fast.
3. Analyze: inspect each file and work out exactly what would be done: calculated sync delays, simulated metadata changes, planned segments. Still nothing is written. This is the slow step when Frame-sync or Deep analysis is on.
4. Process: write the result. F9 for the selected row, F10 for everything.

Two things follow:

• Analyze before processing. The right-hand panel then reports exactly what will happen to each file before anything is written.
• Changing the configuration invalidates completed work. Re-applying configuration after a scan invalidates that scan (the log reports this and asks for F5 again) and discards analyses that are no longer valid. This prevents processing with settings other than the ones that were analysed.

Split mode has no separate analyze step. F5 only lists the input files; the segment plan is computed by F10. Enable Dry-run to make F10 print the plan without writing.

Header menu and command toolbar

The menu changes per mode. Menus can be opened with the mouse, or with Alt + the underlined letter, then navigated with arrow keys and Escape. The command toolbar directly exposes the operations used most often; it does not replace the menu or its keyboard behavior.

Remux mode

Menu	Items
File	Configuration (F2)
Actions	Scan files (F5) · Analyze selected (F6) · Analyze all (F7) · Skip/Unskip (F8) · Process selected (F9) · Process all (F10) · Stop (F12)
Settings	Tool paths · Audio · Advanced settings · Encoding profiles
Theme	Default · Dark · Humanistic · Humanistic Dark · Material · Material Dark · Software · Software Dark · Standard · Standard Dark
Language	English · Italiano
Help	Info

Split mode

Menu	Items
File	Split configuration (F2)
Actions	Scan input (F5) · Split all (F10) · Stop (F12)
Settings	Tool paths
Theme / Language / Help	as above

Metadata mode

Menu	Items
File	Input path… (F2) · Clear (Ctrl+L) · Load preset… (F3)
Actions	Manual edit… (F4) · Scan input (F5) · Analyze (F6) · Apply selected (F9) · Apply all (F10) · Advanced rename (F11) · Stop (F12)
Settings	Tool paths
Theme / Language / Help	as above

One exception:

• Audio, Advanced settings and Encoding profiles only appear in the Settings menu in Remux mode. They are global settings that affect the whole application, but they are not reachable from Split or Metadata mode; switch to Remux to change them.

Keyboard shortcuts

Every shortcut is per-mode. Escape always closes the topmost dialog.

Remux mode

Key	Action
F2	Open configuration
F5	Scan folders and match episodes
F6	Analyze the selected episode(s)
F7	Analyze all pending episodes
F8	Skip / unskip the selected episode
F9	Process the selected episode(s)
F10	Process all analysed episodes
F12	Stop the running operation
Enter	Open the context menu for the selected episode
Escape	Close dialogs
↑ ↓	Move the selection
Shift+↑ ↓	Extend the selection
Ctrl+↑ ↓	Move the focus without changing the selection
Home / End	First / last row
PageUp / PageDown	Move ten rows
Space	Toggle the focused row in and out of the selection
Ctrl+A	Select every row

Split mode

Key	Action
F2	Open split configuration
F5	Scan input
F10	Split every prepared file
F12	Stop the running operation
Escape	Close dialogs
↑ ↓	Move the selection
Home / End	First / last row

Metadata mode

Key	Action
F2	Open the input picker
F3	Open the preset editor
F4	Manual edit of the selected file
F5	Scan .mkv input
F6	Analyze the batch against the preset
F9	Apply to the selected file
F10	Apply to every analysed file
F11	Open Bulk Rename
F12	Stop the running operation
Ctrl+L	Clear metadata state
Escape	Close dialogs
↑ ↓	Move the selection
Home / End	First / last row

There is no exit shortcut. Closing the browser tab does not stop the server; the process must be stopped separately.

Multi-selection (Remux mode)

Remux mode is the only mode with multi-selection. It determines what F6 and F9 operate on.

• Click a row to select it.
• Ctrl+click to add or remove a row.
• Shift+click to select a range.
• Ctrl+A for everything, Space to toggle the focused row.

F6 (Analyze selected) and F9 (Process selected) operate on the whole selection, allowing individual episodes to be reprocessed without re-running the batch.

Choosing files and folders

Wherever a path is expected there is a [ .. ] button that opens the browser dialog.

• Path bar at the top, type or paste a path directly. It autocompletes as you type and offers a dropdown when several folders match.
• On Windows, the root level lists the available drives under This PC.
• Four columns: Filename, Size, Modified, Type. Click the Filename header to flip the sort order.
• Directories are prefixed with / and typed <Directory>.
• .. navigates to the parent. Double-click enters a folder or picks a file; single click just selects.
• The confirm button changes with context, Select folder, Select file, or Select file/folder, because some fields accept only one of the two. A field that wants a folder will refuse a file, and the dialog says so.

Use the browser rather than typing paths, particularly under Docker, where host paths do not exist inside the container.

Reading the log

The log is append-only and auto-scrolls. Some information appears only here: the exact mkvmerge command line, per-file warnings, and the reason an episode did not match.

Messages indicating a missing step:

Message	What to do
Ready. Press F2 to configure, F5 to scan.	fresh state, nothing configured yet
Configure the source folder first (F2)	scan attempted with no source set
Configuration applied: previous scan invalidated, press F5	you changed settings after scanning, scan again
Configuration applied: N previous analyses discarded	your change invalidated analyses; re-analyze
Operation in progress: try again after processing finishes	one operation at a time
Select an episode to analyze / to process	nothing is selected
No running operation to stop	F12 with nothing running

Set REMUXFORGE_LOG_FILE to write the log to disk. See Installation.

Dry-run

Split mode has a Dry-run toggle in its configuration: it prints the segments and the pipeline it would produce and writes nothing. Use it to verify a chapter pattern or a naming template before running the job.

In Remux and Metadata mode the Analyze step serves the same purpose: it simulates the full operation and writes nothing.

Stopping an operation

F12 requests a stop. The log answers Stop requested: the operation will stop at the next safe point.

The current file is completed, or abandoned at a point where nothing is left partially written, and then the batch ends. The running ffmpeg or mkvmerge call has to return first, which on a long re-encode can take considerable time. Files already completed are kept, and the summary reports how many finished and how many failed.

Themes and language

Theme offers all ten free Radzen themes: Default, Dark, Humanistic, Humanistic Dark, Material, Material Dark, Software, Software Dark, Standard and Standard Dark. Language offers English and Italian, and it changes the CLI's output language too, since both read the same resources. Both settings are saved to appsettings.json and restored on the next launch.

Help ▸ Info

Shows name, version, license, repository, .NET runtime and platform. Include the version when reporting a problem.

In-app field help

The Remux and Split configuration dialogs contain a help pane on the right side. Hovering or focusing a field displays that field's title and full explanation: accepted formats, defaults, common values and examples. The language-code and codec-alias lists are included there.

This is the same reference text used as the source for this wiki, available without leaving the application.

Next

• Remux Mode · Split Mode · Metadata Mode
• Settings Reference: everything under the Settings menu