Reorganized around single /docs directory

This commit is contained in:
Zachary Klosko 2020-05-13 10:40:49 -04:00
parent c02d0f6977
commit 9d12b9480b
245 changed files with 193 additions and 196 deletions

View file

@ -1,10 +1,10 @@
The Calendar page of the LibreTime administration interface has three views: **day**, **week** and **month**, which can be switched using the grey buttons in the top right corner. By default, the **month** view is shown, with today's date highlighted by a pale grey background. The Calendar page of the LibreTime administration interface has three views: **day**, **week** and **month**, which can be switched using the grey buttons in the top right corner. By default, the **month** view is shown, with today's date highlighted by a pale grey background.
![](static/Screenshot451-Calendar.png) ![](img/Screenshot451-Calendar.png)
In the top left corner of the page, you can go back or forward through the **Calendar** by clicking on the buttons which have a small grey triangle in a white circle. Click the **today** button to jump to today's date in the current view. (The **today** button will be greyed out if you are already viewing that date). In the **day** or **week** views, there is also a drop-down menu which allows you to set the resolution displayed for the calendar, ranging from one minute per row to sixty minutes per row. In the top left corner of the page, you can go back or forward through the **Calendar** by clicking on the buttons which have a small grey triangle in a white circle. Click the **today** button to jump to today's date in the current view. (The **today** button will be greyed out if you are already viewing that date). In the **day** or **week** views, there is also a drop-down menu which allows you to set the resolution displayed for the calendar, ranging from one minute per row to sixty minutes per row.
![](static/Screenshot452-Calendar_resolution.png) ![](img/Screenshot452-Calendar_resolution.png)
Adding a show Adding a show
------------- -------------
@ -16,14 +16,14 @@ What
In the **What** box, enter the **Name**, public website **URL**, **Genre** and **Description** for the show that you are creating. In the **What** box, enter the **Name**, public website **URL**, **Genre** and **Description** for the show that you are creating.
![](static/Screenshot453-Show_what.png) ![](img/Screenshot453-Show_what.png)
Autoloading Playlist Autoloading Playlist
------------------ ------------------
In this section, you can select a playlist that will be used for this show. The playlist must already be defined in your library. **Auto Schedule Playlist** needs to be checked for **Select Playlist** and **Repeat AutoPlaylist Until Show is Full** to be visible. In this section, you can select a playlist that will be used for this show. The playlist must already be defined in your library. **Auto Schedule Playlist** needs to be checked for **Select Playlist** and **Repeat AutoPlaylist Until Show is Full** to be visible.
![](static/Screenshot454-Show_playlist.png) ![](img/Screenshot454-Show_playlist.png)
When When
---- ----
@ -32,23 +32,23 @@ Next, in the **When** section, if you clicked on a date in the **Calendar** this
By default, the **Timezone** of the show start and end times will be the timezone of the station, as set on the Preferences page on the System menu. You can specify an alternative time zone using the drop-down menu, if you wish. The time zone displayed in the Calendar when you log in depends on your personal settings. See 'Updating your own account' in the chapter *Users* for more details. By default, the **Timezone** of the show start and end times will be the timezone of the station, as set on the Preferences page on the System menu. You can specify an alternative time zone using the drop-down menu, if you wish. The time zone displayed in the Calendar when you log in depends on your personal settings. See 'Updating your own account' in the chapter *Users* for more details.
![](static/Screenshot526-Add_show_when_250.png) ![](img/Screenshot526-Add_show_when_250.png)
LibreTime will only allow you to enter valid times for shows. If you attempt to schedule show times which would be impossible, by ending the show before it begins, LibreTime will highlight the error with a pink background. LibreTime will only allow you to enter valid times for shows. If you attempt to schedule show times which would be impossible, by ending the show before it begins, LibreTime will highlight the error with a pink background.
![](static/Screenshot527-negative_time250.png) ![](img/Screenshot527-negative_time250.png)
To schedule a regular show, check the **Repeats?** box, which will make a new section of the dialog appear. Optionally, click the **Link:** box to automatically schedule the same content in the repeated shows as in the original show. To schedule a regular show, check the **Repeats?** box, which will make a new section of the dialog appear. Optionally, click the **Link:** box to automatically schedule the same content in the repeated shows as in the original show.
![](static/Screenshot528-Link_shows_250.png) ![](img/Screenshot528-Link_shows_250.png)
Then select either **weekly**, **every 2 weeks**, **every 3 weeks**, **every 4 weeks** or **monthly** from the **Repeat Type** drop-down menu. If you have selected a weekly option, check the boxes for the days of the week that you want to schedule the regular show on. If you have selected **monthly**, you have the option to **Repeat By: day of the month** (for example the 9th of each month) or **day of the week** (for example the second Wednesday of each month). Then select either **weekly**, **every 2 weeks**, **every 3 weeks**, **every 4 weeks** or **monthly** from the **Repeat Type** drop-down menu. If you have selected a weekly option, check the boxes for the days of the week that you want to schedule the regular show on. If you have selected **monthly**, you have the option to **Repeat By: day of the month** (for example the 9th of each month) or **day of the week** (for example the second Wednesday of each month).
![](static/Screenshot529-repeat_type_monthly_250.png) ![](img/Screenshot529-repeat_type_monthly_250.png)
Uncheck the **No End?** box and set the **Date End** for the regular show to finish, or leave the **No End?** box checked to schedule the show indefinitely. Uncheck the **No End?** box and set the **Date End** for the regular show to finish, or leave the **No End?** box checked to schedule the show indefinitely.
![](static/Screenshot530-show_end_date_250.png) ![](img/Screenshot530-show_end_date_250.png)
Live Stream Input Live Stream Input
----------------- -----------------
@ -57,7 +57,7 @@ The **Live Stream Input** section can be used to enable live input streams durin
If you check the **Use Custom Authentication** box instead, you can set a one-time username and password pair for live stream input to the show. For example, you may wish to create an authenticated live stream input for a particular remote news reporter, without providing any further access to your LibreTime server for that person. If you check the **Use Custom Authentication** box instead, you can set a one-time username and password pair for live stream input to the show. For example, you may wish to create an authenticated live stream input for a particular remote news reporter, without providing any further access to your LibreTime server for that person.
![](static/Screenshot457-Live_stream_input.png) ![](img/Screenshot457-Live_stream_input.png)
A reminder of the connection **Host**, **Port** and **Mount** for the live input stream to use is shown at the end of the **Live Stream Input** section. A reminder of the connection **Host**, **Port** and **Mount** for the live input stream to use is shown at the end of the **Live Stream Input** section.
@ -71,18 +71,18 @@ Who
In the **Who** section, type the first few letters of the name of the show's DJ (presenter) in the **Search Users** field to select a name from the LibreTime database, or check one of the **DJs** boxes in the vertical list below. This association of a DJ name with a particular show enables that presenter to add playout media to the show, and also to connect a live Show Source input stream (if that has been enabled), so it is important to get the DJ's name right. In the **Who** section, type the first few letters of the name of the show's DJ (presenter) in the **Search Users** field to select a name from the LibreTime database, or check one of the **DJs** boxes in the vertical list below. This association of a DJ name with a particular show enables that presenter to add playout media to the show, and also to connect a live Show Source input stream (if that has been enabled), so it is important to get the DJ's name right.
![](static/Screenshot161-Show_users.png) ![](img/Screenshot161-Show_users.png)
Style Style
----- -----
Show colours in the Calendar are set automatically, based on the **Name** of the show, so that individual shows can be easily identified in the **Calendar**. If you wish, you can select a **Background Colour** and **Text Colour** manually by clicking the boxes in the **Style** section. Click the coloured circle icon in the lower right corner to close this pop-up window. Show colours in the Calendar are set automatically, based on the **Name** of the show, so that individual shows can be easily identified in the **Calendar**. If you wish, you can select a **Background Colour** and **Text Colour** manually by clicking the boxes in the **Style** section. Click the coloured circle icon in the lower right corner to close this pop-up window.
![](static/Screenshot162-Show_colours.png)  ![](img/Screenshot162-Show_colours.png) 
Optionally, you can upload a Show Logo by clicking the **Browse** button. Optionally, you can upload a Show Logo by clicking the **Browse** button.
![](static/Screenshot584-Show_logo.png) ![](img/Screenshot584-Show_logo.png)
Finally, click the **Add this show** button at the top or bottom of the box. The new show will now be displayed in the **Calendar**, with a regular slot if you have chosen to schedule one.  Finally, click the **Add this show** button at the top or bottom of the box. The new show will now be displayed in the **Calendar**, with a regular slot if you have chosen to schedule one. 
@ -91,11 +91,11 @@ Editing a show
Show configuration and metadata can be changed at any time, except for **Date/Time Start** and **Record from Line In?** options, which are fixed after broadcast of that show commences. Click the show in the Calendar, and select **Edit Show** from the pop-up context menu. This opens the **Update Show** box, which is almost exactly the same as the **Add this Show** box. Click the **+ Update show** button at the top or bottom of the box when you are done. Show configuration and metadata can be changed at any time, except for **Date/Time Start** and **Record from Line In?** options, which are fixed after broadcast of that show commences. Click the show in the Calendar, and select **Edit Show** from the pop-up context menu. This opens the **Update Show** box, which is almost exactly the same as the **Add this Show** box. Click the **+ Update show** button at the top or bottom of the box when you are done.
![](static/Screenshot459-Update_show.png) ![](img/Screenshot459-Update_show.png)
Episodes of repeating shows also have an **Instance Description** field in which you can add details for that particular episode. Click the episode in the Calendar, click **Edit** on the pop-up menu, then click **Edit this instance**. After entering an Instance Description, click the **+ Update show** button. Episodes of repeating shows also have an **Instance Description** field in which you can add details for that particular episode. Click the episode in the Calendar, click **Edit** on the pop-up menu, then click **Edit this instance**. After entering an Instance Description, click the **+ Update show** button.
![](static/Screenshot583-Show_instance_description_vC9ooiT.png) ![](img/Screenshot583-Show_instance_description_vC9ooiT.png)
Alternatively, individual shows can be clicked on and dragged to new days and times in the calendar. However, LibreTime will not allow you to drag a future show into the past, or drag and drop instances of a repeated show. In the **Day** and **Week** views, show length can be adjusted by clicking on the lower edge of the show box, and dragging the edge of the box upwards or downwards. The new show length is calculated automatically. Alternatively, individual shows can be clicked on and dragged to new days and times in the calendar. However, LibreTime will not allow you to drag a future show into the past, or drag and drop instances of a repeated show. In the **Day** and **Week** views, show length can be adjusted by clicking on the lower edge of the show box, and dragging the edge of the box upwards or downwards. The new show length is calculated automatically.
@ -104,17 +104,17 @@ Adding content to a show
To add content to a show, click the show in any view on the Calendar, and select **Schedule Tracks** from the pop-up menu. Shows that do not yet contain any scheduled content are marked with a red exclamation mark icon, to the right of the show start and end times in the top bar. Shows partially filled with content have a yellow exclamation mark icon. During playout of the show, a green play icon will also be shown in the top bar. To add content to a show, click the show in any view on the Calendar, and select **Schedule Tracks** from the pop-up menu. Shows that do not yet contain any scheduled content are marked with a red exclamation mark icon, to the right of the show start and end times in the top bar. Shows partially filled with content have a yellow exclamation mark icon. During playout of the show, a green play icon will also be shown in the top bar.
![](static/Screenshot488-Add_remove_content.png) ![](img/Screenshot488-Add_remove_content.png)
The **Schedule Tracks** action opens a window with the name of the show. Like when using the **Now Playing** page, you can search for content items and add them to the show schedule on the right side of the page. Refer to the *Now Playing* chapter for details. The **Schedule Tracks** action opens a window with the name of the show. Like when using the **Now Playing** page, you can search for content items and add them to the show schedule on the right side of the page. Refer to the *Now Playing* chapter for details.
When your show has all the required content, click the **OK** button in the bottom right corner to close the window. Back in the **Calendar**, click the show and select **View** from the pop-up menu to view a list of content now included in the show. When your show has all the required content, click the **OK** button in the bottom right corner to close the window. Back in the **Calendar**, click the show and select **View** from the pop-up menu to view a list of content now included in the show.
![](static/Screenshot489-Show_Content.png) ![](img/Screenshot489-Show_Content.png)
The **Contents of Show** window is a read-only interface featuring an orange bar which indicates how much media has been added to the show. Click the **OK** button in the bottom right corner, or the white **x** icon in the top right corner, to close the window. The **Contents of Show** window is a read-only interface featuring an orange bar which indicates how much media has been added to the show. Click the **OK** button in the bottom right corner, or the white **x** icon in the top right corner, to close the window.
![](static/Screenshot353-Contents_of_show.png) ![](img/Screenshot353-Contents_of_show.png)
Removing content from a show Removing content from a show
---------------------------- ----------------------------
@ -126,7 +126,7 @@ Deleting a forthcoming show
To delete one forthcoming instance of a repeating show, click on the show in the **Calendar**, and select **Delete**, then **Delete Instance** from the pop-up menu. If you wish to delete all future instances of a repeating show, select **Delete Instance and All Following** from the pop-up menu. To delete one forthcoming instance of a repeating show, click on the show in the **Calendar**, and select **Delete**, then **Delete Instance** from the pop-up menu. If you wish to delete all future instances of a repeating show, select **Delete Instance and All Following** from the pop-up menu.
![](static/Screenshot490-Delete_this_instance.png) ![](img/Screenshot490-Delete_this_instance.png)
You cannot delete or remove content from shows that have already played out. These shows have only one option on the pop-up menu, which is **View**. You cannot delete or remove content from shows that have already played out. These shows have only one option on the pop-up menu, which is **View**.
@ -135,5 +135,5 @@ Cancelling playout
If you wish to cancel playout of a show while it is running, click on the show in the **Calendar** and select **Cancel Show** from the pop-up menu. LibreTime will ask you if you are sure about this action, as it cannot be undone. If you wish to cancel playout of a show while it is running, click on the show in the **Calendar** and select **Cancel Show** from the pop-up menu. LibreTime will ask you if you are sure about this action, as it cannot be undone.
![](static/Screenshot357-Cancel_current_show.png) ![](img/Screenshot357-Cancel_current_show.png)

