Application icon

HTML Track Display

 

The HTML Track Display action produces an HTML file describing the loaded tracks. The display is designed to be a track listing similar to what is displayed on iTunes or Amazon. The action handles albums and also a mixed set of tracks from multiple albums and/or multiple folders. The action can be run interactively or through the Batch Processor. The action produces files: HTML/tracklist.html and HTML/tracklist.jpg.

The produced HTML file is self contained with the exception of a thumbnail for the artwork. The thumbnail is a 300x300 jpeg. The embedded CSS was designed to be as easy as possible to edit in the case that you want to make changes.

While the action is running, changes may be made to the selected tracks. However, when the action terminates the tracks are returned to exactly the same state they were in before running the action.

When the action is run for the first time, the HTML Track Display - Configuration action is automatically run to configure the settings. If for any reason you want to go through the initialization process again, start the action while holding down the Option key. Alternately, you can directly run the configuration action HTML Track Display - Configuration.

The information displayed is divided into two parts. The top of the page displays a left justified image. The image, from its original audio file, can optionally be opened in Yate's Artwork Viewer. Immediately to the right of the image is the overall information. This includes the following information:

The Album name
If there is no Album field or it is inconsistent, you will be prompted for a name to display. If running through the Batch Processor, a specified default name will be used. If the name to display is empty, Various Tracks will be used. If all tracks are in the same folder, clicking on the Album name can optionally load the folder in Yate.

The Album Artist name
If there is no non empty consistent Album Artist field, the Artist field will be examined. If there is still no name, Unknown Artist will be used. If there are names but they are inconsistent, Various Artists will be used.

The Year
If the Year field is not consistent, nothing will be displayed.

The Duration
The summed duration of all tracks is displayed.

The Genre
If the Genre field is consistent, it will be displayed. If there are no genres available, nothing will be displayed. If there are multiple genres, they will be displayed separated by commas, sorted by increasing occurrences first.

The bottom of the display describes the individual tracks. If all tracks are in the same album, the list of tracks will be sorted to ensure the correct disc/track order. Each line contains the following items:

The Number
The number can be a track number or disc.track number sequence. This depends on the tracks themselves and various options. When the action determines that not all tracks are in the same album, there is an option to number the displayed tracks from 1.

A symbolic representation of the Love field
This item is optional. If displayed it can display a unique symbol for each of the three possible states.

The Title
This consists of one to three components. If there is no Title field, Unknown Track is displayed. If the track's Artist field is not empty and it is not the same as the previously chosen Album Artist item, the text by artist will be displayed. If the tracks are from multiple albums and the Album field is not empty, you can optionally have from the album Album Name displayed.

The Track's Duration
You can configure the optional display of duration offsets when hovering over this field.

You can also optionally have each tracks's title be a link to the file. Depending on the audio file type, the OS version and the browser you display in, the link may play the content from a displayed control. Not all browser's will play audio content. The action has three different methods of playing the audio.



The HTML Track Display - Configuration action


Output mode
You have two choices. Embed will create an HTML folder in the folder containing the tracks, if all tracks are in the same folder. If more than one folder is referenced, you will be prompted for a folder in which to place the HTML folder and its generated content. Fixed requires that you supply a folder which will receive the generated files. Only use this mode if you do not want to retain the produced files. Note that when the action is run through the Batch Processor, Embed is always used.

Settings applying to an inconsistent album name
Batch Processor album name
If the selected tracks do not have a consistent album name and you are running in the UI, you will be prompted for a name to use. When running in the batch processor, Various Tracks will be used unless you specify a different name.

Renumber from 1
You can specify that in the case of an inconsistent Album field, you want the tracks to be renumbered from 1.

Display album metadata
You can specify that in the case of an inconsistent Album field, you want album names to be displayed in the per track information's Title field. This is optional as if you are displaying a playlist you might not want the information.
Title audio link type / Player
You can choose to create the Title fields as links to play the audio files. There are four modes:
None
No links will be generated.

Browser
A link will be created which attempts to open an audio player in the browser. The link will open in a new tab or window. Note this is not supported by all browsers and even when supported, not all audio types will play.

Preview
Yate will be opened if not already running and the audio file will be pushed to a Mac preview panel.

Player
The name of a player must be supplied. The supplied player must be responsive to the Finder Open-With mechanism. Yate will be opened if not already running and the audio file will be opened in the supplied player.
Default artwork
An optional path to an image file to be used as the default artwork item when necessary.

The Album Artist field delimiter
You can override the default of the multi-value delimiter.

The Artist field delimiter
You can override the default of the multi-value delimiter.

The Genre field delimiter
You can override the default of the multi-value delimiter.

Missing Artwork
This setting controls how missing artwork is handled. By default the action looks for a common artwork item.
Use any embedded artwork item
The first artwork item found in any selected file will be used. If none is found, the Default artwork item, if set, is used.

Do not display artwork
No artwork is displayed.

Use the default artwork item
The Default artwork item is used, if specified.
Show Love/Dislike metadata
When this setting is YES, the track's Love field will be displayed after the track number.
Love character
You can enter a character to represent loved. Only the first non blank character is used. The default is a red heart.

Disliked character
You can enter a character to represent disliked. Only the first non blank character is used. The default is a bomb.

Unrated character
You can enter a character to represent unrated. Only the first non blank character is used. The default is empty.
Displayed album name is a load link
You can elect to make the Album field a link to open the album in Yate. The link is only generatd if all selected files are in the same folder. How the album is opened depends on the Open Mode.

Displayed artwork is a viewer link
You can elect to make the displayed artwork to be a link to open the full size image in Yate's artwork viewer.

Time field tooltips are offsets.
You can enable the display of a positional duration in the list by hovering over a tracks's duration. The displayed time is the offset from the start of the displayed tracks.

If you are running in the UI and the action was directly run, (ie. not from another action), the created page will be opened in your default browser. This means that you can call the action from another in your workflow to create the files without displaying it.

Note that when run from the UI, the track order is not modified unless there is a consistent album. When run from the Batch Processor each folder is sorted by Disc - Track.



The Display HTML from Album Database action

This action is designed to be called from an Album database. The row clicked when the action is started serves as the source of a folder. The action will display existing HTML/tracklist.html content. If the content does not exist, the HTML Track Display action will be called to produce and display it.

When producing the content, all loaded audio files are removed and replaced with the audio files in the source folder. The action can also be used to re-generate the content.

The first time the action is run you are presented with a panel allowing you to suppress the panel, display existing content or re0generate the content. The panel can always be displayed by starting the action with the Option key down.




Content List:

Actions:

HTML Track Display

Display HTML from Album Database

HTML Track Display - Configuration

Replacement Set:

Encode for HTML

Requirements:

Yate v7.0

History:


Date Version Information
2018-05-21 v1.0 First release.
2020-10-02 v1.1 Cleaned up. Added a documentation link.
2020-10-04 v1.2 Added dark mode support.
2020-10-04 v1.3 A second attempt at dark mode support.
2021-05-18 v2.0 Added support for: Loading a folder into Yate; viewing the displayed image (from the original source) in Yate's Artwork Viewer; optionally displaying track offsets in tooltips.
2023-01-02 v3.0 Completely rewrote the configuration. Added the Display HTML from Album Database action and a separate configuration action.
2023-01-10 v3.1 HTML escaping was not done on the displayed fields.
2024-10-010 v3.3 Changes for Yate v7.0.

Download


Back to Yate Resources