Filename tags
The tags system allows for conveying file information in the file name while preventing versioning issues by removing the tag once parsed. The most common use is generally loop frames and hold frames. These are tags. Volare reads them while in Delivery, keeps their values with the file, and takes them out of the name once the file reaches Staged.
For example, opener_IN120_OUT1920_v03.mov has an in frame of 120 and an out
frame of 1920, and is staged as opener_v03.mov.
The tags
Section titled “The tags”There are five available tag options:
| Tag | Default text | Default kind | In a name | Read as |
|---|---|---|---|---|
| In frame | IN | Numeric | IN120 | The loop starts at 120 |
| Out frame | OUT | Numeric | OUT1920 | The loop ends at 1920 |
| Hold frame | HOLD | Numeric | HOLD45 | Hold on frame 45 |
| Alpha | ALPHA | Flag | ALPHA | The file has alpha |
| Audio | AUD | Flag | AUD | The file has audio |
Tags are configured in the Tags section of the Tasks page.
How Volare finds a tag
Section titled “How Volare finds a tag”Volare finds a tag when there’s an underscore right before it and an underscore or the file extension right after it. Tags are case-insensitive.
| File name | In frame |
|---|---|
intro_IN120_v03.mov | 120 |
verse_iN170.mov | 170 |
IN900_opener_v03.mov | None: no underscore before it |
opener_MAIN120.mov | None: part of the word MAIN120 |
opener-v03-IN120.mov | None: hyphens, not underscores |
Each tag has a kind, which defines what follows its identifier.
| Kind | Means | Read |
|---|---|---|
| Numeric | A number follows the text. | IN120 |
| Boolean | 0 or 1 follows the text: no or yes. | ALPHA0 / ALPHA1 |
| Flag | The text on its own means yes. | ALPHA |
Removing tags from the name
Section titled “Removing tags from the name”When a file is staged, Volare removes each enabled tag from its name:
| Kind | Delivered as | Staged as |
|---|---|---|
| Numeric | opener_IN120_OUT1920_v03.mov | opener_v03.mov |
| Boolean | logo_ALPHA1_v02.mov | logo_v02.mov |
| Flag | walkin_AUD_v01.mov | walkin_v01.mov |
When a file is renamed in Delivery
Section titled “When a file is renamed in Delivery”While the file is still in Delivery, Volare reads the tags in the new name every time it’s renamed or moved within the Delivery folder or subfolders:
- A tag in the new name replaces the old value.
song_IN100_v01.movrenamed tosong_IN200_v01.movhas an In frame of 200. - A tag missing from the new name keeps its last value.
song_IN100_v01.movrenamed tosong_v01.movkeeps an In frame of 100.
Once the file reaches Staged, renaming it doesn’t change its values.
Where you see tags
Section titled “Where you see tags”On the Staging page, In Delivery shows the file’s name with each tag highlighted in its color, and When Staged shows the name without them.
- A highlighted tag is one Volare reads. Volare highlights only enabled tags it can read, so text that isn’t highlighted is ignored: it’s the wrong kind, at the start of the name, or its tag is off.
The Loop check is prepopulated with the file’s In and Out tags.