View file

@ -15,12 +15,12 @@ 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 time range, then click the **Find Shows** button (with the magnifying glass
icon) to the right. icon) to the right.
![](static/now-playing.png) ![](img/now-playing.png)
To display the content of a particular show, click **Filter by Show** and select 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. the name of the show from the drop-down menu which will appear.
![](static/filter.png) ![](img/filter.png)
On the left side of the page, the **Start** and **End** times, **Duration** 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**, and **Title** of each content item are shown. On the right, **Creator**,
@ -34,7 +34,7 @@ item at the same time of day.
Click the **Show/hide columns** button on the right to configure the metadata Click the **Show/hide columns** button on the right to configure the metadata
displayed, by checking the boxes in the pop-up window. displayed, by checking the boxes in the pop-up window.
![](static/columns.png) ![](img/columns.png)
The row for the currently playing item is displayed with a bright green The row for the currently playing item is displayed with a bright green
background. Any underbooked shows (shows with insufficient content to fill the background. Any underbooked shows (shows with insufficient content to fill the
@ -42,7 +42,7 @@ 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 in minutes and seconds. These rows contain a red exclamation mark in the first
column, and have a pink background. column, and have a pink background.
![](static/end-gap.png) ![](img/end-gap.png)
Removing content from a running show Removing content from a running show
------------------------------------ ------------------------------------
@ -60,7 +60,7 @@ 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 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. enough items remaining in the show to avoid dead air.
![](static/delete-extra.png) ![](img/delete-extra.png)
If you have a long schedule displayed, and you wish to skip to the currently 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 playing item, click the button with the end arrow icon, to the right of the
@ -70,7 +70,7 @@ 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 A pop-up window will ask you to confirm the cancellation, as this action cannot
be undone. be undone.
![](static/cancel-show.png) ![](img/cancel-show.png)
Items which are no longer available have an exclamation mark icon in the second 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 column. This may happen for media files which were part of previous shows, and
@ -92,7 +92,7 @@ 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 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. not wish to cut off a studio discussion in order to play music at a fixed time.
![](static/drag-and-drop.png) ![](img/drag-and-drop.png)
You can also select multiple items using the **Select** menu button, just 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** beneath the simple search field, which has the options to **Select this page**

View file

@ -7,7 +7,7 @@ Example code
You can download the example code for this chapter from: You can download the example code for this chapter from:
[http://sourcefabric.booktype.pro/airtime-25-for-broadcasters/help/static/jPlayer\_demo4.zip](../help/static/jPlayer_demo4.zip "jPlayer demo files") [http://sourcefabric.booktype.pro/airtime-25-for-broadcasters/help/img/jPlayer\_demo4.zip](../help/img/jPlayer_demo4.zip "jPlayer demo files")
Unzip this file on your computer, and then open the file *jplayer-demo.html* in your editor: Unzip this file on your computer, and then open the file *jplayer-demo.html* in your editor:
@ -63,6 +63,6 @@ A stop button or progress bar is not useful when we are streaming continuously f
When you open the HTML file *jplayer-demo.html* in a web browser, your player should appear as follows: When you open the HTML file *jplayer-demo.html* in a web browser, your player should appear as follows:
![](static/Screenshot525-jplayer-demo_240.png) ![](img/Screenshot525-jplayer-demo_240.png)
The original version of this demo code and skin are available from <http://jplayer.org/download/> for further experimentation. The original version of this demo code and skin are available from <http://jplayer.org/download/> for further experimentation.

View file

@ -128,7 +128,7 @@ In this case, the metadata returned would be in a different format from the abov
If you see the message *You are not allowed to access this resource* when attempting to display schedule information in your web browser, log in to the LibreTime administration interface, click *System* in the main menu, then *Preferences*. Set **Allow Remote Websites To Access "Schedule" Info?** to **Enabled**, click the **Save** button, then refresh the browser window opened on the schedule export URL. If you do not wish to make schedule information available to the public, set this option to **Disabled** instead. If you see the message *You are not allowed to access this resource* when attempting to display schedule information in your web browser, log in to the LibreTime administration interface, click *System* in the main menu, then *Preferences*. Set **Allow Remote Websites To Access "Schedule" Info?** to **Enabled**, click the **Save** button, then refresh the browser window opened on the schedule export URL. If you do not wish to make schedule information available to the public, set this option to **Disabled** instead.
![](static/Screenshot497-System_preferences_240.png) ![](img/Screenshot497-System_preferences_240.png)
Caching schedule information Caching schedule information
---------------------------- ----------------------------

View file

@ -7,7 +7,7 @@ features are coupled with a collaborative on-line scheduling calendar and
playlist management. The scheduling calendar is managed through an easy-to-use playlist management. The scheduling calendar is managed through an easy-to-use
interface and triggers playout with sub-second precision. interface and triggers playout with sub-second precision.
![](static/Screenshot540-Now_playing_250.png) ![](img/Screenshot540-Now_playing_250.png)
LibreTime has been intended to provide a solution for a wide range of broadcast LibreTime has been intended to provide a solution for a wide range of broadcast
projects, from community to public and commercial stations. The scalability of projects, from community to public and commercial stations. The scalability of
@ -91,7 +91,7 @@ because it is also connected to the Internet for remote access by media
contributors. This enables LibreTime to offer password-protected access to the contributors. This enables LibreTime to offer password-protected access to the
media library and scheduling from both inside and outside the studio building. media library and scheduling from both inside and outside the studio building.
![](static/libretime_architecture.svg) ![](img/libretime_architecture.svg)
Example web broadcast system Example web broadcast system
---------------------------- ----------------------------
@ -101,4 +101,4 @@ soundcard. There does not need to be a centralised studio, although LibreTime
can enable remote studios to stream in to Liquidsoap at authorised times. can enable remote studios to stream in to Liquidsoap at authorised times.
Optionally, the outgoing Icecast stream can be relayed to a transmitter. Optionally, the outgoing Icecast stream can be relayed to a transmitter.
![](static/libretime_web_architecture.svg) ![](img/libretime_web_architecture.svg)

View file

@ -1,13 +1,13 @@
# Settings # Settings
![](static/station-info-settings.png) ![](img/station-info-settings.png)
On the **Settings** menu, click **General** to set your **Station Name**. This On the **Settings** menu, click **General** to set your **Station Name**. This
text is shown in your web browser's title bar when your station staff are logged text is shown in your web browser's title bar when your station staff are logged
into LibreTime, and optionally in stream metadata. You can also set a **Station into LibreTime, and optionally in stream metadata. You can also set a **Station
Description** and **Station Logo** here. Description** and **Station Logo** here.
![](static/general-playback-settings.png) ![](img/general-playback-settings.png)
The **Default Interface Language** drop-down menu sets the default localization The **Default Interface Language** drop-down menu sets the default localization
for your LibreTime instance, and the **Station Timezone** drop-down menu can be for your LibreTime instance, and the **Station Timezone** drop-down menu can be
@ -43,7 +43,7 @@ podcast to LibreTime. This can also be done manually by the generate smartblock
and playlist button under a podcasts settings which is why it is disabled by and playlist button under a podcasts settings which is why it is disabled by
default. default.
![](static/api-settings.png) ![](img/api-settings.png)
You can enable live, read-only access to the LibreTime schedule calendar for You can enable live, read-only access to the LibreTime schedule calendar for
your station's public website with the **Public LibreTime API** option, if you your station's public website with the **Public LibreTime API** option, if you
@ -64,7 +64,7 @@ The **Tune-In Settings** section is intended for stations that have partnered
with TuneIn to automatically push their now playing metadata to TuneIn. This with TuneIn to automatically push their now playing metadata to TuneIn. This
hasn't been tested and also requires special credentials from TuneIn. hasn't been tested and also requires special credentials from TuneIn.
![](static/dangerous-options.png) ![](img/dangerous-options.png)
The **Dangerous Options** section provides an administrator the ability to erase The **Dangerous Options** section provides an administrator the ability to erase
the entire LibreTime library. the entire LibreTime library.
@ -72,10 +72,10 @@ the entire LibreTime library.
When you are done remember click the **Save** button at the top or bottom of the When you are done remember click the **Save** button at the top or bottom of the
form. form.
![](static/save-button.png) ![](img/save-button.png)
Individual LibreTime users can choose another interface localization when they Individual LibreTime users can choose another interface localization when they
log in, or set personal preferences for localization and time zone by clicking log in, or set personal preferences for localization and time zone by clicking
their username on the right side of the menu bar. their username on the right side of the menu bar.
![](static/Screenshot475-Edit_own_user_account.png) ![](img/Screenshot475-Edit_own_user_account.png)

View file

@ -15,7 +15,7 @@ You can log in for the first time with the user name *admin* and the password
*admin*. Your browser should automatically focus on the *admin*. Your browser should automatically focus on the
**Username** field. **Username** field.
![](../on-air-in-60-seconds/static/Screenshot559-Log_in.png) ![](../on-air-in-60-seconds/img/Screenshot559-Log_in.png)
You will see a link **Reset password** below the password field, which enables You will see a link **Reset password** below the password field, which enables
users to obtain a password reminder by email. You will need to have a users to obtain a password reminder by email. You will need to have a
@ -23,12 +23,12 @@ mailserver configured to work with PHP for this to work. There is an issue open
to add documentation for this to add documentation for this
([#724](https://github.com/LibreTime/libretime/issues/724)). ([#724](https://github.com/LibreTime/libretime/issues/724)).
![](static/Screenshot467-Reset_password_link.png)  ![](img/Screenshot467-Reset_password_link.png) 
The **E-mail** address you enter must match the address stored in the database The **E-mail** address you enter must match the address stored in the database
for your **Username**. for your **Username**.
![](static/Screenshot468-Restore_password.png) ![](img/Screenshot468-Restore_password.png)
The Master Panel The Master Panel
@ -41,12 +41,12 @@ bar and time elapsed/time remaining), and the details of the **Next** file due
to play. It also displays the name and scheduled time of the current show, with to play. It also displays the name and scheduled time of the current show, with
a blue progress bar. a blue progress bar.
![](static/Screenshot-MasterPanel.png) ![](img/Screenshot-MasterPanel.png)
Beneath this side of the Master Panel is the main navigation menu. We'll be Beneath this side of the Master Panel is the main navigation menu. We'll be
looking at the contents of these menus in the following chapters of this book. looking at the contents of these menus in the following chapters of this book.
![](static/Screenshot-MainMenu.png) ![](img/Screenshot-MainMenu.png)
On the right hand side of the Master Panel are the switches for the **Source On the right hand side of the Master Panel are the switches for the **Source
Streams**, which enable you to switch from scheduled play to remote live Streams**, which enable you to switch from scheduled play to remote live
@ -60,13 +60,13 @@ There is also a clock indicating the **Station time** and time zone. Beneath
the clock and just to the left, the name of the user currently logged in is the clock and just to the left, the name of the user currently logged in is
displayed, and there is the link for you to **Logout**.  displayed, and there is the link for you to **Logout**. 
![](static/Screenshot469-On_Air_light.png) ![](img/Screenshot469-On_Air_light.png)
Clicking the username link opens a page in which you can update your LibreTime Clicking the username link opens a page in which you can update your LibreTime
password, contact details, language and time zone preferences. Click the password, contact details, language and time zone preferences. Click the
**Save** button once you have made the changes that you require. **Save** button once you have made the changes that you require.
![](static/Screenshot470-User_settings.png) ![](img/Screenshot470-User_settings.png)
Checking an Icecast server Checking an Icecast server
-------------------------- --------------------------
@ -85,4 +85,4 @@ You should see the Icecast status page, with details of any connections that
your LibreTime server has made to this Icecast server. If you have only just your LibreTime server has made to this Icecast server. If you have only just
installed LibreTime, there may not be any media playing out yet. installed LibreTime, there may not be any media playing out yet.
![](static/Screenshot293-Icecast_status_page.png) ![](img/Screenshot293-Icecast_status_page.png)

View file

@ -2,7 +2,7 @@ The first entry on LibreTime's **Help** menu offers a **Getting Started** guide
for new users. Further down, there is also a link to the online version of this for new users. Further down, there is also a link to the online version of this
**User Manual**. **User Manual**.
![](static/Screenshot460-Help_page.png) ![](img/Screenshot460-Help_page.png)
You can visit the LibreTime online support forum at You can visit the LibreTime online support forum at
<https://discourse.libretime.org/c/get-help> to ask for help from the community <https://discourse.libretime.org/c/get-help> to ask for help from the community
@ -23,7 +23,7 @@ improvements and new features for LibreTime on that site.
Other help Other help
---------- ----------
The UNESCO publication [*Community Radio - A user's guide to the technology*](static/CommunityRadioUserGuide.pdf) The UNESCO publication [*Community Radio - A user's guide to the technology*](img/CommunityRadioUserGuide.pdf)
features a very comprehensive guide to setting up a community radio station. features a very comprehensive guide to setting up a community radio station.
This guide is aimed at people thinking about setting up a radio station in This guide is aimed at people thinking about setting up a radio station in
India, but includes lots of practical advice that would be useful in any India, but includes lots of practical advice that would be useful in any

View file

@ -9,22 +9,22 @@ This page has three tabs: **Log Sheet**, **File Summary** and **Show Summary**.
In the **Log Sheet** tab, the playout history is sorted by **Start Time** and **End Time** by default. In the **Log Sheet** tab, the playout history is sorted by **Start Time** and **End Time** by default.
<img src="static/Screenshot533-Playout_history_250.png" width="595" height="385" /> <img src="img/Screenshot533-Playout_history_250.png" width="595" height="385" />
The number of times each file was played and the length of the files are shown in the **File Summary** tab. To make optimal use of this feature for royalty reporting purposes, music files must be tagged with **Composer** and **Copyright** metadata. The artist performing a piece of music may not be the original composer of the work, or the copyright holder of the sound recording. The number of times each file was played and the length of the files are shown in the **File Summary** tab. To make optimal use of this feature for royalty reporting purposes, music files must be tagged with **Composer** and **Copyright** metadata. The artist performing a piece of music may not be the original composer of the work, or the copyright holder of the sound recording.
<img src="static/Screenshot534-File_summary_250.png" width="595" height="415" /> <img src="img/Screenshot534-File_summary_250.png" width="595" height="415" />
On the **Show Summary** tab, click the name of a show within the search range to expand its row and see its playout details. On the **Show Summary** tab, click the name of a show within the search range to expand its row and see its playout details.
<img src="static/Screenshot535-Show_summary_250.png" width="595" height="480" /> <img src="img/Screenshot535-Show_summary_250.png" width="595" height="480" />
Manual logging Manual logging
-------------- --------------
If your station features playout from analogue sources such as turntables or microphones, there is no automatic metadata for LibreTime to collect from these inputs. To ensure that the playout history is complete, you can add log entries manually by clicking the **+ Create Entry** button. This action opens a pop-up window with default fields of Start Time, End Time, Title and Creator. Click the **Find** button to automatically fill the **Choose Show Instance** menu with the names of shows that took place within the specified time range. Then click the **Save** button to enter the new item into the playout history. If your station features playout from analogue sources such as turntables or microphones, there is no automatic metadata for LibreTime to collect from these inputs. To ensure that the playout history is complete, you can add log entries manually by clicking the **+ Create Entry** button. This action opens a pop-up window with default fields of Start Time, End Time, Title and Creator. Click the **Find** button to automatically fill the **Choose Show Instance** menu with the names of shows that took place within the specified time range. Then click the **Save** button to enter the new item into the playout history.
<img src="static/Screenshot536-Manual_login_250.png" width="530" height="575" /> <img src="img/Screenshot536-Manual_login_250.png" width="530" height="575" />
Log entries can also be manually deleted, using the button with the trashcan icon, to the right of the **+ Create Entry** button. Pages of entries can be selected for deletion using the **Select** drop-down menu. Log entries can also be manually deleted, using the button with the trashcan icon, to the right of the **+ Create Entry** button. Pages of entries can be selected for deletion using the **Select** drop-down menu.
@ -33,11 +33,11 @@ History Templates
The **History Templates** page on the History menu enables you to prepare reports with the exact content required by regulatory agencies in the territories that you are broadcasting to. You can begin creating a custom template by clicking the button **New Log Sheet Template** or the button **New File Summary Template**. The **History Templates** page on the History menu enables you to prepare reports with the exact content required by regulatory agencies in the territories that you are broadcasting to. You can begin creating a custom template by clicking the button **New Log Sheet Template** or the button **New File Summary Template**.
<img src="static/Screenshot537-History_templates.png" width="221" height="277" /> <img src="img/Screenshot537-History_templates.png" width="221" height="277" />
Either of these actions opens a page in which you can name the new template, and add or remove elements from the list on the left. To add a new element from the list on the right, click the plus icon for the item you require. If the element you require is not listed, you can use the **Add New Field** box at the lower end of the right side column. Select *string*, *boolean*, *integer*, or *float*, depending on the type of data that you wish to log, and then click the **+ Add** button. Either of these actions opens a page in which you can name the new template, and add or remove elements from the list on the left. To add a new element from the list on the right, click the plus icon for the item you require. If the element you require is not listed, you can use the **Add New Field** box at the lower end of the right side column. Select *string*, *boolean*, *integer*, or *float*, depending on the type of data that you wish to log, and then click the **+ Add** button.
<img src="static/Screenshot538-Log_sheet_template_250.png" width="595" height="517" /> <img src="img/Screenshot538-Log_sheet_template_250.png" width="595" height="517" />
When the template is in the format you require, click the **Save** button, and **Set Default Template** if you wish. The new template will now be listed on the History Templates page. If you have set a new default template, any changes will be visible on the tabs of the Playout History page. When the template is in the format you require, click the **Save** button, and **Set Default Template** if you wish. The new template will now be listed on the History Templates page. If you have set a new default template, any changes will be visible on the tabs of the Playout History page.

View file

@ -40,6 +40,6 @@ Connect the other source to the Icecast server with the same parameters defined
To configure **Mixxx** for streaming to Icecast, click *Options*, *Preferences*, then *Live Broadcasting*. For server *Type*, select the default of *Icecast 2* when streaming to Debian or Ubuntu servers, as this is the current version of Icecast supplied with those GNU/Linux distributions. To configure **Mixxx** for streaming to Icecast, click *Options*, *Preferences*, then *Live Broadcasting*. For server *Type*, select the default of *Icecast 2* when streaming to Debian or Ubuntu servers, as this is the current version of Icecast supplied with those GNU/Linux distributions.
![](static/Screenshot123-Mixxx_Preferences.png)  ![](img/Screenshot123-Mixxx_Preferences.png) 
By default, Icecast streams are buffered to guard against network problems, which causes latency for remote listeners. When monitoring the stream from a remote location, you may have to begin the live stream a few seconds before the previous stream ends to enable a smooth transition. By default, Icecast streams are buffered to guard against network problems, which causes latency for remote listeners. When monitoring the stream from a remote location, you may have to begin the live stream a few seconds before the previous stream ends to enable a smooth transition.

View file

@ -13,7 +13,7 @@ UTF-8 metadata in Icecast MP3 streams
When sending metadata about your stream to an Icecast server in non-Latin alphabets, you may find that Icecast does not display the characters correctly for an MP3 stream, even though they are displayed correctly for an Ogg Vorbis stream. In the following screenshot, Russian characters are being displayed incorrectly in the *Current Song* field for the MP3 stream: When sending metadata about your stream to an Icecast server in non-Latin alphabets, you may find that Icecast does not display the characters correctly for an MP3 stream, even though they are displayed correctly for an Ogg Vorbis stream. In the following screenshot, Russian characters are being displayed incorrectly in the *Current Song* field for the MP3 stream:
![](static/Screenshot223-Icecast_UTF-8_metadata.png) ![](img/Screenshot223-Icecast_UTF-8_metadata.png)
The solution is to specify that the metadata for the MP3 mount point you are using should be interpreted using UTF-8 encoding. You can do this by adding the following stanza to the */etc/icecast2/icecast.xml* file, where *libretime.mp3* is the name of your mount point: The solution is to specify that the metadata for the MP3 mount point you are using should be interpreted using UTF-8 encoding. You can do this by adding the following stanza to the */etc/icecast2/icecast.xml* file, where *libretime.mp3* is the name of your mount point:

View file

Before

Width:  |  Height:  |  Size: 242 KiB

After

Width:  |  Height:  |  Size: 242 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 544 KiB

After

Width:  |  Height:  |  Size: 544 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 560 KiB

After

Width:  |  Height:  |  Size: 560 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 282 KiB

After

Width:  |  Height:  |  Size: 282 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 337 KiB

After

Width:  |  Height:  |  Size: 337 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 317 KiB

After

Width:  |  Height:  |  Size: 317 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 39 KiB

After

Width:  |  Height:  |  Size: 39 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 6.5 KiB

After

Width:  |  Height:  |  Size: 6.5 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 64 KiB

After

Width:  |  Height:  |  Size: 64 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 74 KiB

After

Width:  |  Height:  |  Size: 74 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 80 KiB

After

Width:  |  Height:  |  Size: 80 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 160 KiB

After

Width:  |  Height:  |  Size: 160 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 6.2 KiB

After

Width:  |  Height:  |  Size: 6.2 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 14 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 38 KiB

After

Width:  |  Height:  |  Size: 38 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 57 KiB

After

Width:  |  Height:  |  Size: 57 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 34 KiB

After

Width:  |  Height:  |  Size: 34 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 12 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 34 KiB

After

Width:  |  Height:  |  Size: 34 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 44 KiB

After

Width:  |  Height:  |  Size: 44 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 226 KiB

After

Width:  |  Height:  |  Size: 226 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 101 KiB

After

Width:  |  Height:  |  Size: 101 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 85 KiB

After

Width:  |  Height:  |  Size: 85 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 15 KiB

After

Width:  |  Height:  |  Size: 15 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 17 KiB

After

Width:  |  Height:  |  Size: 17 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 6.8 KiB

After

Width:  |  Height:  |  Size: 6.8 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 5.4 KiB

After

Width:  |  Height:  |  Size: 5.4 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 5.8 KiB

After

Width:  |  Height:  |  Size: 5.8 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 9.5 KiB

After

Width:  |  Height:  |  Size: 9.5 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 27 KiB

After

Width:  |  Height:  |  Size: 27 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 108 KiB

After

Width:  |  Height:  |  Size: 108 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 56 KiB

After

Width:  |  Height:  |  Size: 56 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 74 KiB

After

Width:  |  Height:  |  Size: 74 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 75 KiB

After

Width:  |  Height:  |  Size: 75 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 11 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 4.4 KiB

After

Width:  |  Height:  |  Size: 4.4 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 31 KiB

After

Width:  |  Height:  |  Size: 31 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 48 KiB

After

Width:  |  Height:  |  Size: 48 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 49 KiB

After

Width:  |  Height:  |  Size: 49 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 45 KiB

After

Width:  |  Height:  |  Size: 45 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 49 KiB

After

Width:  |  Height:  |  Size: 49 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 37 KiB

After

Width:  |  Height:  |  Size: 37 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 38 KiB

After

Width:  |  Height:  |  Size: 38 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 25 KiB

After

Width:  |  Height:  |  Size: 25 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 18 KiB

After

Width:  |  Height:  |  Size: 18 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 27 KiB

After

Width:  |  Height:  |  Size: 27 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 28 KiB

After

Width:  |  Height:  |  Size: 28 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 6.8 KiB

After

Width:  |  Height:  |  Size: 6.8 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 15 KiB

After

Width:  |  Height:  |  Size: 15 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 10 KiB

After

Width:  |  Height:  |  Size: 10 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 17 KiB

After

Width:  |  Height:  |  Size: 17 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 14 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 67 KiB

After

Width:  |  Height:  |  Size: 67 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 41 KiB

After

Width:  |  Height:  |  Size: 41 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 40 KiB

After

Width:  |  Height:  |  Size: 40 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 15 KiB

After

Width:  |  Height:  |  Size: 15 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 24 KiB

After

Width:  |  Height:  |  Size: 24 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 15 KiB

After

Width:  |  Height:  |  Size: 15 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 35 KiB

After

Width:  |  Height:  |  Size: 35 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 29 KiB

After

Width:  |  Height:  |  Size: 29 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 31 KiB

After

Width:  |  Height:  |  Size: 31 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 7.3 KiB

After

Width:  |  Height:  |  Size: 7.3 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 22 KiB

After

Width:  |  Height:  |  Size: 22 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 29 KiB

After

Width:  |  Height:  |  Size: 29 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 46 KiB

After

Width:  |  Height:  |  Size: 46 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 13 KiB

After

Width:  |  Height:  |  Size: 13 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 3.4 KiB

After

Width:  |  Height:  |  Size: 3.4 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 24 KiB

After

Width:  |  Height:  |  Size: 24 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 9.6 KiB

After

Width:  |  Height:  |  Size: 9.6 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 9.3 KiB

After

Width:  |  Height:  |  Size: 9.3 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 14 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 57 KiB

After

Width:  |  Height:  |  Size: 57 KiB

Before After
Before After

Some files were not shown because too many files have changed in this diff Show more