Placeholders
Placeholders capture parts of the current filename and can be reused in the output schema.
%name
%{name}
Use braces when a placeholder touches literal letters, numbers, or underscores.
Input: %{title}__(S%{season}_E%{episode})%{id}
Output: S%{season}E%{episode}.@ext
Result: S16E05.mp4
Literal text
Text outside placeholders must appear exactly in the matched filename.
Filename: 2026-05-01 - Das ist ein - Test.mp4
Input: %{year}-%{month}-%{day} - %{title} - %{suffix}
Output: %{day}%{month}%{year} - %{title}.@ext
Result: 01052026 - Das ist ein.mp4
Use %% for a literal percent sign.
System variables
System variables are available in output schemas.
@ext original extension without dot
@basename original filename without extension
@filename original full filename
They can also be written with braces, such as @{ext}.
Extension modes
Preserve extension mode matches only the basename. Include @ext in the output to keep the extension.
Input: %{title}
Output: %{title} - cleaned.@ext
Full filename mode matches the complete filename, including the extension.
Input: %{title}.%{year}.mp4
Output: %{year} - %{title}.@ext
Folders and replacements
A slash in the output schema creates a relative folder path. Replacement rules run after the output schema, one path segment at a time.
Output: %{year}/%{title}.@ext
Rule: : -> -
Before: 2026/Song: Part.mp4
After: 2026/Song- Part.mp4
Limits
Adjacent placeholders such as %{a}%{b} are blocked because the split point is ambiguous. Repeated placeholders are allowed only when every capture has the same value.