diff --git a/docs/manual/dashboard/index.md b/docs/manual/dashboard/index.md index c352923a4..96b8d75f9 100644 --- a/docs/manual/dashboard/index.md +++ b/docs/manual/dashboard/index.md @@ -1,69 +1,121 @@ -The Dashboard is divided into two sections a Library section divided between [Tracks](../tracks),[Playlists](../playlists),[Smart Blocks](../smartblocks),[Webstreams](../webstreams), and [Podcasts](../podcasts) and the **Scheduled Shows** dialog on the right. This page provides an overview of the right-hand interface. Check the links to see information about the other sections which provide the content that can be scheduled. +# Dashboard +The Dashboard is divided into two sections a Library section divided between +[Tracks](../tracks),[Playlists](../playlists), [Smart Blocks](../smartblocks), +[Webstreams](../webstreams), and [Podcasts](../podcasts), with the **Scheduled +Shows** dialog on the right. This page provides an overview of the right-hand +interface. Check the links to see information about the other sections which +provide the content that can be scheduled. -The **Scheduled ShowS** page provides a view of the content your station is will playout, or has already played out, which defaults to showing the 24 hours ahead. This page also enables you to make last-minute changes to running shows. +The **Scheduled Shows** page provides a view of the content your station is will +playout, or has already played out, which defaults to showing the 24 hours +ahead. This page also enables you to make last-minute changes to running shows. -If you've only just installed Libretime, there might not be any content shown yet. Click the calendar and clock icons above the table to change the date and time range, then click the **Find Shows** button (with the magnifying glass icon) to the right. +If you've only just installed Libretime, there might not be any content shown +yet. Click the calendar and clock icons above the table to change the date and +time range, then click the **Find Shows** button (with the magnifying glass +icon) to the right. -![](static/Screenshot416-Now_playing_date_select.png) +![](static/now-playing.png) -To display the content of a particular show, click **Filter by Show** and select the name of the show from the drop-down menu which will appear. +To display the content of a particular show, click **Filter by Show** and select +the name of the show from the drop-down menu which will appear. -![](static/Screenshot417-Filter_by_show.png) +![](static/filter.png) -On the left side of the page, the **Start** and **End** times, **Duration** and **Title** of each content item are shown. On the right, **Creator**, **Album**, **Cue** or **Fade** times and **Mime** type (file format) can also be shown. This information can help you to prepare voice tracks for insertion into the show, including time checks if you wish. Putting current time information into voice tracks describing specific content can, of course, limit the re-usability of those voice tracks, unless you always broadcast a particular item at the same time of day. +On the left side of the page, the **Start** and **End** times, **Duration** +and **Title** of each content item are shown. On the right, **Creator**, +**Album**, **Cue** or **Fade** times and **Mime** type (file format) can also be +shown. This information can help you to prepare voice tracks for insertion into +the show, including time checks if you wish. Putting current time information i +to voice tracks describing specific content can, of course, limit the +re-usability of those voice tracks, unless you always broadcast a particular +item at the same time of day. -Click the **Show/hide columns** button on the right to configure the metadata displayed, by checking the boxes in the pop-up window. +Click the **Show/hide columns** button on the right to configure the metadata +displayed, by checking the boxes in the pop-up window. -![](static/Screenshot498-Show_hide_columns_240.png) +![](static/columns.png) -The row for the currently playing item is displayed with a bright green background. Any underbooked shows (shows with insufficient content to fill the time allowed) are displayed with a row indicating the length of the underbooking in minutes and seconds. These rows contain a red exclamation mark in the first column, and have a pink background. +The row for the currently playing item is displayed with a bright green +background. Any underbooked shows (shows with insufficient content to fill the +time allowed) are displayed with a row indicating the length of the underbooking +in minutes and seconds. These rows contain a red exclamation mark in the first +column, and have a pink background. -![](static/Screenshot322-Gap_at_show_end.png) +![](static/end-gap.png) Removing content from a running show ------------------------------------ -If a show is overbooked, which means the total playout duration is longer than the time allowed for the show, a brown row indicates that the item will be faded out when the show ends. A red row indicates that the item will not be played at all. The length of the overbooking is shown in minutes and seconds in the last row of the show. To remove the extra items from the end of an overbooked show, click the **Scissors** button at the top left of the table. +If a show is overbooked, which means the total playout duration is longer than +the time allowed for the show, a brown row indicates that the item will be faded +out when the show ends. A red row indicates that the item will not be played at +all. The length of the overbooking is shown in minutes and seconds in the last +row of the show. To remove the extra items from the end of an overbooked show, +click the **Scissors** button at the top left of the table. -![](static/Screenshot418-Remove_overbooked_tracks.png) +Alternatively, check the boxes for items which have not yet completed playout, +and click the **Trashcan** button, to the right of the Scissors, to remove them +from the schedule. If you remove the currently playing item, playout will skip +to the next item in the show automatically, so you should make sure you have +enough items remaining in the show to avoid dead air. -Alternatively, check the boxes for items which have not yet completed playout, and click the **Trashcan** button, to the right of the Scissors, to remove them from the schedule. If you remove the currently playing item, playout will skip to the next item in the show automatically, so you should make sure you have enough items remaining in the show to avoid dead air. +![](static/delete-extra.png) -![](static/Screenshot419-Remove_selected_tracks.png) +If you have a long schedule displayed, and you wish to skip to the currently +playing item, click the button with the end arrow icon, to the right of the +**Trashcan**. -If you have a long schedule displayed, and you wish to skip to the currently playing item, click the button with the end arrow icon, to the right of the **Trashcan**. +To cancel the current show completely, click the red button to the right again. +A pop-up window will ask you to confirm the cancellation, as this action cannot +be undone. -To cancel the current show completely, click the red button to the right again. A pop-up window will ask you to confirm the cancellation, as this action cannot be undone. +![](static/cancel-show.png) -![](static/Screenshot420-Cancel_current_show.png)  - -Items which are no longer available have an exclamation mark icon in the second column. This may happen for media files which were part of previous shows, and were removed from Libretime's library (main storage or watched folders) subsequently. Items which are included in forthcoming shows cannot be removed from the Library via the Libretime interface. - -![](static/Screenshot421-Missing_file_icon.png) +Items which are no longer available have an exclamation mark icon in the second +column. This may happen for media files which were part of previous shows, and +were removed from Libretime's library (main storage or watched folders) +subsequently. Items which are included in forthcoming shows cannot be removed +from the Library via the Libretime interface. Adding content to a running show -------------------------------- -After you have found the items that you want using the search tools, you can then drag and drop them from the library table on the left side of the page into the shows on the right side, including the current playing show. +After you have found the items that you want using the search tools, you can +then drag and drop them from the library table on the left side of the page into +the shows on the right side, including the current playing show. -If the current show has nothing playing out at the time, the new item will begin playing immediately. This manual triggering of playout can be used as a live assist technique, in which the Libretime server's soundcard output is mixed with other sources such as microphones or telephone hybrids on its way to a transmitter, or a separate stream encoder. For instance, a live show's host may not wish to cut off a studio discussion in order to play music at a fixed time. +If the current show has nothing playing out at the time, the new item will begin +playing immediately. This manual triggering of playout can be used as a live +assist technique, in which the Libretime server's soundcard output is mixed with +other sources such as microphones or telephone hybrids on its way to a +transmitter, or a separate stream encoder. For instance, a live show's host may +not wish to cut off a studio discussion in order to play music at a fixed time. -![](static/Screenshot428-Library_drag_and_drop.png) +![](static/drag-and-drop.png) -You can also select multiple items using the **Select** menu button, just beneath the simple search field, which has the options to **Select this page** of search results, **Deselect this page** and **Deselect all**. Alternatively, use the checkboxes on the left side of the library table to select specific items. Then drag one of the items into the show to add all of the selected items, or click the **Add to selected show** button, which has a plus icon. If you wish, you can also use the **Trashcan** button to permanently remove items from Libretime's library. Only *admin* users have permission to delete all items. +You can also select multiple items using the **Select** menu button, just +beneath the simple search field, which has the options to **Select this page** +of search results, **Deselect this page** and **Deselect all**. Alternatively, +use the checkboxes on the left side of the library table to select specific +items. Then drag one of the items into the show to add all of the selected +items, or click the **Add to selected show** button, which has a plus icon. If +you wish, you can also use the **Trashcan** button to permanently remove items +from Libretime's library. Only *admin* users have permission to delete all +items. -To insert checkbox selected items at a specific time in the show schedule, click one of the grey and white triangle icons on the left side of the schedule table, which will change to red and white. A red horizontal line will be shown at the insertion point. Then click the **Add to selected show** button in the library table. +To insert checkbox selected items at a specific time in the show schedule, click +one of the songs in the schedule table. Then click the **Add to selected show** +button in the library table. This will insert the library songs after the +selected scheduled song. -To add a single item at the insertion point, double-click on it in the library. There is no need to select or drag the item first. +To add a single item at the insertion point, double-click on it in the library. +There is no need to select or drag the item first. -![](static/Screenshot429-Show_insertion_point.png) +Right-clicking on a song in the schedule table will show a pop-up. This pop-up +menu also enables you to audition the entire show in advance of playout, or +remove the item that was clicked on from the show. -Another way to create an insertion point is to click an item in the show table, then click **Select cursor** on the small pop-up menu that will appear. This pop-up menu also enables you to audition the entire show in advance of playout, or remove the item that was clicked on from the show. - -![](static/Screenshot430-Select_cursor.png) - -Multiple insertion points can be enabled, so that the same item is inserted into the schedule at different times. For example, you may wish to play a news report every hour, or a station ident after every five music files. - -A live show set for recording from the Libretime server's sound card is displayed with a red dot icon in the first column. It would not contain any files or playlists, smart blocks or web streams. - -![](static/Screenshot431-Recording_from_line_in.png) +Multiple insertion points can be enabled, so that the same item is inserted into +the schedule at different times. For example, you may wish to play a news report +every hour, or a station ident after every five music files. diff --git a/docs/manual/dashboard/static/Screenshot322-Gap_at_show_end.png b/docs/manual/dashboard/static/Screenshot322-Gap_at_show_end.png deleted file mode 100644 index 11396fede..000000000 Binary files a/docs/manual/dashboard/static/Screenshot322-Gap_at_show_end.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot416-Now_playing_date_select.png b/docs/manual/dashboard/static/Screenshot416-Now_playing_date_select.png deleted file mode 100644 index af78e5a46..000000000 Binary files a/docs/manual/dashboard/static/Screenshot416-Now_playing_date_select.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot417-Filter_by_show.png b/docs/manual/dashboard/static/Screenshot417-Filter_by_show.png deleted file mode 100644 index d6618d3f7..000000000 Binary files a/docs/manual/dashboard/static/Screenshot417-Filter_by_show.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot418-Remove_overbooked_tracks.png b/docs/manual/dashboard/static/Screenshot418-Remove_overbooked_tracks.png deleted file mode 100644 index 2af0d73e1..000000000 Binary files a/docs/manual/dashboard/static/Screenshot418-Remove_overbooked_tracks.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot419-Remove_selected_tracks.png b/docs/manual/dashboard/static/Screenshot419-Remove_selected_tracks.png deleted file mode 100644 index 88477af20..000000000 Binary files a/docs/manual/dashboard/static/Screenshot419-Remove_selected_tracks.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot420-Cancel_current_show.png b/docs/manual/dashboard/static/Screenshot420-Cancel_current_show.png deleted file mode 100644 index 8f2bd3ee7..000000000 Binary files a/docs/manual/dashboard/static/Screenshot420-Cancel_current_show.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot421-Missing_file_icon.png b/docs/manual/dashboard/static/Screenshot421-Missing_file_icon.png deleted file mode 100644 index 2dd02486b..000000000 Binary files a/docs/manual/dashboard/static/Screenshot421-Missing_file_icon.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot423-Advanced_search_options.png b/docs/manual/dashboard/static/Screenshot423-Advanced_search_options.png deleted file mode 100644 index 368d5b4fe..000000000 Binary files a/docs/manual/dashboard/static/Screenshot423-Advanced_search_options.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot428-Library_drag_and_drop.png b/docs/manual/dashboard/static/Screenshot428-Library_drag_and_drop.png deleted file mode 100644 index 4414ee0d9..000000000 Binary files a/docs/manual/dashboard/static/Screenshot428-Library_drag_and_drop.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot429-Show_insertion_point.png b/docs/manual/dashboard/static/Screenshot429-Show_insertion_point.png deleted file mode 100644 index 7836c420c..000000000 Binary files a/docs/manual/dashboard/static/Screenshot429-Show_insertion_point.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot430-Select_cursor.png b/docs/manual/dashboard/static/Screenshot430-Select_cursor.png deleted file mode 100644 index ff65f5d0b..000000000 Binary files a/docs/manual/dashboard/static/Screenshot430-Select_cursor.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot431-Recording_from_line_in.png b/docs/manual/dashboard/static/Screenshot431-Recording_from_line_in.png deleted file mode 100644 index ab1a7cc84..000000000 Binary files a/docs/manual/dashboard/static/Screenshot431-Recording_from_line_in.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot498-Show_hide_columns_240.png b/docs/manual/dashboard/static/Screenshot498-Show_hide_columns_240.png deleted file mode 100644 index dd8678997..000000000 Binary files a/docs/manual/dashboard/static/Screenshot498-Show_hide_columns_240.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot575-Right_click_metadata.png b/docs/manual/dashboard/static/Screenshot575-Right_click_metadata.png deleted file mode 100644 index 00098fc2e..000000000 Binary files a/docs/manual/dashboard/static/Screenshot575-Right_click_metadata.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot576-Library_file_type_icons.png b/docs/manual/dashboard/static/Screenshot576-Library_file_type_icons.png deleted file mode 100644 index 26cd62655..000000000 Binary files a/docs/manual/dashboard/static/Screenshot576-Library_file_type_icons.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot585-Insertion_point.png b/docs/manual/dashboard/static/Screenshot585-Insertion_point.png deleted file mode 100644 index 8aad58f70..000000000 Binary files a/docs/manual/dashboard/static/Screenshot585-Insertion_point.png and /dev/null differ diff --git a/docs/manual/dashboard/static/Screenshot586-Add_to_current_show.png b/docs/manual/dashboard/static/Screenshot586-Add_to_current_show.png deleted file mode 100644 index 7228b27e6..000000000 Binary files a/docs/manual/dashboard/static/Screenshot586-Add_to_current_show.png and /dev/null differ diff --git a/docs/manual/dashboard/static/cancel-show.png b/docs/manual/dashboard/static/cancel-show.png new file mode 100644 index 000000000..381ff3a82 Binary files /dev/null and b/docs/manual/dashboard/static/cancel-show.png differ diff --git a/docs/manual/dashboard/static/columns.png b/docs/manual/dashboard/static/columns.png new file mode 100644 index 000000000..adfdd102d Binary files /dev/null and b/docs/manual/dashboard/static/columns.png differ diff --git a/docs/manual/dashboard/static/delete-extra.png b/docs/manual/dashboard/static/delete-extra.png new file mode 100644 index 000000000..08f62d9a2 Binary files /dev/null and b/docs/manual/dashboard/static/delete-extra.png differ diff --git a/docs/manual/dashboard/static/drag-and-drop.png b/docs/manual/dashboard/static/drag-and-drop.png new file mode 100644 index 000000000..92e77c722 Binary files /dev/null and b/docs/manual/dashboard/static/drag-and-drop.png differ diff --git a/docs/manual/dashboard/static/end-gap.png b/docs/manual/dashboard/static/end-gap.png new file mode 100644 index 000000000..aa3b29aba Binary files /dev/null and b/docs/manual/dashboard/static/end-gap.png differ diff --git a/docs/manual/dashboard/static/filter.png b/docs/manual/dashboard/static/filter.png new file mode 100644 index 000000000..2fd07d76c Binary files /dev/null and b/docs/manual/dashboard/static/filter.png differ diff --git a/docs/manual/dashboard/static/now-playing.png b/docs/manual/dashboard/static/now-playing.png new file mode 100644 index 000000000..b6aafcdda Binary files /dev/null and b/docs/manual/dashboard/static/now-playing.png differ