Generic Text Exporter

This action is used to produce a text file with defined content extracted from select files. It can also be called from another action to extend the functionality.

You define the content to be extracted in a rename template. After applying the rename template to each selected file, only the filename (without extension) is retained. Note that files are not renamed. Using the template you can specify exactly what text is extracted for each file.

The text extracted from each file automatically has a newline (\n) sequence appended.

The above is sufficient when you want to output a single line for each file. You can specify \\n in the rename template to insert a newline character wherever you wish. In fact, you can specify any Yate escape sequence in the rename template. You must however use \\ as opposed to \ at the start of the sequence. For example a tab character would be \\-

When you run the Generic Text Exporter action you will be prompted for a rename template and then for a file path. A sample rename template named Generic Text Importer - Sample 1 is provided which displays the following for each file:

title
    artist
    album

Note that the action ignores all settings in the specified rename template other than the actual tokens.

The Generic Text Exporter action can be called from another action in the case where you want to manipulate the produced text list. This is also useful if you want to include some on the fly information in track variables which are referenced by the rename template. When called in this manner, you can preset the template named variable to contain the name of the template. If the specified template exists, you will not be prompted for one. If template is not specified, you will asked to select one. Note that when called from another action, the produced text is not written to a file. It is returned in named variable results. The Generic Text Exporter action preserves all track variables.

When called from another action, the action test state will be set to true if everything worked. It will be set to false if a supplied rename template did not exist or if an error occurred when applying the template to at least one of the selected files.

A sample action is provided which uses rename template Generic Text Importer - Sample 2. This template is identical to sample 1 with the exception that a reference to Variable 1 precedes the tokens. A track's time offset in the list is placed into the variable. A total duration is placed after the last track's exported data. The action is called Generic Text Exporter: Sample Extension.

Actions:

Folder: Generic Text Exporter

Generic Text Exporter: Sample Extension

Generic Text Exporter

Rename Templates:

Generic Text Importer - Settings Override

Generic Text Importer - Sample 1

Generic Text Importer - Sample 2

Replacement Sets:

Generic Text Exporter

Requirements:

Yate v8.1.1

History:

Download