diff --git a/docs/404.html b/docs/404.html index 086a5c9ea..6c3945e4f 100644 --- a/docs/404.html +++ b/docs/404.html @@ -1,6 +1,6 @@ --- permalink: /404.html -layout: default +layout: 404 --- -
-

404

+
+
+ 404 Tape -

Page not found :(

-

The requested page could not be found.

-
+

Page not found :(

+

The requested page could not be found.

+
+ \ No newline at end of file diff --git a/docs/_includes/footer.html b/docs/_includes/footer.html new file mode 100644 index 000000000..77960f284 --- /dev/null +++ b/docs/_includes/footer.html @@ -0,0 +1,8 @@ + \ No newline at end of file diff --git a/docs/_layouts/404.html b/docs/_layouts/404.html new file mode 100644 index 000000000..125e88c11 --- /dev/null +++ b/docs/_layouts/404.html @@ -0,0 +1,40 @@ + + + + {% include head.html %} + + + + {{ site.title }} - {{ page.title }} + + + + + {% include navbar.html %} + + + + + + + Back to top + + +
+ +
+ + + {% include scripts.html %} + + diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html index 1362cb8c2..3d3f868f3 100644 --- a/docs/_layouts/default.html +++ b/docs/_layouts/default.html @@ -21,6 +21,21 @@ Back to top +
+
+
+
+ + + Back to Docs + +
+

+
+
+
+
+
@@ -39,14 +54,8 @@
- + {% include footer.html %} + {% include scripts.html %} diff --git a/docs/_layouts/guides.html b/docs/_layouts/guides.html index c19f90964..681f6c97a 100644 --- a/docs/_layouts/guides.html +++ b/docs/_layouts/guides.html @@ -111,56 +111,8 @@
- + {% include footer.html %} - - - - - - - + {% include scripts.html %} diff --git a/docs/_layouts/splash.html b/docs/_layouts/splash.html index e48e94714..6d3cf9b6d 100644 --- a/docs/_layouts/splash.html +++ b/docs/_layouts/splash.html @@ -226,7 +226,7 @@

Requires: 1 Ghz processor, 2 GB RAM, wired ethernet connection with static IP address, and you. What are you waiting for?

- Server Install + Server Install Vagrant for Devs @@ -238,56 +238,8 @@
- + {% include footer.html %} - - - - - - - + {% include scripts.html %} diff --git a/docs/css/creative.min.css b/docs/css/creative.min.css index 32dd27865..f42e69115 100755 --- a/docs/css/creative.min.css +++ b/docs/css/creative.min.css @@ -22,7 +22,7 @@ hr.light{ img{ width:100%; - max-width: 700px; + max-width: 600px; } a{ diff --git a/docs/img/404.png b/docs/img/404.png new file mode 100644 index 000000000..ab1419ae2 Binary files /dev/null and b/docs/img/404.png differ diff --git a/docs/img/Playlist-Editor.png b/docs/img/Playlist-Editor.png new file mode 100644 index 000000000..7c3a93398 Binary files /dev/null and b/docs/img/Playlist-Editor.png differ diff --git a/docs/img/Smartblock-advanced.png b/docs/img/Smartblock-advanced.png new file mode 100644 index 000000000..9abd5c794 Binary files /dev/null and b/docs/img/Smartblock-advanced.png differ diff --git a/docs/img/Smartblock-contents.png b/docs/img/Smartblock-contents.png new file mode 100644 index 000000000..8215f363b Binary files /dev/null and b/docs/img/Smartblock-contents.png differ diff --git a/docs/img/Smartblock-options.png b/docs/img/Smartblock-options.png new file mode 100644 index 000000000..b5d3052eb Binary files /dev/null and b/docs/img/Smartblock-options.png differ diff --git a/docs/img/playlist-w-smart-blocks.png b/docs/img/playlist-w-smart-blocks.png new file mode 100644 index 000000000..8f1f79679 Binary files /dev/null and b/docs/img/playlist-w-smart-blocks.png differ diff --git a/docs/live-broadcast.md b/docs/live-broadcast.md index 900a2b50b..a936fe24a 100644 --- a/docs/live-broadcast.md +++ b/docs/live-broadcast.md @@ -4,9 +4,6 @@ title: Broadcasting live with MIXXX or B.U.T.T. --- -This how to is intended for DJs using BUTT or MIXXX to stream to their LibreTime -server with an external USB audio card setup to route a mixer and sound. - ## Live shows with MIXXX {#mixxx} [Mixxx](https://www.mixxx.org) is a cross-platform Open Source application for DJs. diff --git a/docs/playlists-smartblocks.md b/docs/playlists-smartblocks.md index c093eae65..a97df8824 100644 --- a/docs/playlists-smartblocks.md +++ b/docs/playlists-smartblocks.md @@ -10,11 +10,9 @@ title: Playlists and Smartblocks You can create a new playlist on the toolbar of the **Playlists** page. -At first, the new playlist will be shown as *Untitled Playlist*. Click the pencil icon on the right to give the playlist a name. +![](img/Playlist-Editor.png) -Type the name you have chosen, then press the **Enter** key on your keyboard to save the new name. You can edit the name of the playlist later, by clicking on the pencil icon again. - -Click the link **View / edit description** to expand a box where you can enter a **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. +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. ### Adding content to a playlist @@ -26,8 +24,6 @@ To audition a playlist file in your web browser, click the white triangle button Click the small white **x** icon on the right hand side of each row to remove a file from the playlist. You can also drag and drop files to re-order them, or click the **Shuffle** button to re-order files automatically. -To adjust start and end fades, click the playlist **Fade** button (two horizontal white arrows crossing in a grey rectangle), to the left of the **Delete** and **Save** buttons. This action opens a beige bar in which you can set the **Fade in** duration for the first item in this playlist, and the **Fade out** duration for the last item. This duration figure represents the length of the fade, in seconds and tenths of a second, not the time at which the fade takes place. The default fade duration is set in the **Preferences** page on the **System** menu. - When your playlist is complete, click the **New** button in the top left corner to create another playlist, click the close icon (a white cross in a black circle) in the top right corner, or browse to another page of the LibreTime interface. 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. @@ -36,30 +32,34 @@ If you want to edit the playlist content or metadata later, you can find it by * ### Creating a Smartblock +![](img/Smartblock-options.png) + 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. To create a smart block, click the **Smartblocks** button on the left sidebar, and select **New** from the toolbar. Like a playlist, smart blocks can have a title and description, which you can edit. This helps you find relevant smart blocks in searches. -Click the link **Smart Block Options** to display the criteria and modifiers for the smart block. The criteria can be any one of LibreTime's metadata categories, such as **Title**, **Creator** or **Genre**. The modifier depends on whether the metadata in question contains letters or numbers. For example, **Title** has modifiers including *contains* and *starts with*, whereas the modifiers for **BPM** include *is greater than* and *is in the range*. +Fill out the smart block's **Name**, **Search Criteria**, and **Limit to** sections. The search criteria can be any one of LibreTime's metadata categories, such as **Title**, **Creator** or **Genre**. The modifier depends on whether the metadata in question contains letters or numbers. For example, **Title** has modifiers including *contains* and *starts with*, whereas the modifiers for **BPM** include *is greater than* and *is in the range*. + +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 never overflow the Time Limit. For instance if you set a time limit of 1 hour. It will add tracks to the schedule until it can't add any more tracks without exceeding the hour. 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". This will make LibreTime add tracks that meet the criteria until it equals or is longer than the time limit. This is helpful for avoiding dead air on shows that are being autoscheduled. + +![](img/Smartblock-advanced.png) 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*. (The criteria are not case sensitive). For a static smart block, click the **Generate** button to see the results. Dynamic smart blocks do not display the **Generate** or **Shuffle** buttons. +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](preparing-media) for tips on tagging content. + +![](img/Smartblock-content.png) 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. -To add an AND criteria, such as **Creator** containing *jimi* AND BPM in the range *120* to *130*, click the **plus button** on the right. If you see the message **0 files meet the criteria** in this case, it might mean that the files in the Library have not been tagged with BPM metadata. See the chapter *Preparing media for ingest* for tips on tagging content. - -![](img/Screenshot487-Smart_block_and_criteria.png) - By default, a smart block will not contain repeated items, which will limit the duration of the block if you do not have sufficient items meeting the specified criteria in your **Library**. To override the default behaviour, check the **Allow Repeat Tracks** box. The **Sort tracks by** menu offers the options of **random**, **newest** or **oldest** items first. -In addition Smart Blocks by default will never overflow the Time Limit. For instance if you set a time limit of 1 hour. It will add tracks to the schedule until it can't add any more tracks without exceeding the hour. 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". This will make LibreTime add tracks that meet the criteria until it equals or is longer than the time limit. This is helpful for avoiding dead air on shows that are being autoscheduled. - -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. - Smart blocks can be added to shows in the same way as a manually created playlist is added. Smart blocks can also be added to one or more playlists. In the case of a playlist containing a static smart block, click **Expand Static Block** to view the contents. For a dynamic smart block, you can review the criteria and duration limit by clicking **Expand Dynamic Block**. Once created, smart blocks can be found under the Smartblocks tab and refined at any time. They can be re-opened by right-clicking on the smart block and selecting **Edit** from the pop-up menu. diff --git a/docs/podcasts-webstreams.md b/docs/podcasts-webstreams.md index 2de6cea1a..847f7cc33 100644 --- a/docs/podcasts-webstreams.md +++ b/docs/podcasts-webstreams.md @@ -4,10 +4,6 @@ title: Podcasts and Webstreams --- - - - - ## Podcasts {#podcasts} 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. @@ -16,8 +12,10 @@ In order to add a podcast you need to get the RSS feed. All podcasts available o The podcast interfaces provides you with the ability to generate [Smartblocks](smartblocks) that can be used in conjunction with [Autoloading Playlists](../calendar/#autoloading-playlist) to schedule the newest episode of a podcast without human intervention. -Video Tutorials: -- [How to schedule a podcast to play the latest episode automatically](https://www.youtube.com/watch?v=g-4UcD8qvR8) + + + + ### Podcasts Dashboard @@ -51,7 +49,7 @@ A web stream URL and metadata can be added to the LibreTime library, so that a r 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. -![](webstream.jpg) +![](img/webstream.jpg) 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.