docs: rework docs into the new website
- multipass docs moved to local-dev.md - add documentation to website - rework fogotten files - disable fogotten files Co-authored-by: Zachary Klosko <zklosko@users.noreply.github.com>
This commit is contained in:
jo
Jonas L
parent
2fa10793ec
commit
6d9e7a6765
39 changed files with 698 additions and 721 deletions
4
docs/guides/_category_.json
Normal file
4
docs/guides/_category_.json
Normal file
|
|
@ -0,0 +1,4 @@
|
|||
{
|
||||
"label": "Guides",
|
||||
"position": 3
|
||||
}
|
||||
|
|
@ -1,26 +1,24 @@
|
|||
---
|
||||
layout: article
|
||||
title: Show Calendar
|
||||
category: interface
|
||||
---
|
||||
|
||||
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.
|
||||
|
||||
|
||||
|
||||
|
||||
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.
|
||||
|
||||
|
||||
|
||||
|
||||
### 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.
|
||||
|
||||
|
||||
|
||||
|
||||
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.
|
||||
|
||||
|
||||
|
||||
|
||||
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.
|
||||
|
||||
|
|
@ -28,17 +26,17 @@ Alternatively, individual shows can be clicked on and dragged to new days and ti
|
|||
|
||||
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.
|
||||
|
||||
|
||||
|
||||
|
||||
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.
|
||||
|
||||
|
||||
|
||||
|
||||
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.
|
||||
|
||||
|
||||
|
||||
|
||||
### Removing content from a show
|
||||
|
||||
|
|
@ -48,7 +46,7 @@ To remove an individual item from a show, click on the show in the **Calendar**,
|
|||
|
||||
To delete an upcoming 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.
|
||||
|
||||
|
||||
|
||||
|
||||
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**.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,10 +1,12 @@
|
|||
---
|
||||
layout: article
|
||||
title: Dashboard
|
||||
category: interface
|
||||
---
|
||||
|
||||
> Want to listen to Libretime's output stream? Click **Listen** below the **On Air** light.
|
||||
:::tip
|
||||
|
||||
Want to listen to Libretime's output stream? Click **Listen** below the **On Air** light.
|
||||
|
||||
:::
|
||||
|
||||
The Dashboard is divided into two sections a Library section divided between
|
||||
Tracks, Playlists, Smart Blocks, Webstreams, and Podcasts, with the **Scheduled
|
||||
|
|
@ -21,12 +23,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
|
||||
icon) to the right.
|
||||
|
||||
|
||||
|
||||
|
||||
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.
|
||||
|
||||
|
||||
|
||||
|
||||
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**,
|
||||
|
|
@ -40,7 +42,7 @@ 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.
|
||||
|
||||
|
||||
|
||||
|
||||
The row for the currently playing item is displayed with a bright green
|
||||
background. Any underbooked shows (shows with insufficient content to fill the
|
||||
|
|
@ -48,7 +50,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
|
||||
column, and have a pink background.
|
||||
|
||||
|
||||
|
||||
|
||||
### Removing content from a running show
|
||||
|
||||
|
|
@ -65,7 +67,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
|
||||
enough items remaining in the show to avoid dead air.
|
||||
|
||||
|
||||
|
||||
|
||||
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
|
||||
|
|
@ -94,7 +96,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
|
||||
not wish to cut off a studio discussion in order to play music at a fixed time.
|
||||
|
||||
|
||||
|
||||
|
||||
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**
|
||||
|
|
@ -117,7 +119,3 @@ There is no need to select or drag the item first.
|
|||
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.
|
||||
|
||||
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.
|
||||
|
|
|
|||
|
|
@ -1,12 +1,10 @@
|
|||
---
|
||||
title: Listener Statistics
|
||||
layout: article
|
||||
category: manager
|
||||
---
|
||||
|
||||
The Listener Stats page on the Analytics menu shows graphs of listener connections to the configured streaming servers for the selected date and time range. On the right side, a green **Status** indicator shows **OK** if the connection to the streaming server is active.
|
||||
|
||||
|
||||
|
||||
|
||||
If the status indicator is red, check that the **Admin User** and **Admin Password** settings are correct under **Additional Options** for the named mount point, such as _libretime_128_, on the **Streams** page of the **Settings** menu.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,11 +1,8 @@
|
|||
---
|
||||
layout: article
|
||||
title: Broadcasting live with MIXXX or B.U.T.T.
|
||||
git: live-broadcast.md
|
||||
category: interface
|
||||
title: Broadcasting live
|
||||
---
|
||||
|
||||
## Live shows with MIXXX {#mixxx}
|
||||
## MIXXX
|
||||
|
||||
[Mixxx](https://www.mixxx.org) is a cross-platform Open Source application for DJs.
|
||||
|
||||
|
|
@ -18,25 +15,22 @@ Mixxx supports a wide variety of popular hardware control surfaces, which can be
|
|||
computer using a USB cable. A control surface might replace or augment an analogue mixer in your studio,
|
||||
depending on your live mixing and playout requirements.
|
||||
|
||||
Mixxx 1.9.0 or later includes a live streaming client which, like LibreTime, is compatible with the **Icecast**
|
||||
and **SHOUTcast** media servers. This feature can also be used to stream from Mixxx directly into LibreTime,
|
||||
Mixxx 1.9.0 or later includes a live streaming client which, like LibreTime, is compatible with the Icecast
|
||||
and SHOUTcast media servers. This feature can also be used to stream from Mixxx directly into LibreTime,
|
||||
using either the **Show Source** or **Master Source**.
|
||||
|
||||
|
||||
|
||||
To configure **Mixxx** for streaming into LibreTime, click **Options**, **Preferences**, then
|
||||
To configure Mixxx for streaming into LibreTime, click **Options**, **Preferences**, then
|
||||
**Live Broadcasting** on the main Mixxx menu. For server **Type**, select the default of **Icecast 2**.
|
||||
For **Host**, **Mount**, **Port**, **Login** and **Password**, use the **Input Stream Settings**
|
||||
configured in the LibreTime **Streams** page, on LibreTime's **System** menu. See [stream settings](stream-settings)
|
||||
for remote input connection details.
|
||||
configured in the LibreTime **Streams** page, on LibreTime's **System** menu.
|
||||
|
||||
## Live shows with B.U.T.T. (Broadcast Using This Tool)
|
||||
## B.U.T.T. (Broadcast Using This Tool)
|
||||
|
||||
<html>
|
||||
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/4GLsU9hPTtM" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|
||||
</html>
|
||||
|
||||
**Setup**
|
||||
### Setup
|
||||
|
||||
1. Download and install [BUTT](https://danielnoethen.de/) for your OS.
|
||||
_Note: be sure you have butt version 0.1.17 or newer installed_
|
||||
|
|
@ -51,18 +45,14 @@ for remote input connection details.
|
|||
- Type **/show** under IceCast mountpoint:
|
||||
- Type your dj login under **IceCast user:**
|
||||
5. Click **ADD**
|
||||
6. Still in settings click, **Audio** and select your external sound card under
|
||||
**Audio Device** _Note: if you only have an internal sound card you maybe able
|
||||
to use it but that is OS specific and outside of this tutorial. We are assuming
|
||||
you have a mic and mixer or a USB mixer hooked up to or as an external soundcard_
|
||||
6. Still in settings click, **Audio** and select your audio input device under
|
||||
**Audio Device**
|
||||
|
||||
**Show Time**
|
||||
### Show Time
|
||||
|
||||
1. When its almost your show time go to your LibreTime page and look at the time
|
||||
in the top right when your show starts go to Butt.
|
||||
1. When its almost your show time go to your LibreTime page and look at the time in the top right when your show starts go to Butt.
|
||||
2. Click the white Play button (third button in the middle).
|
||||
3. If it says connecting... and then stream time with a counter- congratulations,
|
||||
your are connected!
|
||||
3. If it says connecting... and then stream time with a counter- congratulations, your are connected!
|
||||
4. Go to the LibreTime page and at the top right under Source Streams the
|
||||
tab besides Show Source is to the left and Orange - if it is and Current
|
||||
shows Live Show you are connected.
|
||||
|
|
@ -81,8 +71,3 @@ slot. If you choose to stop streaming before it is over click the white square
|
|||
**Stop** button to disconnect. Then go to the LibreTime page and if the Show
|
||||
Source didn't automatically disconnect you can click it to the right and it
|
||||
should turn gray.
|
||||
|
||||
You are now done streaming.
|
||||
|
||||
If you have issues connecting check with your system administrator to see if you
|
||||
have the details right.
|
||||
|
|
|
|||
|
|
@ -1,20 +1,12 @@
|
|||
---
|
||||
layout: article
|
||||
title: Playlists and Smartblocks
|
||||
category: interface
|
||||
---
|
||||
|
||||
> **About Autoloading Playlists**
|
||||
>
|
||||
> Libretime will schedule tracks from a selected playlist an hour before a show is
|
||||
> scheduled to air. This is a great way to automatically schedule weekly shows which are received
|
||||
> via. podcasts.
|
||||
|
||||
### Creating a new playlist
|
||||
## Creating a new playlist
|
||||
|
||||
You can create a new playlist on the toolbar of the **Playlists** page.
|
||||
|
||||
|
||||
|
||||
|
||||
Enter a **Name** and **Description** for the playlist, then click the **Save** button. Setting good quality metadata here will help you find the playlist using the search box later, so you should be as descriptive as possible.
|
||||
|
||||
|
|
@ -32,9 +24,13 @@ When your playlist is complete, click the **New** button in the top left corner
|
|||
|
||||
If you want to edit the playlist content or metadata later, you can find it by **Title**, **Creator**, **Last Modified** date, **Length**, **Owner** or **Year** using one of the search tools on the Library page. Click the playlist in the search results list, and then click **Edit** from the pop-up menu. You can also **Preview** the entire playlist in a pop-up audition window, **Duplicate** or **Delete** one of your playlists from this menu.
|
||||
|
||||
### Creating a Smartblock
|
||||
### Autoloading Playlists
|
||||
|
||||
|
||||
Libretime will schedule tracks from a selected playlist an hour before a show is scheduled to air. This is a great way to automatically schedule weekly shows which are received via. podcasts.
|
||||
|
||||
## Creating a Smartblock
|
||||
|
||||
|
||||
|
||||
Smart blocks are automatically filled with media files from the LibreTime library, according to the criteria that you specify. This feature is intended to save staff time, compared to selecting items for a playlist manually, and can be used to schedule shows that operate in a consistent format.
|
||||
|
||||
|
|
@ -44,20 +40,25 @@ Fill out the smart block's **Name**, **Search Criteria**, and **Limit to** secti
|
|||
|
||||
If you have a large number of files which meet the criteria that you specify, you may wish to limit the duration of the smart block using the **Limit to** field, so that it fits within the show you have in mind. Select **hours**, **minutes** or **items** from the drop-down menu, and click the **Generate** button again, if it is a static smart block. Then click the **Save** button.
|
||||
|
||||
> **Note:** Smart Blocks by default will not overflow the length of a scheduled show.
|
||||
> This is to prevent tracks from being cut-off because they exceed the time limit of a show.
|
||||
> If you want a smartblock to schedule tracks until it is longer than the Time Limit you can check **"Allow last track to exceed time limit"**
|
||||
> (helpful for avoiding dead air on autoscheduled shows).
|
||||
:::note
|
||||
|
||||
|
||||
Smart Blocks by default will not overflow the length of a scheduled show. This is to prevent tracks from being cut-off because they exceed the time limit of a show. If you want a smartblock to schedule tracks until it is longer than the Time Limit you can check **"Allow last track to exceed time limit"** (helpful for avoiding dead air on autoscheduled shows).
|
||||
|
||||
:::
|
||||
|
||||
|
||||
|
||||
You can also set the **smart block type**. A **Static** smart block will save the criteria and generate the block content immediately. This enables you to edit the contents of the block in the **Library** page before adding it to a show. A **Dynamic** smart block will only save the criteria, and the specific content will be generated at the time the block is added to a show. After that, the content of the show can be changed or re-ordered in the **Now Playing** page.
|
||||
|
||||
Click the **plus button** on the left to add OR criteria, such as **Creator** containing _beck_ OR _jimi_. To add AND criteria, such as **Creator** containing _jimi_ AND BPM in the range _120_ to _130_, click the **plus button** on the right. (The criteria are not case sensitive). Click **Preview** to see the results.
|
||||
|
||||
> If you see the message **0 files meet the criteria**, it might mean that the files in the Library have not been tagged with the correct metadata. See the chapter [Preparing media](/docs/preparing-media) for tips on tagging content.
|
||||
:::tip
|
||||
|
||||
|
||||
If you see the message **0 files meet the criteria**, it might mean that the files in the Library have not been tagged with the correct metadata. See the chapter [Preparing media](/docs/guides/preparing-media) for tips on tagging content.
|
||||
|
||||
:::
|
||||
|
||||
|
||||
|
||||
If you don't like the ordering which is generated, click the **Shuffle** button, or drag and drop the smart block contents into the order that you prefer. You can also remove items or add new items manually from the Library. Changes to static smart block contents are saved automatically when you add items, remove or re-order them, or click the **Generate** button. Click the **Save** button in the upper right corner to save any changes to smart block criteria.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,5 @@
|
|||
---
|
||||
layout: article
|
||||
title: Playout History
|
||||
category: manager
|
||||
---
|
||||
|
||||
On the History menu, the **Playout History** page enables you to view a list of files played within a specific date and time range. This page is designed to help your station prepare reports for music royalty collection societies and regulatory agencies.
|
||||
|
|
@ -10,7 +8,7 @@ Search results can be copied to the clipboard using the **Copy** button, exporte
|
|||
|
||||
This page has three tabs: **Log Sheet**, **File Summary** and **Show Summary**. On any of these tabs, you can select a date and time range by clicking the calendar and clock icons in the upper left corner of the page. Then click the search button, which has a magnifying glass icon, to the right. A list of files played during that date and time range will appear further down the page.
|
||||
|
||||
|
||||
|
||||
|
||||
In the **Log Sheet** tab, the playout history is sorted by **Start Time** and **End Time** by default.
|
||||
|
||||
|
|
@ -26,11 +24,11 @@ Log entries can also be manually deleted, using the button with the trashcan ico
|
|||
|
||||
## 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**.
|
||||
|
||||
|
||||
|
||||
|
||||
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.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,14 +1,18 @@
|
|||
---
|
||||
title: Podcasts
|
||||
layout: article
|
||||
category: interface
|
||||
---
|
||||
|
||||
The Podcasts page allows you add subscriptions to podcasts which are often used to syndicated audio files using a URL called a RSS feed. This allows your LibreTime instance to automatically download new shows from the web.
|
||||
|
||||
In order to add a podcast you need to get the RSS feed. All podcasts available on iTunes have a RSS feed but it is sometimes hidden. See this issue on our github page [#510](https://github.com/LibreTime/libretime/issues/510) for more information. RSS feeds that do not end in _.xml_ may be accepted by LibreTime but might fail to download episodes; in that case, download the episode using a podcast client such as [gpodder](https://gpodder.github.io/) and then manually upload and schedule the episode. Podcast feeds coming from Anchor.fm have been known to have this issue.
|
||||
:::info
|
||||
|
||||
The podcast interfaces provides you with the ability to generate [Smartblocks](/docs/playlists) that can be used in conjunction with autoloading playlists to schedule the newest episode of a podcast without human intervention.
|
||||
All podcasts available on iTunes have a RSS feed but it is sometimes hidden. See issue [#510](https://github.com/LibreTime/libretime/issues/510) for more information. RSS feeds that do not end in _.xml_ may be accepted by LibreTime yet fail to download episodes. A work-around is to download the episode using a podcast client such as [gpodder](https://gpodder.github.io/) and then manually upload and schedule the episode.
|
||||
|
||||
Podcast feeds coming from Anchor.fm have been known to have a similar issue.
|
||||
|
||||
:::
|
||||
|
||||
The podcast interfaces provides you with the ability to generate [Smartblocks](/docs/guides/playlists) that can be used in conjunction with autoloading playlists to schedule the newest episode of a podcast without human intervention.
|
||||
|
||||
<html>
|
||||
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/g-4UcD8qvR8" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|
||||
|
|
@ -16,7 +20,7 @@ The podcast interfaces provides you with the ability to generate [Smartblocks](/
|
|||
|
||||
### Podcasts Dashboard
|
||||
|
||||
|
||||
|
||||
|
||||
The podcasts dashboard is similar to the tracks view, allowing you to add, edit, and remove
|
||||
podcasts by the toolbar, in addition to sorting by columns.
|
||||
|
|
@ -26,7 +30,7 @@ Once the podcast's feed is recognized, the editor pane opens for the podcast.
|
|||
|
||||
### Editor
|
||||
|
||||
|
||||
|
||||
|
||||
In the podcasts editor, you can rename the podcast, update settings for the podcast, and manage episodes.
|
||||
A search box is available to search for episodes within the feed.
|
||||
|
|
|
|||
|
|
@ -1,14 +1,12 @@
|
|||
---
|
||||
layout: article
|
||||
title: Preparing Media for Upload
|
||||
category: interface
|
||||
---
|
||||
|
||||
Before uploading media to an LibreTime server, there are a number of factors which should be considered. Getting your ingest workflow right will save you a lot of time later.
|
||||
|
||||
## Metadata quality
|
||||
|
||||
LibreTime automatically imports any metadata that is in the files' ID3 tags. If these tags are incorrect or are missing information, you will have to either edit the metadata manually, or suffer the consequences. For example, if the files have creator or genre metadata missing, it will be impossible to search for, create playlists or generate smart blocks according to these criteria until you add it.
|
||||
LibreTime automatically imports any metadata that is in the files' ID3 tags. If these tags are incorrect or are missing information, you will have to either edit the metadata manually. Files with metadata such as track title and artist information may be difficult to locate in larger libraries, or add to shows, playlists, or smart blocks.
|
||||
|
||||
There are a number of programs available which can be used to correct mistakes or incomplete information in ID3 tags. You can use a music library manager (like Apple Music, Rhythmbox, or Windows Media Player) to edit ID3 tags as well, but you may be required to import the files into your library, which may not always be convenient.
|
||||
|
||||
|
|
@ -19,15 +17,13 @@ There are a number of programs available which can be used to correct mistakes o
|
|||
|
||||
The _Tags From Path_ feature of Ex Falso is a particularly useful time saver if you have a large archive of untagged files. Sometimes there is useful creator or title information in the file name or directory path structure, which can be converted into an ID3 tag automatically.
|
||||
|
||||
|
||||
|
||||
|
||||
## Metadata in legacy character sets
|
||||
|
||||
LibreTime expects file tag metadata to be stored in the international _UTF-8_ character set. Programs such as **Ex Falso** (described above) encode metadata in UTF-8 by default. If you have an archive of files encoded with metadata in a legacy character set, such as the Cyrillic encoding _Windows-1251_, you should convert these files before import.
|
||||
|
||||
The program **mid3iconv** (part of the **python-mutagen** package in Debian and Ubuntu) can be used to batch convert the metadata character set of files on the command line. You can install **python-mutagen** with the command:
|
||||
|
||||
sudo apt-get install python-mutagen
|
||||
The program **mid3iconv** (part of the **python-mutagen** package in Debian and Ubuntu) can be used to batch convert the metadata character set of files on the command line. You can install **python-mutagen** with the `sudo apt-get install python-mutagen`.
|
||||
|
||||
<span id="Convert_MP3_Tags_using_mid3iconv" class="mw-headline"> For example, to preview the conversion of tags from Windows-1251 </span><span id="Convert_MP3_Tags_using_mid3iconv" class="mw-headline">(CP1251)</span><span id="Convert_MP3_Tags_using_mid3iconv" class="mw-headline"> character set to UTF-8 for a whole archive of MP3 files, you could use the command: </span>
|
||||
|
||||
|
|
@ -89,8 +85,14 @@ In the output from vorbisgain, _Peak_ is the maximum sample value of the file be
|
|||
|
||||
## Silence in media files
|
||||
|
||||
Before importing media, it is good practice to check for any silent sections in the media files. While LibreTime compensates for leading and trailing silence with the use of automatic cue-in and cue-out points, it may be preferable to trim these files to the intended length before upload. This is because media in the LibreTime library could potentially be re-used in many different systems. There are many cross-platform audio editors, including [Audacity](https://www.audacityteam.org/) and [ocenaudio](https://www.ocenaudio.com/), that are suitable for the task of trimming audio files
|
||||
Before importing media, it is good practice to check for any silent sections in the media files. While LibreTime compensates for leading and trailing silence with the use of automatic cue-in and cue-out points, it is best to trim these files to the intended length before upload. Two notable audio file editors for removing silent sections are [Audacity](https://www.audacityteam.org/) and [Ocenaudio](https://www.ocenaudio.com/).
|
||||
|
||||
Quiet introductions or extended fades can also lead to apparent gaps in your broadcast playout. This is more common when playing back audio from ripped CDs or dubbed from tape or vinyl; this issue is not as common with digitally-purchased music. For best results, long periods of silence should be removed from files before uploading to Libretime.
|
||||
:::danger
|
||||
|
||||
|
||||
Gaps in playout or dead air can have legal repercussions for your station. Check with your station manager or local or state communications authority for more information.
|
||||
|
||||
:::
|
||||
|
||||
Quiet introductions or extended fades can also lead to apparent gaps in your broadcast playout. This is more common when playing back audio from ripped CDs or dubbed from tape or vinyl. Long periods of silence should be removed from files before uploading to Libretime.
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,5 @@
|
|||
---
|
||||
layout: article
|
||||
title: Scheduling Shows
|
||||
category: interface
|
||||
---
|
||||
|
||||
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/TJtWUzAlP08" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|
||||
|
|
@ -13,7 +11,7 @@ The main workflow in LibreTime is **Upload** media -> create a show on the **Cal
|
|||
|
||||
Once you log in, click on the big blue button on the left navigation that says **Upload**.
|
||||
|
||||
|
||||
|
||||
|
||||
Select the type of media you are uploading (Music, Station IDs, etc.) by using the dropdown box
|
||||
at the top of the pane. After that, either drag and drop media into the area below or click the
|
||||
|
|
@ -22,17 +20,43 @@ dashed rectangle to open a file browser.
|
|||
Once your files have uploaded and have been successfully imported (as shown in the pane on the right),
|
||||
click on **Calendar** on the left navigation.
|
||||
|
||||
|
||||
|
||||
|
||||
Click on the blue **+ New Show** button to add a new show.
|
||||
|
||||
|
||||
|
||||
|
||||
At the very minimum, fill out the show's name and when the show will take place. If the show will repeat regularly,
|
||||
check the **Repeats?** box and fill out the repeat information. A description of all fields of the New Show box
|
||||
are in the table below. Finially, click on the grey **+ Add this show** button at the top
|
||||
are in the table below. Finally, click on the grey **+ Add this show** button at the top
|
||||
of the pane to add your show to the calendar.
|
||||
|
||||
Once your show is created, click on it to open its context menu. Select **Schedule Tracks** to open the track scheduler.
|
||||
|
||||
|
||||
|
||||
The track scheduler behaves similarly to iTunes or Windows Media Player: media browser on the left, playlist on the right.
|
||||
Find the tracks that you would like to schedule by using the search box or sorting columns and then dragging them
|
||||
into the playlist.
|
||||
|
||||
|
||||
|
||||
The bar at the end of the show's playlist will show the amount of time the show is underscheduled or overscheduled.
|
||||
Shows that are underscheduled will have dead air at the end and shows that are overscheduled
|
||||
will fade out exactly when the show is over (the orange colored entry), meaning tracks scheduled to start
|
||||
after this point will not play (dark red colored entries). Click the **Ok** button in the bottom right to save.
|
||||
|
||||
Show playback will start and end as per each show's start and end times, allowing you to rely completely on
|
||||
LibreTime for running your station or using LibreTime as a part of your live setup to cover when DJs are not present.
|
||||
When media is playing, the **On Air** indicator at the top will turn red.
|
||||
|
||||
|
||||
|
||||
You can listen to your stream by going to `yourserverIP:8000` or by clicking the **Listen** button under the On Air
|
||||
indicator.
|
||||
|
||||
### Show Properties Appendix
|
||||
|
||||
| Field | Description |
|
||||
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| _What_ | |
|
||||
|
|
@ -56,27 +80,3 @@ of the pane to add your show to the calendar.
|
|||
| _Style_ | |
|
||||
| Background/Text Color | Set the color of the background and text of entries on the calendar. If not set, LibreTime will select contrasting colors for easy readability. |
|
||||
| Show Logo | If desired, you can upload a show logo here. The logo does not appear on the public page. |
|
||||
|
||||
Once your show is created, click on it to open its context menu. Select **Schedule Tracks** to open the track scheduler.
|
||||
|
||||
|
||||
|
||||
The track scheduler behaves similar to iTunes or Windows Media Player: media browser on the left, playlist on the right.
|
||||
Find the tracks that you'd like to schedule by using the search box or sorting columns and then drag them
|
||||
into the playlist.
|
||||
|
||||
|
||||
|
||||
The bar at the end of the show's playlist will show the amount of time the show is underscheduled or overscheduled.
|
||||
Shows that are underscheduled will have dead air at the end and shows that are overscheduled
|
||||
will fade out exactly when the show is over (the orange colored entry), meaning tracks scheduled to start
|
||||
after this point will not play (dark red colored entries). Click the **Ok** button in the bottom right to save.
|
||||
|
||||
Show playback will start and end as per each show's start and end times, allowing you to rely completely on
|
||||
LibreTime for running your station or using LibreTime as a part of your live setup to cover when DJs are not present.
|
||||
When media is playing, the **On Air** indicator at the top will turn red.
|
||||
|
||||
|
||||
|
||||
You can listen to your stream by going to `yourserverIP:8000` or by clicking the **Listen** button under the On Air
|
||||
indicator.
|
||||
|
|
|
|||
|
|
@ -1,19 +1,17 @@
|
|||
---
|
||||
layout: article
|
||||
title: Settings
|
||||
category: admin
|
||||
---
|
||||
|
||||
## General Settings
|
||||
|
||||
|
||||
|
||||
|
||||
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
|
||||
into LibreTime, and optionally in stream metadata. You can also set a **Station
|
||||
Description** and **Station Logo** here.
|
||||
|
||||
|
||||
|
||||
|
||||
The **Default Interface Language** drop-down menu sets the default localization
|
||||
for your LibreTime instance, and the **Station Timezone** drop-down menu can be
|
||||
|
|
@ -49,7 +47,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
|
||||
default.
|
||||
|
||||
|
||||
|
||||
|
||||
You can opt-in to test new features with the **Feature Previews** option.
|
||||
Features that we soft rollout this way may need more feedback or still have
|
||||
|
|
@ -59,7 +57,7 @@ refactors. You can switch back at any time.
|
|||
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
|
||||
wish. (There is more about this feature in the
|
||||
[_Exporting the schedule_](/docs/playout-history) chapter, in the
|
||||
[_Exporting the schedule_](/docs/guides/playout-history) chapter, in the
|
||||
_Advanced Configuration_ section of this book).
|
||||
|
||||
The **Allowed CORS URLs** is intended to deal with situations where you want a
|
||||
|
|
@ -68,22 +66,20 @@ there is a reverse proxy server in front of LibreTime. If you are using a
|
|||
reverse proxy, the URLs that will be used to access it should be added here.
|
||||
|
||||
The **Display login button on your Radio Page?** will determine whether visitors
|
||||
to your site see a link to login. If this is disabled DJs and admins will need
|
||||
to your site see a link to login. If this is disabled, DJs and admins will need
|
||||
to goto http://SITEURL/login to be able to login.
|
||||
|
||||
The **Tune-In Settings** section is intended for stations that have partnered
|
||||
with TuneIn to automatically push their now playing metadata to TuneIn. This
|
||||
hasn't been tested and also requires special credentials from TuneIn.
|
||||
|
||||
|
||||
The **Dangerous Options** section provides an administrator the ability to erase LibreTime's track library.
|
||||
|
||||
The **Dangerous Options** section provides an administrator the ability to erase
|
||||
the entire LibreTime library.
|
||||
:::danger
|
||||
|
||||
When you are done remember click the **Save** button at the top or bottom of the
|
||||
form.
|
||||
Erasing Libretime's track library cannot be undone.
|
||||
|
||||
|
||||
:::
|
||||
|
||||
Individual LibreTime users can choose another interface localization when they
|
||||
log in, or set personal preferences for localization and time zone by clicking
|
||||
|
|
@ -91,7 +87,7 @@ their username on the right side of the menu bar.
|
|||
|
||||
---
|
||||
|
||||
## Track Types {#types}
|
||||
## Track Types
|
||||
|
||||
### Create track types
|
||||
|
||||
|
|
@ -148,11 +144,11 @@ If your Airtime server is behind a firewall, and you wish remote broadcasters to
|
|||
|
||||
In the Master Panel, available input source streams are shown with an orange line connecting the source to the switch, which you could think of like a patch cable connecting a source to a broadcast mixer. When that switch is active, another orange line connects the switch to the On Air indicator, like a patch cable connecting a mixer to a transmitter.
|
||||
|
||||
|
||||
|
||||
|
||||
If you have checked the **Auto Switch On** box in the Stream Settings page, the **Master Source** switch will move automatically to the active position, on the left, when an authenticated master source connects to Airtime. Otherwise, you can activate the switches manually by clicking the left side of each switch, or deactivate them by clicking the right side. The switches do not have to be dragged with the mouse, in the way that a switch on a hardware mixer would be pushed sideways. **Show Source** live input streams can also be manually activated or deactivated in the same way. If neither the show source or master source is active then LibreTime will default to what is scheduled to play in the Calendar.
|
||||
|
||||
|
||||
|
||||
|
||||
If you have the **Auto Switch Off** box checked LibreTime will resume scheduled playback whenever a stream disconnects. Otherwise you will need to slide to disable a source after a DJ stops streaming.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,17 +1,15 @@
|
|||
---
|
||||
layout: article
|
||||
title: System Status
|
||||
category: admin
|
||||
---
|
||||
|
||||
On the **Settings** menu, the **Status** page provides an overview of the health and resource usage of the various
|
||||
services that make up a LibreTime system. If all is well, you will only see green check mark icons in the
|
||||
**Status** column. This page also shows how much **Disk Space** you have used on the disk partition containing the media storage folder.
|
||||
Status column. This page also shows how much **Disk Space** you have used on the disk partition containing the media storage folder.
|
||||
|
||||
|
||||
|
||||
|
||||
If any of the check mark icons in the **Status** column have changed to a red warning sign, contact your system
|
||||
administrator for assistance. (The chapter [Troubleshooting](/docs/troubleshooting) contains some tips). LibreTime will
|
||||
administrator for assistance. LibreTime will
|
||||
do its best to restart any failing services, but sometimes manual intervention may be required; for example, in the case of hardware failure.
|
||||
|
||||
If you have run out of storage space, a LibreTime user with _admin_ privileges could log in and delete media files
|
||||
|
|
|
|||
|
|
@ -1,23 +1,23 @@
|
|||
---
|
||||
layout: article
|
||||
title: Managing Users
|
||||
category: interface
|
||||
---
|
||||
|
||||
> Note: if your Libretime server is accessible from the public Internet (ex. being hosted in a cloud VM)
|
||||
> it is strongly recommended to create a second administrator account with a secure password and then
|
||||
> delete the `admin` account.
|
||||
:::danger
|
||||
|
||||
It is strongly recommended not to use the default `admin` account in production, especially if your LibreTime server is accessible from the internet.
|
||||
|
||||
:::
|
||||
|
||||
## User Account Types
|
||||
|
||||
To add further user accounts to the system, one for each of your station staff that need access to Airtime, click the **New User** button with the plus icon. Enter a user name, password and contact details, and then select the **User Type** from the drop down menu, which can be _Admin_, _Program Manager_, _DJ_, or _Guest_. The difference between these user types is:
|
||||
To add further user accounts to the system, one for each of your station staff that need access to Airtime, click the **New User** button with the plus icon. Enter a user name, password and contact details, and then select the **User Type** from the drop down menu, which can be _Admin_, _Program Manager_, _DJ_, or _Guest_.
|
||||
|
||||
**Guests**
|
||||
### Guests
|
||||
|
||||
- Can view shows and the playout log on the Calendar and Dashboard, respectively
|
||||
- Listen to the output stream without leaving the interface
|
||||
|
||||
**DJs**
|
||||
### DJs
|
||||
|
||||
- Everything Guests can do, plus
|
||||
- Upload media (music, PSAs, underwriting, shows, etc.) to their own library (DJs cannot view other libraries)
|
||||
|
|
@ -25,7 +25,7 @@ To add further user accounts to the system, one for each of your station staff t
|
|||
- Preview uploaded media _without_ affecting the live playout
|
||||
- Create Playlists, Smart Blocks, and connect Podcasts and Webstreams to LibreTime
|
||||
|
||||
**Program Managers**
|
||||
### Program Managers
|
||||
|
||||
- Everything DJs can do, plus
|
||||
- Manage other users' libraries in addition to their own
|
||||
|
|
@ -34,7 +34,7 @@ To add further user accounts to the system, one for each of your station staff t
|
|||
- View listener statistics
|
||||
- Export playout logs for analysis or reporting for music royalties
|
||||
|
||||
**Administrators**
|
||||
### Administrators
|
||||
|
||||
- Everything Program Managers can do, plus
|
||||
- Manage all user accounts, including the ability to reset passwords
|
||||
|
|
@ -43,18 +43,11 @@ To add further user accounts to the system, one for each of your station staff t
|
|||
|
||||
## Editing or deleting user accounts
|
||||
|
||||
|
||||
|
||||
New user accounts that you add will be shown in the table on the left side of the **Users** page. If you have a
|
||||
large number of users on the system, you can use the search tool above the table (which has a magnifying glass icon)
|
||||
to identify specific user accounts. Click the white chevrons in the table headings to sort the search results
|
||||
by **Username**, **First Name**, **Last Name** or **User Type**.
|
||||
|
||||
|
||||
|
||||
To edit a user account, click on that user's row in the table, change the user's details in the box on the
|
||||
right side, and then click the **Save** button. To remove a user account, click the small **x** icon to the right
|
||||
side of its row in the table. You cannot delete your own user account, and usernames cannot be changed once created.
|
||||
|
||||
|
||||
|
||||
Users can update their own password, and their contact, language and time zone details, by clicking their username on the
|
||||
right side of the main menu bar, next to the **Logout** link.
|
||||
|
|
|
|||
|
|
@ -1,21 +1,23 @@
|
|||
---
|
||||
title: Webstreams
|
||||
layout: article
|
||||
category: interface
|
||||
---
|
||||
|
||||
<html>
|
||||
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/Ha3X6aYdY04" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|
||||
</html>
|
||||
|
||||
### Adding a webstream
|
||||
## Adding a webstream
|
||||
|
||||
A web stream URL and metadata can be added to the LibreTime library, so that a remote stream can be searched for and scheduled to be _pulled_ into a show. For example, at the top of the hour your station may pull a news report from journalists working in another studio. This is a different concept from **Master Source** and **Show Source** remote streams which are _pushed_ into the LibreTime playout schedule.
|
||||
|
||||
To add a web stream, click the **+ New** button on the left side of the Webstreams page. Like a playlist, web streams in the Library can have a title and **Description**, which may help you find them in searches later.
|
||||
|
||||
|
||||
|
||||
|
||||
The **Stream URL** setting must include the _port number_ (such as 8000) and _mount point_ (such as remote_stream) of the remote stream, in addition to the streaming server name. A **Default Length** for the remote stream can also be set. If the stream is added at the end of a show which becomes overbooked as a result, it will be faded out when the show ends.
|
||||
|
||||
Note: LibreTime checks the remote webstream's status upon editing stream settings, so an offline stream will result in an error. There are many tools such as [BUTT](https://danielnoethen.de/butt/) and [MIXXX](https://www.mixxx.org) that can be used to send a test stream to LibreTime can save it; read more [here](/docs/live-broadcast).
|
||||
:::note
|
||||
|
||||
LibreTime checks the remote webstream's status upon editing stream settings, so an offline stream will result in an error. There are many tools such as [BUTT](https://danielnoethen.de/butt/) and [MIXXX](https://www.mixxx.org) that can be used to send a test stream to LibreTime can save it; read more [here](/docs/guides/live-broadcast).
|
||||
|
||||
:::
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue