change "Airtime" to "Libretime" except where it refers to code.
This commit is contained in:
parent
ccdd447ddc
commit
126288af6e
|
@ -1,19 +1,19 @@
|
||||||
The Airtime API enables many types of information about the broadcast schedule and configuration to be retrieved from the Airtime server. Other than the live-info and week-info data fetched by website widgets (see the chapter *Exporting the schedule*), all API requests must be authenticated using the secret API key stored in the file */etc/airtime/api\_client.cfg* on the Airtime server. This key is autogenerated during Airtime installation and should be unique for each server.
|
The Libretime API enables many types of information about the broadcast schedule and configuration to be retrieved from the Libretime server. Other than the live-info and week-info data fetched by website widgets (see the chapter *Exporting the schedule*), all API requests must be authenticated using the secret API key stored in the file */etc/airtime/api\_client.cfg* on the Libretime server. This key is autogenerated during Libretime installation and should be unique for each server.
|
||||||
|
|
||||||
If you intend to use the Airtime API across a public network, for security reasons it is highly recommended that all API requests are sent over encrypted https: and that the web server is configured to accept requests to the api/ directory from specific host names or IP addresses only.
|
If you intend to use the Libretime API across a public network, for security reasons it is highly recommended that all API requests are sent over encrypted https: and that the web server is configured to accept requests to the api/ directory from specific host names or IP addresses only.
|
||||||
|
|
||||||
The format of API requests is:
|
The format of API requests is:
|
||||||
|
|
||||||
https://airtime.example.com/api/api-action/format/json/api_key/XXXXXX
|
https://libretime.example.com/api/api-action/format/json/api_key/XXXXXX
|
||||||
|
|
||||||
where api-action is the type of request and XXXXXX is the secret API key. Available actions include:
|
where api-action is the type of request and XXXXXX is the secret API key. Available actions include:
|
||||||
|
|
||||||
- on-air-light - return true if the station is on air
|
- on-air-light - return true if the station is on air
|
||||||
- status - get the status of Airtime components and resource usage
|
- status - get the status of Libretime components and resource usage
|
||||||
- version - returns the version of Airtime installed
|
- version - returns the version of Libretime installed
|
||||||
- get-files-without-silan-value - list files for which silence detection has not yet been performed
|
- get-files-without-silan-value - list files for which silence detection has not yet been performed
|
||||||
- get-stream-setting - gets the settings of Airtime output streams
|
- get-stream-setting - gets the settings of Libretime output streams
|
||||||
- get-stream-parameters - gets the parameters of Airtime output streams
|
- get-stream-parameters - gets the parameters of Libretime output streams
|
||||||
|
|
||||||
For example, using the action *get-stream-setting* returns the following output for the first configured stream:
|
For example, using the action *get-stream-setting* returns the following output for the first configured stream:
|
||||||
|
|
||||||
|
@ -41,9 +41,9 @@ Some API requests require the directory ID number to be specified as *dir\_id* i
|
||||||
|
|
||||||
For example, using a request such as:
|
For example, using a request such as:
|
||||||
|
|
||||||
http://airtime.example.com/api/list-all-files/format/json/api_key/XXXXXX/dir_id/1/
|
http://libretime.example.com/api/list-all-files/format/json/api_key/XXXXXX/dir_id/1/
|
||||||
|
|
||||||
returns the full path to each media file in the Airtime storage directory:
|
returns the full path to each media file in the Libretime storage directory:
|
||||||
|
|
||||||
{"files":[
|
{"files":[
|
||||||
"imported\/1\/Mark Ronson feat. Saigon\/Here Comes the Fuzz\/7-Diduntdidunt-unknown.flac",
|
"imported\/1\/Mark Ronson feat. Saigon\/Here Comes the Fuzz\/7-Diduntdidunt-unknown.flac",
|
||||||
|
|
Binary file not shown.
After Width: | Height: | Size: 26 KiB |
|
@ -3,7 +3,7 @@ History
|
||||||
|
|
||||||
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.
|
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.
|
||||||
|
|
||||||
Search results can be copied to the clipboard using the **Copy** button, exported as data in **CSV** format (comma separated values), exported as a document in **PDF** format, or displayed in a printer-friendly format using the **Print** button. (Your web browser must have an Adobe Flash plugin installed for these buttons to appear). Press the **Esc** key to return to the Airtime interface once the print job is complete.
|
Search results can be copied to the clipboard using the **Copy** button, exported as data in **CSV** format (comma separated values), exported as a document in **PDF** format, or displayed in a printer-friendly format using the **Print** button. (Your web browser must have an Adobe Flash plugin installed for these buttons to appear). Press the **Esc** key to return to the Libretime interface once the print job is complete.
|
||||||
|
|
||||||
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.
|
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.
|
||||||
|
|
||||||
|
@ -22,7 +22,7 @@ On the **Show Summary** tab, click the name of a show within the search range to
|
||||||
Manual logging
|
Manual logging
|
||||||
--------------
|
--------------
|
||||||
|
|
||||||
If your station features playout from analogue sources such as turntables or microphones, there is no automatic metadata for Airtime 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="static/Screenshot536-Manual_login_250.png" width="530" height="575" />
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
The Airtime administration interface, as a web application, is fully customizable using the same methods that you might use to modify a website. For instance, you may wish to increase certain font sizes or change the colours in the Airtime interface to better suit staff users with impaired vision. To do this, open one of the CSS files in the */public/css/* directory under the Airtime *DocumentRoot* directory in an editor such as **nano**:
|
The Libretime administration interface, as a web application, is fully customizable using the same methods that you might use to modify a website. For instance, you may wish to increase certain font sizes or change the colours in the Libretime interface to better suit staff users with impaired vision. To do this, open one of the CSS files in the */public/css/* directory under the Libretime *DocumentRoot* directory in an editor such as **nano**:
|
||||||
|
|
||||||
sudo nano /usr/share/airtime/public/css/styles.css
|
sudo nano /usr/share/airtime/public/css/styles.css
|
||||||
|
|
||||||
|
@ -14,7 +14,7 @@ To change the background colour of the administration interface from dark gray t
|
||||||
|
|
||||||
Save the file with **Ctrl+O**, then refresh your browser to see the change to the interface background colour.
|
Save the file with **Ctrl+O**, then refresh your browser to see the change to the interface background colour.
|
||||||
|
|
||||||
Any custom changes that you make to the administration interface should be backed up before upgrading Airtime to a newer version, otherwise they could be overwritten. If you have made improvements that you think might be useful to other Airtime users, please contact Sourcefabric and tell us about them.
|
Any custom changes that you make to the administration interface should be backed up before upgrading Libretime to a newer version, otherwise they could be overwritten. If you have made improvements that you think might be useful to other Libretime users, please contact Libretime and tell us about them.
|
||||||
|
|
||||||
Modifying the Icecast interface
|
Modifying the Icecast interface
|
||||||
-------------------------------
|
-------------------------------
|
||||||
|
|
|
@ -1,10 +1,10 @@
|
||||||
The Airtime administration interface can be localized using the standard GNU **gettext** method. Using GitHub for this task means you don't have to tackle the whole of a localization yourself; just as much as you can manage.
|
The Libretime administration interface can be localized using the standard GNU **gettext** method. Using GitHub for this task means you don't have to tackle the whole of a localization yourself; just as much as you can manage.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
First, you should check if a localization is already under way for your locale of choice. The best way to do this is to take a look at the 'master' branch in the GitHub repository for Airtime at <https://github.com/sourcefabric/Airtime/tree/master>. You can also ask in the Airtime development forum at <http://forum.sourcefabric.org/categories/airtime-development>, where you might find community members who can help you with the translation.
|
First, you should check if a localization is already under way for your locale of choice. The best way to do this is to take a look at the 'master' branch in the GitHub repository for Libretime at <https://github.com/LibreTime/libretime>. You can also ask in the Libretime development forum at <https://discourse.libretime.org/>, where you might find community members who can help you with the translation.
|
||||||
|
|
||||||
GNU **gettext** means using a .po file for each language or dialect, a specially formatted plain text file with groups of three or more lines, like this example from Airtime's Korean localization:
|
GNU **gettext** means using a .po file for each language or dialect, a specially formatted plain text file with groups of three or more lines, like this example from Libretime's Korean localization:
|
||||||
|
|
||||||
#: airtime_mvc/application/configs/navigation.php:57
|
#: airtime_mvc/application/configs/navigation.php:57
|
||||||
msgid "Media Folders"
|
msgid "Media Folders"
|
||||||
|
@ -16,11 +16,11 @@ If you use the cross-platform program **Poedit** (<http://www.poedit.net/>) to e
|
||||||
|
|
||||||
Before manually translating strings in Poedit from scratch, you should take a look at the online translation services available, such as Lingohub (<https://lingohub.com>) or Google's Translator Toolkit (<http://translate.google.com/toolkit/>), which both support gettext .po files. If using automatic translation, you can then use Poedit to fine-tune the localization and fix any formatting errors.
|
Before manually translating strings in Poedit from scratch, you should take a look at the online translation services available, such as Lingohub (<https://lingohub.com>) or Google's Translator Toolkit (<http://translate.google.com/toolkit/>), which both support gettext .po files. If using automatic translation, you can then use Poedit to fine-tune the localization and fix any formatting errors.
|
||||||
|
|
||||||
If you don't already have a GitHub account, you can sign up at <https://github.com/signup/free>. Once you have a GitHub account, you can fork a copy (<https://help.github.com/articles/fork-a-repo>) of the Airtime project. Work for the next major version of the software is done in the **master** branch of each project, so that's the branch to **checkout** after you have made the initial **git clone**.
|
If you don't already have a GitHub account, you can sign up at <https://github.com/signup/free>. Once you have a GitHub account, you can fork a copy (<https://help.github.com/articles/fork-a-repo>) of the Libretime project. Work for the next major version of the software is done in the **master** branch of each project, so that's the branch to **checkout** after you have made the initial **git clone**.
|
||||||
|
|
||||||
In the locale code *de\_CH*, for example, *de* represents the German language and the suffix *\_CH* indicates the dialect spoken in Switzerland. Some languages have a wide variety of dialect localizations, which can be differentiated with a suffix in this way. You should update the header information in the .po file, which includes the language code and a country code, using one of the existing .po files as a guide.
|
In the locale code *de\_CH*, for example, *de* represents the German language and the suffix *\_CH* indicates the dialect spoken in Switzerland. Some languages have a wide variety of dialect localizations, which can be differentiated with a suffix in this way. You should update the header information in the .po file, which includes the language code and a country code, using one of the existing .po files as a guide.
|
||||||
|
|
||||||
After forking the Airtime git repository, make sure you're in the **master** branch:
|
After forking the Libretime git repository, make sure you're in the **master** branch:
|
||||||
|
|
||||||
git branch
|
git branch
|
||||||
devel
|
devel
|
||||||
|
@ -40,18 +40,18 @@ and update the header information in the new copy of the *airtime.po* file using
|
||||||
|
|
||||||
For the example of Swiss German, the header of the file should now look like this:
|
For the example of Swiss German, the header of the file should now look like this:
|
||||||
|
|
||||||
# SWISS GERMAN (de_CH) translation for Airtime.
|
# SWISS GERMAN (de_CH) translation for Libretime.
|
||||||
# Copyright (C) 2013 Sourcefabric
|
# Copyright (C) 2013 Sourcefabric
|
||||||
# This file is distributed under the same license as the Airtime package.
|
# This file is distributed under the same license as the Libretime package.
|
||||||
# Sourcefabric <contact@sourcefabric.org>, 2013.
|
# Sourcefabric <contact@sourcefabric.org>, 2013.
|
||||||
#
|
#
|
||||||
msgid ""
|
msgid ""
|
||||||
msgstr ""
|
msgstr ""
|
||||||
"Project-Id-Version: Airtime 2.5\n"
|
"Project-Id-Version: Libretime 3.0-Alpha\n"
|
||||||
"Report-Msgid-Bugs-To: http://forum.sourcefabric.org/\n"
|
"Report-Msgid-Bugs-To: https://discourse.libretime.org/\n"
|
||||||
|
|
||||||
After using an online translation tool to begin a new localization, you can load the exported .po file into Poedit and complete your translation there. Enter the localization team's contact information and language into Poedit's **Edit -> Preferences** and **Catalog -> Settings** dialogs, which will be added to the .po file. When you save a .po file in Poedit, the corresponding binary .mo file will be compiled automatically.
|
After using an online translation tool to begin a new localization, you can load the exported .po file into Poedit and complete your translation there. Enter the localization team's contact information and language into Poedit's **Edit -> Preferences** and **Catalog -> Settings** dialogs, which will be added to the .po file. When you save a .po file in Poedit, the corresponding binary .mo file will be compiled automatically.
|
||||||
|
|
||||||
Finally, **git add**, **git commit** and **git push** these new .mo and .po files to your GitHub fork of the project, and send a git pull request (<https://help.github.com/articles/using-pull-requests>) to the Airtime developers. The localization can then be added to a forthcoming Airtime release.
|
Finally, **git add**, **git commit** and **git push** these new .mo and .po files to your GitHub fork of the project, and send a git pull request (<https://help.github.com/articles/using-pull-requests>) to the Libretime developers. The localization can then be added to a forthcoming Libretime release.
|
||||||
|
|
||||||
If you don't want to work with git, that's no problem - download a copy of the .po template file, edit the header, run it through an automatic translator and check it with Poedit. Then email your contribution to the Airtime team as an attachment - it will be very welcome! However, learning to use git is a good idea, because it means you can work directly on the current source code, share the localization work with the Airtime community, and avoid duplicated effort.
|
If you don't want to work with git, that's no problem - download a copy of the .po template file, edit the header, run it through an automatic translator and check it with Poedit. Then email your contribution to the Libretime team as an attachment - it will be very welcome! However, learning to use git is a good idea, because it means you can work directly on the current source code, share the localization work with the Libretime community, and avoid duplicated effort.
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
This page of the Airtime interface enables you to search the media library, sort and display the search results by the criteria that you choose, audition library items, and drag and drop those items into a playlist. You can also adjust fade and cue points, create smart blocks (automatically generated playlists), or add incoming web streams to the library. The **Library** page is not visible to *Guest* users.
|
This page of the Libretime interface enables you to search the media library, sort and display the search results by the criteria that you choose, audition library items, and drag and drop those items into a playlist. You can also adjust fade and cue points, create smart blocks (automatically generated playlists), or add incoming web streams to the library. The **Library** page is not visible to *Guest* users.
|
||||||
|
|
||||||
Searching the library
|
Searching the library
|
||||||
---------------------
|
---------------------
|
||||||
|
@ -35,7 +35,7 @@ With a playlist open, click on an item in the search results and then click **Ad
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
You can also select or deselect a whole page of search results using the **Select** button, just below the simple search field. Alternatively, use the checkboxes in the first column of the search results table to select individual items, then click the **Add to current playlist** button. Items that you own which you no longer require can be deleted from Airtime's library using the **Trashcan** button.
|
You can also select or deselect a whole page of search results using the **Select** button, just below the simple search field. Alternatively, use the checkboxes in the first column of the search results table to select individual items, then click the **Add to current playlist** button. Items that you own which you no longer require can be deleted from Libretime's library using the **Trashcan** button.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
|
@ -43,7 +43,7 @@ After adding files to the playlist, the total playlist time is displayed in the
|
||||||
|
|
||||||
To audition a playlist file in your web browser, click the white triangle**** button on the left side of its row. (If the format of the file is not supported by your browser, the triangle in this button will be greyed out). If audition of the file format is supported, a pop-up window will open, with the playlist starting at the file you clicked.
|
To audition a playlist file in your web browser, click the white triangle**** button on the left side of its row. (If the format of the file is not supported by your browser, the triangle in this button will be greyed out). If audition of the file format is supported, a pop-up window will open, with the playlist starting at the file you clicked.
|
||||||
|
|
||||||
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. Click the **Clear** button to remove all content from the playlist, or click the **Delete** button to remove the playlist from the Airtime library altogether.
|
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. Click the **Clear** button to remove all content from the playlist, or click the **Delete** button to remove the playlist from the Libretime library altogether.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
|
@ -69,7 +69,7 @@ If a **Fade In** and **Cue In** are set on the same item in the playlist, the fa
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
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 Airtime interface.
|
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.
|
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.
|
||||||
|
|
||||||
|
@ -78,13 +78,13 @@ If you want to edit the playlist content or metadata later, you can find it by *
|
||||||
Creating a smart block
|
Creating a smart block
|
||||||
----------------------
|
----------------------
|
||||||
|
|
||||||
Smart blocks are automatically filled with media files from the Airtime library, according to the criteria that you specify. This feature is intended to save staff time, compared to selecting items for a playlist manually.
|
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.
|
||||||
|
|
||||||
To create a smart block, click the **New** button on the right side of the Library page, and select **New Smart Block** from the pop-up menu. Like a playlist, smart blocks can have a title and **Description**, which you can edit. This helps you find relevant smart blocks in searches.
|
To create a smart block, click the **New** button on the right side of the Library page, and select **New Smart Block** from the pop-up menu. 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 Airtime'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*.
|
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*.
|
||||||
|
|
||||||
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.
|
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.
|
||||||
|
|
||||||
|
@ -106,7 +106,7 @@ By default, a smart block will not contain repeated items, which will limit the
|
||||||
|
|
||||||
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.
|
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. The was the default behaviour with the Airtime software.
|
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. The was the default behaviour with the Libretime software.
|
||||||
|
|
||||||
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.
|
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.
|
||||||
|
|
||||||
|
@ -119,7 +119,7 @@ Once created, smart blocks can be found in Library searches and refined at any t
|
||||||
Adding a web stream
|
Adding a web stream
|
||||||
-------------------
|
-------------------
|
||||||
|
|
||||||
A web stream URL and metadata can be added to the Airtime 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 Airtime playout schedule.
|
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 right side of the Library page, and select **New Webstream** from the pop-up menu. Like a playlist, web streams in the Library can have a title and **Description**, which may help you find them in searches later.
|
To add a web stream, click the **New** button on the right side of the Library page, and select **New Webstream** from the pop-up menu. Like a playlist, web streams in the Library can have a title and **Description**, which may help you find them in searches later.
|
||||||
|
|
||||||
|
|
|
@ -6,7 +6,7 @@ This button opens a pop-up **Live stream** window, which enables you to monitor
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
Beneath the drop-down menu for stream selection is an orange volume control bar. This volume control only adjusts the output level of the pop-up **Live Stream** window, not the output level of the Airtime server itself. To adjust output level between muted and maximum, click on the corresponding place in the orange bar, with maximum level on the right side. Click on the left side speaker icon to mute the output.
|
Beneath the drop-down menu for stream selection is an orange volume control bar. This volume control only adjusts the output level of the pop-up **Live Stream** window, not the output level of the Libretime server itself. To adjust output level between muted and maximum, click on the corresponding place in the orange bar, with maximum level on the right side. Click on the left side speaker icon to mute the output.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
|
@ -14,4 +14,4 @@ To display the URL of the stream you are monitoring, so that you can copy and pa
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
When you have finished monitoring the streams, you can close the pop-up window in the normal way, depending on the browser you are using. In Firefox, you can close the window by clicking the **X** button in the top right corner. This action will not shut down the output from the Airtime server, only the stream monitoring on your desktop computer or laptop.
|
When you have finished monitoring the streams, you can close the pop-up window in the normal way, depending on the browser you are using. In Firefox, you can close the window by clicking the **X** button in the top right corner. This action will not shut down the output from the Libretime server, only the stream monitoring on your desktop computer or laptop.
|
||||||
|
|
|
@ -2,7 +2,7 @@ The Listener Stats page on the Analytics menu shows graphs of listener connectio
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
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 *airtime\_128*, on the **Streams** page of the **Settings** menu.
|
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.
|
||||||
|
|
||||||
By default, statistics for the last 24 hours of streaming are shown. To change this date and time range, click the calendar and clock icons in the lower left corner of the page, then click the magnifying glass icon.
|
By default, statistics for the last 24 hours of streaming are shown. To change this date and time range, click the calendar and clock icons in the lower left corner of the page, then click the magnifying glass icon.
|
||||||
|
|
||||||
|
|
|
@ -1,13 +1,13 @@
|
||||||
Mixxx is a cross-platform Open Source application for DJs, available from <http://www.mixxx.org/>
|
Mixxx is a cross-platform Open Source application for DJs, available from <http://www.mixxx.org/>
|
||||||
|
|
||||||
Installed on a desktop or laptop computer, Mixxx complements your Airtime server to provide a complete system for both live and scheduled broadcasting. Although Mixxx has many features designed for dance music DJs that require beat matching and pitch independent time stretching, the program can be used for any kind of manually triggered broadcast playout, including live speech shows such as news or current affairs.
|
Installed on a desktop or laptop computer, Mixxx complements your Libretime server to provide a complete system for both live and scheduled broadcasting. Although Mixxx has many features designed for dance music DJs that require beat matching and pitch independent time stretching, the program can be used for any kind of manually triggered broadcast playout, including live speech shows such as news or current affairs.
|
||||||
|
|
||||||
Mixxx supports a wide variety of popular hardware control surfaces, which can be connected to your 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 supports a wide variety of popular hardware control surfaces, which can be connected to your 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.
|
||||||
|
|
||||||
Sound cards
|
Sound cards
|
||||||
-----------
|
-----------
|
||||||
|
|
||||||
If you wish to use Airtime and Mixxx on the same machine, you will need two or more sound cards, as each program requires exclusive access to the sound hardware. Otherwise, you may see an error message that Mixxx cannot access the sound device.
|
If you wish to use Libretime and Mixxx on the same machine, you will need two or more sound cards, as each program requires exclusive access to the sound hardware. Otherwise, you may see an error message that Mixxx cannot access the sound device.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
|
@ -18,45 +18,27 @@ The solution is to configure Mixxx to use additional sound cards by clicking **O
|
||||||
Sharing storage
|
Sharing storage
|
||||||
---------------
|
---------------
|
||||||
|
|
||||||
If you make the Airtime server's storage directory */srv/airtime/stor/* accessible to a desktop machine as a read-only location, Mixxx will accept that location as its default music library when starting up for the first time. (This location can also be configured after installation by clicking **Options**, **Preferences**, then **Library** in the main Mixxx menu).
|
If you make the Libretime server's storage directory */srv/airtime/stor/* accessible to a desktop machine as a read-only location, Mixxx will accept that location as its default music library when starting up for the first time. (This location can also be configured after installation by clicking **Options**, **Preferences**, then **Library** in the main Mixxx menu).
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
You may need to adjust file and directory permissions so that the storage directory has read access from the desktop user account. Enabling write access directly to the storage server is not recommended, as this would allow desktop users to delete files which might be needed for playout later.
|
You may need to adjust file and directory permissions so that the storage directory has read access from the desktop user account. Enabling write access directly to the storage server is not recommended, as this would allow desktop users to delete files which might be needed for playout later.
|
||||||
|
|
||||||
If the filesystem path has been configured correctly, the metadata for the files in the Airtime storage server will be displayed in the main window of the Mixxx interface. Individual files from the Airtime storage server can then be added to either of Mixxx's live players with a right-click on the filename, or by using the appropriate hardware buttons on a control surface. Therefore it is possible to manage the station's storage archive remotely and collaboratively through Airtime, while using Mixxx as the live playout client in multiple, remote studios.
|
If the filesystem path has been configured correctly, the metadata for the files in the Libretime storage server will be displayed in the main window of the Mixxx interface. Individual files from the Libretime storage server can then be added to either of Mixxx's live players with a right-click on the filename, or by using the appropriate hardware buttons on a control surface. Therefore it is possible to manage the station's storage archive remotely and collaboratively through Libretime, while using Mixxx as the live playout client in multiple, remote studios.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
The Airtime storage archive can be exported like any other file server share. The method that you implement would depend on the operating system of your desktop client machines, and whether they were on the same local network as the Airtime server, or remote.
|
The Libretime storage archive can be exported like any other file server share. The method that you implement would depend on the operating system of your desktop client machines, and whether they were on the same local network as the Libretime server, or remote.
|
||||||
|
|
||||||
For performance and redundancy reasons it is advisable to cache files required for a particular show on the client machine where Mixxx is installed. For example, for a GNU/Linux client machine, a nightly **rsync** download of new media in the archive would guard against network problems at playout time potentially disrupting a broadcast at a remote studio.
|
For performance and redundancy reasons it is advisable to cache files required for a particular show on the client machine where Mixxx is installed. For example, for a GNU/Linux client machine, a nightly **rsync** download of new media in the archive would guard against network problems at playout time potentially disrupting a broadcast at a remote studio.
|
||||||
|
|
||||||
Mixxx users can also record a show, and then upload it through the Airtime web interface on a local or remote server for collaborative or user-generated broadcasts.
|
Mixxx users can also record a show, and then upload it through the Libretime web interface on a local or remote server for collaborative or user-generated broadcasts.
|
||||||
|
|
||||||
Streaming from Mixxx into Airtime
|
Streaming from Mixxx into Libretime
|
||||||
---------------------------------
|
---------------------------------
|
||||||
|
|
||||||
Mixxx 1.9.0 or later includes a live streaming client which, like Airtime, is compatible with the **Icecast** and **SHOUTcast** media servers. This feature can also be used to stream from Mixxx directly into Airtime, using either the **Show Source** or **Master Source**.
|
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 Airtime, 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 Airtime **Streams** page, on Airtime's **System** menu. See the chapter *Stream settings* for remote input connection details.
|
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 the chapter *Stream settings* for remote input connection details.
|
||||||
|
|
||||||
Airtime skins for Mixxx
|
|
||||||
-----------------------
|
|
||||||
|
|
||||||
Airtime-themed skins for Mixxx, designed with broadcast users in mind, are available for download from <https://github.com/Airtime/MixxxSkins>
|
|
||||||
|
|
||||||
These skins provide a simplified interface for live broadcasting which do away with EQ, flange effect, looping and other features required by dance music DJs. Instead, the emphasis is on a clear and uncluttered interface which does not require large mouse movements to operate the most important controls. There are versions available both with and without pitch/tempo controls for beat matching.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
After downloading one of the skins, extract the zip file and copy it to the *skins* directory on the computer where Mixxx is installed. For example, on Debian or Ubuntu:
|
|
||||||
|
|
||||||
unzip Airtime1280x1024_skin_for_Mixxx.zip
|
|
||||||
sudo cp -r Airtime1280x1024 /usr/share/mixxx/skins/
|
|
||||||
|
|
||||||
Then, start Mixxx and select the Airtime skin by clicking **Options**, **Preferences**, then **Interface** in the Mixxx main menu.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
Loading…
Reference in New Issue