1
0
mirror of https://github.com/mitb-archive/filebot synced 2024-11-17 23:05:03 -05:00
filebot/website/naming.html

458 lines
21 KiB
HTML
Raw Normal View History

2011-11-27 00:32:06 -05:00
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" itemscope itemtype="http://schema.org/Product">
<head>
2011-11-27 00:32:06 -05:00
<meta http-equiv="content-type" content="text/html; charset=UTF-8" />
2016-11-05 10:04:50 -04:00
<meta name="keywords" content="@{package.tags}" />
2011-12-25 12:17:49 -05:00
<title>Format Expressions</title>
<meta name="description" content="Define your own naming scheme and customize it to your liking. FileBot format expressions give you ultimate control over how FileBot will rename and move your media files. Anything is possible." />
2011-12-25 12:17:49 -05:00
<meta itemprop="name" content="FileBot Format Expressions" />
<meta itemprop="description" content="Define your own naming scheme and customize it to your liking. FileBot format expressions give you ultimate control over how FileBot will rename and move your media files. Anything is possible." />
2016-11-05 10:04:50 -04:00
<meta itemprop="image" content="@{link.image.logo}" />
<link rel="stylesheet" href="base.css" type="text/css" />
<link rel="stylesheet" href="code.css" type="text/css" />
<link rel="icon" href="favicon.png" />
</head>
<body>
<div class="page">
2011-12-10 04:59:27 -05:00
<div class="navigation">
2011-11-22 11:12:20 -05:00
<div>
<ul>
2016-11-26 00:17:57 -05:00
<li><a href="https://www.filebot.net/forums/">Forums</a></li>
<li><a href="https://www.filebot.net/forums/viewtopic.php?f=3&amp;t=7">FAQ</a></li>
2017-06-03 05:10:43 -04:00
<li><a href="https://www.filebot.net/#download">Download</a></li>
2011-11-22 11:12:20 -05:00
</ul>
</div>
</div>
<div class="header">
2017-06-03 05:10:43 -04:00
<a href="https://www.filebot.net/"><img class="logo" alt="logo" src="images/filebot.logo.svg" width="64" height="64" /></a>
<h1>
Format Expressions
<span class="description">User defined episode / movie naming scheme</span>
</h1>
</div>
<div class="content">
<div class="screenshot">
2015-06-13 14:08:18 -04:00
<a href="screenshots/format.png" title="Format Dialog" target="_blank">
2015-06-14 09:00:32 -04:00
<img alt="Edit Format Dialog" width="230" height="157" src="screenshots/format.png" />
</a>
2011-11-21 07:35:28 -05:00
</div>
<div class="section about">
<h2>About</h2>
<p>
2015-06-02 07:46:03 -04:00
You can easily define your own episode and movie naming schemes. It uses <a href="http://groovy-lang.org/">Groovy</a> expressions,
which means that you can do pretty much anything, especially if you know a little bit about programming.
2016-11-26 00:17:57 -05:00
You even get media info bindings. You can find <a href="https://www.filebot.net/forums/viewtopic.php?f=5&amp;t=2#p51">predefined format expressions</a> for all kinds of scenarios in the forums. Ready for you to just copy &amp; paste.
</p>
2011-09-22 12:11:00 -04:00
<h2 id="examples">Examples</h2>
<p>
<code><span class="block start">{</span><span class="variable">n</span><span class="block end">}</span> - <span class="block start">{</span><span class="variable">s00e00</span><span class="block end">}</span> - <span class="block start">{</span><span class="variable">t</span><span class="block end">}</span></code>Dark Angel - S03E01 - Labyrinth
</p>
<p>
<code>V:/TV Shows/<span class="block start">{</span><span class="variable">n</span><span class="block end">}</span>/Season <span class="block start">{</span><span class="variable">s</span><span class="block end">}</span>/<span class="block start">{</span><span class="variable">sxe</span><span class="block end">}</span> - <span class="block start">{</span><span class="variable">t</span><span class="block end">}</span></code>V:\TV Shows\Dark Angel\Season 3\3x01 - Labyrinth
</p>
<p>
<code><span class="block start">{</span><span class="variable">n</span>.<span class="method">space</span>(<span class="string">'.'</span>).<span class="method">lower</span>()<span class="block end">}</span>.<span class="block start">{</span><span class="variable">s</span><span class="block end">}</span><span class="block start">{</span><span class="variable">e</span>.<span class="method">pad</span>(<span class="numeral">2</span>)<span class="block end">}</span></code>dark.angel.301
</p>
<p>
<code><span class="block start">{</span><span class="variable">n</span><span class="block end">}</span> (<span class="block start">{</span><span class="variable">y</span><span class="block end">}</span>)<span class="block start">{</span><span class="string">" CD<span class="variable">$pi</span>"</span><span class="block end">}</span></code>The Man from Earth (2007) CD1
</p>
<p>
<code><span class="block start">{</span><span class="variable">n</span><span class="block end">}</span> [<span class="block start">{</span><span class="variable">y</span><span class="block end">}</span>] <span class="block start">{</span><span class="variable">vf</span><span class="block end">}</span> <span class="block start">{</span><span class="variable">af</span><span class="block end">}</span></code>The Man from Earth [2007] 720p 6ch
</p>
<h2>Advanced Examples</h2>
<p>
2014-03-24 01:49:24 -04:00
<code><span class="block start">{</span><span class="variable">n</span>.<span class="method">upperInitial</span>().<span class="method">space</span>(<span class="string">'.'</span>)<span class="block end">}</span>.<span class="block start">{</span><span class="variable">y</span><span class="block end">}</span>.<span class="block start">{</span><span class="variable">source</span><span class="block end">}</span>.<span class="block start">{</span><span class="variable">vc</span><span class="block end">}</span><span class="block start">{</span><span class="string">'-'</span>+<span class="variable">group</span><span class="block end">}</span></code>The.Man.From.Earth.2007.DVDRip.XviD-ALLiANCE
</p>
<p>
2012-02-20 04:38:58 -05:00
<code><span class="block start">{</span><span class="variable">n</span><span class="block end">}</span> (<span class="block start">{</span><span class="variable">y</span><span class="block end">}</span>) by <span class="block start">{</span><span class="variable">director</span><span class="block end">}</span> [<span class="block start">{</span><span class="variable">genres</span>[<span class="numeral">0</span>]<span class="block end">}</span>, <span class="block start">{</span><span class="variable">certification</span><span class="block end">}</span>, <span class="block start">{</span><span class="variable">rating</span><span class="block end">}</span>]</code>The Terminator (1984) by James Cameron [Action, PG-13, 8.5]
</p>
<p>
<code><span class="block start">{</span><span class="variable">n</span>.<span class="method">space</span>(<span class="string">'_'</span>)<span class="block end">}</span>_-_<span class="block start">{</span><span class="variable">e</span>.<span class="method">pad</span>(<span class="numeral">2</span>)<span class="block end">}</span>_[<span class="block start">{</span><span class="variable">resolution</span><span class="block end">}</span>_<span class="block start">{</span><span class="variable">vc</span><span class="block end">}</span>_<span class="block start">{</span><span class="variable">ac</span><span class="block end">}</span>][<span class="block start">{</span><span class="variable">crc32</span><span class="block end">}</span>]</code>Juuni_Kokuki_-_01_[1280x720_XviD_MP3][3E16AF40]
</p>
<p>
<code><span class="block start">{</span><span class="variable">n</span>.<span class="method">space</span>(<span class="string">'.'</span>)<span class="block end">}</span>.<span class="block start">{</span><span class="string">'s'</span>+<span class="variable">s</span>.<span class="method">pad</span>(<span class="numeral">2</span>)<span class="block end">}</span>e<span class="block start">{</span><span class="variable">e</span>.<span class="method">pad</span>(<span class="numeral">2</span>)<span class="block end">}</span>.<span class="block start">{</span><span class="variable">t</span>.<span class="method">space</span>(<span class="string">'.'</span>)<span class="block end">}</span>.<span class="block start">{</span><span class="variable">vf</span><span class="block end">}</span>.<span class="block start">{</span><span class="variable">vc</span><span class="block end">}</span>.<span class="block start">{</span><span class="variable">ac</span><span class="block end">}</span></code>Firefly.s01e01.Serenity.720p.x264.ac3
</p>
<p>
2011-09-29 22:22:30 -04:00
<code><span class="block start">{</span><span class="variable">n</span><span class="block end">}</span> [<span class="block start">{</span><span class="variable">airdate</span>.<span class="method">format</span>(<span class="string">'<a style="color:inherit" href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html" target="_blank">yyyy.MM.dd</a>'</span>)<span class="block end">}</span>] <span class="block start">{</span><span class="variable">t</span><span class="block end">}</span></code>The Daily Show [2010.01.05] George Lucas
2011-10-10 12:23:10 -04:00
</p>
<p>
2011-10-10 12:23:10 -04:00
<code>E:/Complete/<span class="block start">{</span><span class="variable">n</span><span class="block end">}</span> (<span class="block start">{</span><span class="variable">y</span><span class="block end">}</span>)<span class="block start">{</span><span class="string">'/Season '</span>+<span class="variable">s</span><span class="block end">}</span>/<span class="block start">{</span><span class="variable">s</span>+<span class="string">'x'</span><span class="block end">}</span><span class="block start">{</span><span class="variable">e</span>.<span class="method">pad</span>(<span class="numeral">2</span>)<span class="block end">}</span> - <span class="block start">{</span><span class="variable">t</span><span class="block end">}</span></code>Rename and <strong>move</strong> files. The directory structure is completely up to you.
</p>
<p>
<code><span class="block start">{</span><span class="variable">n</span>.<span class="method">replaceTrailingBrackets</span>()<span class="block end">}</span> - <span class="block start">{</span><span class="variable">s</span>+<span class="string">'x'</span><span class="block end">}</span><span class="block start">{</span><span class="variable">e</span>.<span class="method">pad</span>(<span class="numeral">2</span>)<span class="block end">}</span> - <span class="block start">{</span><span class="variable">t</span>.<span class="method">replaceAll</span>(<span class="regex">/[!?.]+$/</span>).<span class="method">replaceAll</span>(<span class="regex">/[`´ʻ]/</span>, <span class="string">"'"</span>)<br/>.<span class="method">lowerTrail</span>().<span class="method">replacePart</span>(<span class="string">', Part $1'</span>)<span class="block end">}</span></code>My personal favorite. Pretty much 1x01, normalizing accents, and lots of other cleanup operations.
</p>
2011-09-22 12:11:00 -04:00
<h2 class="reference" id="bindings">
Binding Reference
2016-04-21 09:56:54 -04:00
<a href="https://github.com/filebot/filebot/tree/master/source/net/filebot/format/MediaBindingBean.java" class="source" target="_blank">source</a>
</h2>
2011-09-15 05:51:22 -04:00
<table class="reference binding">
<tr>
<th>Name</th>
<th>Description</th>
<th>Example</th>
</tr>
<tr>
<td>n</td>
2011-09-29 22:22:30 -04:00
<td>series/movie name</td>
<td>Dark Angel</td>
</tr>
2011-10-01 00:08:46 -04:00
<tr>
<td>y</td>
<td>series/movie year</td>
<td>2009</td>
</tr>
<tr>
<td>s</td>
<td>season number</td>
<td>3</td>
</tr>
<tr>
<td>e</td>
<td>episode number</td>
<td>1</td>
</tr>
<tr>
<td>t</td>
<td>episode title</td>
<td>Labyrinth</td>
</tr>
<tr>
<td>airdate</td>
<td>episode airdate</td>
<td>2009-06-01</td>
2011-11-21 07:35:28 -05:00
</tr>
<tr>
<td>absolute</td>
<td>absolute episode number</td>
<td>42</td>
</tr>
<tr>
<td>special</td>
2011-12-19 21:39:33 -05:00
<td>special number</td>
<td>1</td>
</tr>
<tr>
<td>ny</td>
<td>name (year)</td>
<td>Avatar (2009)</td>
</tr>
2011-11-21 07:05:47 -05:00
<tr>
2011-11-27 12:04:32 -05:00
<td>sxe</td>
2011-12-19 21:39:33 -05:00
<td>season / episode numbers</td>
2011-11-21 07:05:47 -05:00
<td>1x01</td>
</tr>
<tr>
2011-11-27 12:04:32 -05:00
<td>s00e00</td>
2011-12-19 21:39:33 -05:00
<td>season / episode numbers</td>
2011-11-21 07:05:47 -05:00
<td>S01E01</td>
</tr>
<tr>
<td>plex</td>
2016-09-22 02:04:09 -04:00
<td><a href="https://www.filebot.net/forums/viewtopic.php?f=5&amp;t=4116" target="_blank">Plex Naming Standard</a></td>
<td>&lt;path&gt;</td>
</tr>
<tr>
2012-09-17 11:21:17 -04:00
<td>imdbid</td>
<td>imdb id</td>
<td>tt0756683</td>
</tr>
<tr>
<td>vc</td>
<td>video codec</td>
<td>x264</td>
</tr>
<tr>
<td>ac</td>
<td>audio codec</td>
<td>ac3</td>
</tr>
<tr>
<td>cf</td>
<td>container format</td>
<td>mkv</td>
</tr>
<tr>
<td>vf</td>
2012-07-20 03:38:50 -04:00
<td>standard video format</td>
<td>720p</td>
</tr>
2012-07-20 03:38:50 -04:00
<tr>
<td>hpi</td>
<td>exact video format</td>
<td>384p</td>
</tr>
<tr>
<td>af</td>
<td>audio channels</td>
<td>6ch</td>
</tr>
2016-03-26 03:42:39 -04:00
<tr>
<td>channels</td>
<td>audio channels</td>
<td>5.1</td>
</tr>
<tr>
<td>resolution</td>
<td>video size</td>
<td>1280x720</td>
</tr>
<tr>
<td>bitdepth</td>
<td>video bitdepth</td>
<td>10</td>
</tr>
<tr>
<td>kbps</td>
<td>bitrate in kb/s</td>
<td>320 kbps</td>
</tr>
<tr>
<td>khz</td>
<td>sampling rate</td>
<td>44.1 kHz</td>
</tr>
2016-03-26 03:42:39 -04:00
<tr>
<td>minutes</td>
<td>Duration in minutes</td>
<td>42</td>
</tr>
2011-11-21 07:05:47 -05:00
<tr>
<td>ws</td>
2016-03-26 03:42:39 -04:00
<td>widescreen tag</td>
<td>WS</td>
2011-11-21 07:05:47 -05:00
</tr>
2011-11-02 10:48:23 -04:00
<tr>
<td>hd</td>
<td>UHD/HD/SD video</td>
<td>HD</td>
2011-11-02 10:48:23 -04:00
</tr>
2016-03-26 03:42:39 -04:00
<tr>
<td>s3d</td>
<td>Stereoscopic 3D tag</td>
<td>3D SBS</td>
</tr>
<tr>
<td>source</td>
<td>source medium</td>
<td>BluRay</td>
</tr>
<tr>
<td>group</td>
2016-11-26 00:17:57 -05:00
<td><a href="https://www.filebot.net/forums/viewtopic.php?f=5&amp;t=4" target="_blank">release group</a></td>
<td>ALLiANCE</td>
</tr>
<tr>
<td>crc32</td>
<td>crc32 checksum</td>
<td>3E16AF40</td>
</tr>
2016-03-26 03:42:39 -04:00
<tr>
<td>gigabytes</td>
<td>Filesize in gigabytes</td>
<td>4.2</td>
</tr>
<tr>
<td>fn</td>
2014-12-21 11:41:33 -05:00
<td>original filename</td>
<td>Serenity</td>
2011-11-25 14:43:24 -05:00
</tr>
<tr>
<td>ext</td>
<td>file extension</td>
<td>mkv</td>
</tr>
<tr>
<td>episode</td>
<td>episode object</td>
<td>&lt;default episode name&gt;</td>
</tr>
<tr>
<td>movie</td>
<td>movie object</td>
<td>&lt;default movie name&gt;</td>
2011-11-25 14:43:24 -05:00
</tr>
<tr>
<td>pi</td>
2011-10-10 23:37:46 -04:00
<td>movie part index</td>
<td>1</td>
</tr>
<tr>
<td>pn</td>
<td>movie part count</td>
<td>2</td>
</tr>
2011-11-21 07:35:28 -05:00
<tr>
<td>lang</td>
2016-03-26 03:42:39 -04:00
<td>language tag</td>
2011-11-21 07:35:28 -05:00
<td>eng</td>
</tr>
2016-03-26 03:42:39 -04:00
<tr>
<td>subt</td>
<td>subtitle tags</td>
<td>.eng.forced</td>
</tr>
2012-08-10 22:40:25 -04:00
<tr>
<td>collection</td>
<td>movie set</td>
<td>Avatar Collection</td>
</tr>
2012-02-20 04:38:58 -05:00
<tr>
<td>director</td>
<td>movie director</td>
<td>James Cameron</td>
</tr>
<tr>
<td>actors</td>
<td>list of actors</td>
<td>[Sam Worthington, Zoe Saldana, ...]</td>
</tr>
<tr>
<td>genre</td>
<td>primary genre</td>
<td>Science Fiction</td>
</tr>
2012-02-20 04:38:58 -05:00
<tr>
<td>genres</td>
<td>list of genres</td>
<td>[Science Fiction, Action, ...]</td>
</tr>
2016-03-26 03:42:39 -04:00
<tr>
<td>languages</td>
<td>list of spoken languages</td>
<td>[eng]</td>
2016-03-26 03:42:39 -04:00
</tr>
2012-02-20 04:38:58 -05:00
<tr>
<td>certification</td>
<td>content rating</td>
<td>PG-13</td>
</tr>
<tr>
<td>rating</td>
<td>movie rating</td>
<td>8.5</td>
</tr>
<tr>
<td>info</td>
2014-12-21 11:41:33 -05:00
<td>extended metadata</td>
2012-02-20 04:38:58 -05:00
<td>&lt;any movie / series info&gt;</td>
</tr>
<tr>
2014-12-21 11:41:33 -05:00
<td>omdb</td>
<td><a href="http://www.omdbapi.com/">OMDb</a> info</td>
2014-12-21 11:41:33 -05:00
<td>&lt;any movie / series info&gt;</td>
</tr>
<tr>
<td>home</td>
<td>user home folder</td>
<td>/Users/Alice</td>
</tr>
<tr>
<td>file</td>
<td>file object</td>
<td>&lt;file path&gt;</td>
</tr>
2012-08-10 22:40:25 -04:00
<tr>
<td>dim</td>
<td>video dimensions</td>
<td>&lt;width and height&gt;</td>
</tr>
<tr>
<td>media</td>
<td>general media info object</td>
<td>&lt;any general media parameter&gt;</td>
</tr>
<tr>
<td>video</td>
<td>video streams</td>
<td>&lt;any video parameter&gt;</td>
</tr>
<tr>
<td>audio</td>
<td>audio streams</td>
<td>&lt;any audio parameter&gt;</td>
</tr>
<tr>
<td>text</td>
<td>subtitle streams</td>
<td>&lt;any subtitle parameter&gt;</td>
2011-11-25 14:43:24 -05:00
</tr>
</table>
2011-09-22 12:11:00 -04:00
<h2 class="reference" id="functions">
Function Reference
2016-04-21 09:56:54 -04:00
<a href="https://github.com/filebot/filebot/tree/master/source/net/filebot/format/ExpressionFormatMethods.java" class="source" target="_blank">source</a>
</h2>
<p>
<code><span class="method">pad</span>(<span class="numeral">length</span>, <span class="string">padding</span> = <span class="string">"0"</span>)</code>Pad strings or numbers with given characters ('0' by default).
</p>
<p>
2011-11-08 05:41:40 -05:00
<code><span class="method">match</span>(<span class="regex">pattern</span>)</code>Get a substring matching the given pattern or break.
</p>
<p>
2012-08-10 22:40:25 -04:00
<code><span class="method">matchAll</span>(<span class="regex">pattern</span>)</code>Get a list of substrings matching the given pattern or break.
</p>
<p>
<code><span class="method">space</span>(<span class="string">replacement</span>)</code>Replace all spaces (e.g. "Doctor Who" ➔ "Doctor_Who").
2011-11-25 14:43:24 -05:00
</p>
<p>
<code><span class="method">colon</span>(<span class="string">replacement</span>)</code>Replace all colons (e.g. "Sissi: The Young Empress" ➔ "Sissi - The Young Empress").
</p>
<p>
<code><span class="method">slash</span>(<span class="string">replacement</span>)</code>Replace all slashes (e.g. "V_MPEG4/ISO/AVC" ➔ "V_MPEG4.ISO.AVC").
</p>
<p>
<code><span class="method">upperInitial</span>()</code>Upper-case all initials (e.g. "The Day a new Demon was born" ➔ "The Day A New Demon Was Born").
</p>
<p>
<code><span class="method">lowerTrail</span>()</code>Lower-case all letters that are not initials (e.g. "Gundam SEED" ➔ "Gundam Seed").
</p>
<p>
<code><span class="method">acronym</span>()</code>Get acronym, i.e. first letter of each word. (e.g. "Deep Space 9" ➔ "DS9").
</p>
<p>
<code><span class="method">roman</span>()</code>Replace numbers 1..12 with roman numerals (e.g. "Star Wars: Episode 4" ➔ "Star Wars: Episode IV").
2012-07-20 03:38:50 -04:00
</p>
<p>
<code><span class="method">before</span>(<span class="regex">pattern</span>)</code>Get the substring before the given pattern or the original value.
2011-11-08 05:41:40 -05:00
</p>
<p>
<code><span class="method">after</span>(<span class="regex">pattern</span>)</code>Get the substring after the given pattern or the original value.
</p>
2011-11-08 05:41:40 -05:00
<p>
<code><span class="method">replaceAll</span>(<span class="regex">pattern</span>, <span class="string">replacement</span> = <span class="string">""</span>)</code>Replace or remove all occurrences of the pattern.
</p>
<p>
<code><span class="method">replaceTrailingBrackets</span>(<span class="string">replacement</span> = <span class="string">""</span>)</code>Replace trailing parenthesis including any leading whitespace (e.g. "The IT Crowd (UK)" ➔ "The IT Crowd").
</p>
<p>
<code><span class="method">replacePart</span>(<span class="string">replacement</span> = <span class="string">""</span>)</code>Replace part identifier (e.g. "Today Is the Day (1)" ➔ "Today Is the Day, Part 1").
</p>
<p>
<code><span class="method">ascii</span>()</code>Convert Unicode to ASCII. (e.g. "Österreich" ➔ "Osterreich" or "カタカナ" ➔ "katakana").
</p>
<p>
<code><span class="method">transliterate</span>(<span class="regex">identifier</span>)</code>Apply any <a target="_blank" href="http://userguide.icu-project.org/transforms/general">ICU script transliteration</a>. e.g. "中国".transliterate("han-latin") ➔ "zhōng guó".
</p>
</div>
<p class="suggestion">
2016-11-26 00:17:57 -05:00
Need some help getting started? Check the <a href="https://www.filebot.net/forums/viewforum.php?f=5">forums</a>.
2011-11-16 12:24:14 -05:00
</p>
<div class="metrics">
</div>
<div class="footer">
2017-06-08 05:07:14 -04:00
<p>Hosted on <a href="https://www.filebot.net/">filebot.net</a> | Creative Commons License: Attribution-NonCommercial-ShareAlike © @{tstamp.year}</p>
</div>
</div>
</div>
</body>
</html>