Merge branch 'master' into smartblock-overflow
This commit is contained in:
commit
c7b55f60e4
72 changed files with 3804 additions and 3949 deletions
|
@ -9,7 +9,7 @@ In the top left corner of the page, you can go back or forward through the **Cal
|
|||
Adding a show
|
||||
-------------
|
||||
|
||||
Only *Admins* and *Program Managers* can use this feature. To add a new show to the Calendar, click the **+ New Show** button in the top left corner of the page, or click on any future row or box in the Calendar which is empty. Either of these actions opens the **Add this show** box, which has seven sections, arranged vertically: **What**, **Automatic Playlist**, **When**, **Live Stream Input**, **Record & Rebroadcast**, **Who**, and **Style**. Click the small orange triangle to the left of the section name if you wish to minimize or maximize it.
|
||||
Only *Admins* and *Program Managers* can use this feature. To add a new show to the Calendar, click the **+ New Show** button in the top left corner of the page, or click on any future row or box in the Calendar which is empty. Either of these actions opens the **Add this show** box, which has seven sections, arranged vertically: **What**, **Autoloading Playlist**, **When**, **Live Stream Input**, **Record & Rebroadcast**, **Who**, and **Style**. Click the small orange triangle to the left of the section name if you wish to minimize or maximize it.
|
||||
|
||||
What
|
||||
----
|
||||
|
@ -18,7 +18,7 @@ In the **What** box, enter the **Name**, public website **URL**, **Genre** and *
|
|||
|
||||

|
||||
|
||||
Automatic Playlist
|
||||
Autoloading Playlist
|
||||
------------------
|
||||
|
||||
In this section, you can select a playlist that will be used for this show. The playlist must already be defined in your library. **Auto Schedule Playlist** needs to be checked for **Select Playlist** and **Repeat AutoPlaylist Until Show is Full** to be visible.
|
||||
|
@ -64,15 +64,7 @@ A reminder of the connection **Host**, **Port** and **Mount** for the live input
|
|||
Record & Rebroadcast
|
||||
--------------------
|
||||
|
||||
In the **Record & Rebroadcast** section, checking the **Record from Line In?** box enables automatic recording of the soundcard line input, if your LibreTime server has one, at the time of the show. Shows set for line-in recording should not also contain files or playlists. The default audio format for live recordings is 256kbps Ogg Vorbis, and the files are saved in the *recorded* folder, under the **Import Folder** path set in the **Media Folders** page on the **System** menu. See the chapter *Host configuration* for details of recorder settings.
|
||||
|
||||
If you wish the recording to be played out at a later time, check the **Rebroadcast?** box, and then select up to ten date and time slots in the **Choose Days** box.
|
||||
|
||||

|
||||
|
||||
Shows set for rebroadcast have a white loop icon in the calendar.
|
||||
|
||||

|
||||
The **Record & Rebroadcast** section is currently not working, and so has been removed from the web interface. If this feature is important to you, please search for relevant issues in the [LibreTime github repository](https://github.com/LibreTime/libretime/search?q=record&type=Issues) and help us make it happen!
|
||||
|
||||
Who
|
||||
---
|
||||
|
|
|
@ -1,16 +1,17 @@
|
|||
If the server is only being used for Airtime and has a web browser installed, you can access the administration interface directly on that server by opening the address:
|
||||
If the server is only being used for LibreTime and has a web browser installed, you can access the administration interface directly on that server by opening the address:
|
||||
|
||||
http://localhost/
|
||||
|
||||
If you have set up Airtime so that it can be accessed from other computers, you would use a domain name instead. For example:
|
||||
If you have set up LibreTime so that it can be accessed from other computers, you would use a domain name instead. For example:
|
||||
|
||||
https://airtime.example.com/
|
||||
https://libretime.example.com/
|
||||
|
||||
You can log in for the first time with the user name *admin* and the password set during installation. Your browser should automatically focus on the **Username** field.
|
||||
|
||||

|
||||

|
||||
|
||||
If you enter the password incorrectly three times, you will be presented with a reCAPTCHA challenge to prove that you are a human, and not a password-guessing robot. This feature helps protect your Airtime installation against brute force attacks.
|
||||
If you enter the password incorrectly three times, you will be presented with a reCAPTCHA challenge to prove that you are a human, and not a password-guessing robot. This feature helps protect your LibreTime installation against brute force
|
||||
attacks.
|
||||
|
||||

|
||||
|
||||
|
@ -22,50 +23,48 @@ The **E-mail** address you enter must match the address stored in the database f
|
|||
|
||||

|
||||
|
||||
Register Airtime
|
||||
----------------
|
||||
|
||||
After you have logged in as *admin* for the first time, a pop-up window will ask if you wish to send technical support data about your server to Sourcefabric.
|
||||
|
||||

|
||||
|
||||
These details can be viewed by clicking on the **Show me what I am sending** link, which expands a scrolling window. The data helps Sourcefabric engineers resolve any problems with your Airtime installation, as well as count the number of installations worldwide.
|
||||
|
||||
<img src="static/Screenshot546-Remind_me_never_250.png" width="535" height="275" />
|
||||
|
||||
Sourcefabric has a privacy policy regarding data collection, which you can read by clicking the link to <http://www.sourcefabric.org/en/about/policy/> further down. After checking the **Send support feedback** and **privacy policy** boxes, you can submit the data by clicking the **Yes, help Airtime** button.
|
||||
|
||||
This window also offers the opportunity to **Promote my station on Sourcefabric.org** (on the page <http://www.sourcefabric.org/en/airtime/whosusing/>) by checking the box. Fill in the form which will appear with some details about your station. The contact details are only requested for verification purposes, and will not be made available to the public. Click the **Browse** button to select a **Station Logo** image from the file manager on your computer.
|
||||
|
||||

|
||||
|
||||
The Master Panel
|
||||
----------------
|
||||
|
||||
After the pop-up window is closed, you should now see the **Master Panel**, which is present at the top of every page of the Airtime interface. On the left hand side, the Master Panel displays the details of the **Previous** file played out, the current file playing (with an orange progress bar and time elapsed/time remaining), and the details of the **Next** file due to play. It also displays the name and scheduled time of the current show, with a blue progress bar.
|
||||
The **Master Panel** is present at the top of every page of the LibreTime interface. On the left hand side, the Master Panel displays the details of the **Previous** file played out,
|
||||
the current file playing (with an orange progress bar and time elapsed/time remaining), and the details of the **Next**
|
||||
file due to play. It also displays the name and scheduled time of the current show, with a blue progress bar.
|
||||
|
||||
Beneath this side of the Master Panel is the main navigation menu, with sub-menus labelled **Now Playing**, **Add Media**, **Library**, **Calendar**, **System**, **History** and **Help**. We'll be looking at the contents of these menus in the following chapters of this book.
|
||||

|
||||
|
||||
<img src="static/Screenshot542-Main_menus_250.png" width="595" height="145" />
|
||||
Beneath this side of the Master Panel is the main navigation menu. We'll be looking at the contents of these menus in the
|
||||
following chapters of this book.
|
||||
|
||||
On the right hand side of the Master Panel are the switches for the **Source Streams**, which enable you to switch from scheduled play to remote live sources, and back. (See the chapter *Stream settings* for details of this feature). The **On Air** indicator turns from dark grey to red whenever audio is being played out. Underneath this indicator is a **Listen** button, which opens a pop-up player that can be used to audition the available playout streams.
|
||||

|
||||
|
||||
There is also a clock indicating the **Station time** and time zone. Beneath the clock and just to the left, the name of the user currently logged in is displayed, and there is the link for you to **Logout**.
|
||||
On the right hand side of the Master Panel are the switches for the **Source Streams**, which enable you to switch from
|
||||
scheduled play to remote live sources, and back. (See the chapter *Stream settings* for details of this feature). The
|
||||
**On Air** indicator turns from dark grey to red whenever audio is being played out. Underneath this indicator is a
|
||||
**Listen** button, which opens a pop-up player that can be used to audition the available playout streams.
|
||||
|
||||
There is also a clock indicating the **Station time** and time zone. Beneath the clock and just to the left, the name of
|
||||
the user currently logged in is displayed, and there is the link for you to **Logout**.
|
||||
|
||||

|
||||
|
||||
Clicking the username link opens a page in which you can update your Airtime password, contact details, language and time zone preferences. Click the **Save** button once you have made the changes that you require.
|
||||
Clicking the username link opens a page in which you can update your LibreTime password, contact details, language and time
|
||||
zone preferences. Click the **Save** button once you have made the changes that you require.
|
||||
|
||||

|
||||
|
||||
On the right of the Logout link, clicking the green check mark opens a pop-up window with information about the version of Airtime installed. If your Airtime installation is not the latest version available, the green check mark changes to a green upgrade arrow. Should your Airtime installation get too far out of date, this arrow will change to a red exclamation mark.
|
||||
On the right of the Logout link, clicking the green check mark opens a pop-up window with information about the version of
|
||||
LibreTime installed. If your LibreTime installation is not the latest version available, the green check mark changes to a
|
||||
green upgrade arrow. Should your LibreTime installation get too far out of date, this arrow will change to a red exclamation
|
||||
mark.
|
||||
|
||||
<img src="static/Screenshot543-Running_latest_version_250.png" width="595" height="230" />
|
||||
|
||||
Checking an Icecast server
|
||||
--------------------------
|
||||
|
||||
If you have installed an Icecast streaming media server, you can check that Icecast is running by opening its default server port of 8000 in your web browser. For example, on the server itself, you can use:
|
||||
If you have installed an Icecast streaming media server, you can check that Icecast is running by opening its default server
|
||||
port of 8000 in your web browser. For example, on the server itself, you can use:
|
||||
|
||||
http://localhost:8000
|
||||
|
||||
|
@ -73,6 +72,7 @@ or from another machine, using the domain name of the Icecast server:
|
|||
|
||||
http://streaming.example.com:8000
|
||||
|
||||
You should see the Icecast status page, with details of any connections that your Airtime server has made to this Icecast server. If you have only just installed Airtime, there may not be any media playing out yet.
|
||||
You should see the Icecast status page, with details of any connections that your LibreTime server has made to this Icecast
|
||||
server. If you have only just installed LibreTime, there may not be any media playing out yet.
|
||||
|
||||

|
||||
|
|
BIN
docs/manual/getting-started/static/Screenshot-Login.png
Normal file
BIN
docs/manual/getting-started/static/Screenshot-Login.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 57 KiB |
BIN
docs/manual/getting-started/static/Screenshot-MainMenu.png
Normal file
BIN
docs/manual/getting-started/static/Screenshot-MainMenu.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 34 KiB |
BIN
docs/manual/getting-started/static/Screenshot-MasterPanel.png
Normal file
BIN
docs/manual/getting-started/static/Screenshot-MasterPanel.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 12 KiB |
Binary file not shown.
Before Width: | Height: | Size: 60 KiB |
Binary file not shown.
Before Width: | Height: | Size: 20 KiB |
|
@ -234,12 +234,7 @@ and then run the command (as root):
|
|||
|
||||
This should make sure that **rabbitmq-server** starts after the next reboot.
|
||||
|
||||
libav on Debian squeeze and .m4a files
|
||||
--------------------------------------
|
||||
|
||||
The version of libav shipped with Debian 6.0 'squeeze' is known to cause problems when Airtime analyses .m4a files containing the AAC codec for silence, using Silan (see <https://github.com/x42/silan/issues/2>). It is recommended that Debian servers are upgraded to the current stable 'wheezy' 7.2 release. As a short-term measure, updated libav packages from the squeeze-backports repository can be used to work around this problem. This work-around is only required if you do not wish to upgrade to 'wheezy' yet, but have AAC codec .m4a files in your Airtime library.
|
||||
|
||||
Mail server
|
||||
-----------
|
||||
|
||||
If you wish Airtime to be able to send password reminder emails to your staff users, the server can have an SMTP program installed, such as the **postfix** package in Debian or Ubuntu. For configuration options, refer to the documentation for your mail server of choice. Alternatively, you can specify an external SMTP server in the **Preferences** page on Airtime's **System** menu.
|
||||
If you wish Airtime to be able to send password reminder emails to your staff users, the server can have an SMTP program installed, such as the **postfix** package in Debian or Ubuntu. For configuration options, refer to the documentation for your mail server of choice. Alternatively, you can specify an external SMTP server in the **Preferences** page on Airtime's **System** menu.
|
||||
|
|
|
@ -1,5 +1,6 @@
|
|||
LibreTime 3.x versions support upgrading from Airtime 2.5.x versions. LibreTime
|
||||
follows the [Semantic Versioning (semver)](http://semver.org/spec/v2.0.0.html) standards.
|
||||
## LibreTime versioning
|
||||
|
||||
LibreTime 3.x versions support upgrading from Airtime 2.5.x versions. LibreTime follows the [Semantic Versioning (semver)](http://semver.org/spec/v2.0.0.html) standards.
|
||||
|
||||
In a nutshell, given a version number MAJOR.MINOR.PATCH we increment the:
|
||||
|
||||
|
@ -7,45 +8,17 @@ In a nutshell, given a version number MAJOR.MINOR.PATCH we increment the:
|
|||
2. MINOR version when we add functionality in a backwards-compatible manner, and
|
||||
3. PATCH version when we make backwards-compatible bug fixes.
|
||||
|
||||
Any pre-release versions of LibreTime are denoted by appending a hyphen and a series
|
||||
of dot separated identifiers immediately following the patch version. This pre-release
|
||||
indicates that the version is unstable in a sense that it might contain incomplete
|
||||
features or not satisfy the intended compatibility requirements as per semver.
|
||||
Any pre-release versions of LibreTime are denoted by appending a hyphen and a series of dot separated identifiers immediately following the patch version. This pre-release indicates that the version is unstable in a sense that it might contain incomplete features or not satisfy the intended compatibility requirements as per semver.
|
||||
|
||||
Before upgrading a production LibreTime server, you should back up both the PostgreSQL
|
||||
database and the storage server used by LibreTime. This is especially important if you
|
||||
have not already set up a regular back up routine. This extra back up is a safety measure
|
||||
in case of accidental data loss during the upgrade, for example due to the wrong command
|
||||
being entered when moving files. See [Backing up the server](../backing-up-the-server/)
|
||||
in this manual for details of how to perform these back ups.
|
||||
## Upgrading
|
||||
|
||||
If you have deployed LibreTime using the method shown in [Automated installation](../automated-installation/),
|
||||
you can upgrade in the same way. A new LibreTime package available in
|
||||
the repository can be installed with:
|
||||
Before upgrading a production LibreTime server, you should back up both the PostgreSQL database and the storage server used by LibreTime. This is especially important if you have not already set up a regular back up routine. This extra back up is a safety measure in case of accidental data loss during the upgrade, for example due to the wrong command being entered when moving files. See [Backing up the server](../backing-up-the-server/) in this manual for details of how to perform these back ups.
|
||||
|
||||
sudo apt-get update
|
||||
sudo apt-get upgrade
|
||||
The LibreTime [installation script](../install) will detect an existing LibreTime or Airtime deployment and back up any configuration files that it finds. We recommend taking your own manual backups of the configuration yourself nevertheless. The install script also tries to restart the needed services during an upgrade. In any case you should monitor if this happened and also take a quick look at the logs files to be sure everything is still fine. Now might be the time to reboot the system or virtual machine LibreTime is running on since regular reboots are part of a healthy system anyway.
|
||||
|
||||
If you have used the method shown in [Manual installation](../manual-installation/), you should
|
||||
repeat the installation steps of downloading and unpacking the tarball to an
|
||||
installation directory, or pulling from the git repository with `git pull`, and
|
||||
running the `./install` script. The installation script will detect an existing
|
||||
LibreTime deployment and back up any configuration files that it finds. We recommend
|
||||
taking your own manual backups of the configuration yourself nevertheless.
|
||||
After the upgrade has completed, you may need to clear your web browser's cache before logging into the new version of the LibreTime administration interface. If the playout engine starts up and detects that a show should be playing at the current time, it will skip to the correct point in the current item and start playing.
|
||||
|
||||
The install script tries to restart the needed services during an upgrade. In any case
|
||||
you should monitor if this happened and also take a quick look at the logs files to
|
||||
be sure everything is still fine. Now might be the time to reboot the system or
|
||||
virtual machine LibreTime is running on since regular reboots are part of a healthy
|
||||
system anyway.
|
||||
|
||||
After the upgrade has completed, you may need to clear your web browser's cache
|
||||
before logging into the new version of the LibreTime administration interface. If
|
||||
the playout engine starts up and detects that a show should be playing at the
|
||||
current time, it will skip to the correct point in the current item and start playing.
|
||||
|
||||
There will be tested ways to switch from a LibreTime pre-release to a packaged version
|
||||
of LibreTime.
|
||||
There will be tested ways to switch from a LibreTime pre-release to a packaged version of LibreTime.
|
||||
|
||||
Airtime 2.5.x versions support upgrading from version 2.3.0 and above. If you are
|
||||
running a production server with a version of Airtime prior to 2.3.0, you should
|
||||
|
|
|
@ -1,76 +1,9 @@
|
|||
[Sourcefabric Manuals](http://sourcefabric.booktype.pro/)
|
||||
|
||||
- [Sign In / Create Account](http://sourcefabric.booktype.pro/accounts/signin/?redirect=/airtime-25-for-broadcasters/using-the-airtime-import-script/)
|
||||
|
||||
English | <a href="index.html#" class="langes">Español</a> | <a href="index.html#" class="langfr">Français</a> | <a href="index.html#" class="langit">Italiano</a> | <a href="index.html#" class="langpt">Português</a> | <a href="index.html#" class="langru">Русский</a> | <a href="index.html#" class="langsq">Shqip</a>
|
||||
|
||||
- [Books](http://sourcefabric.booktype.pro/list-books/)
|
||||
- [Groups](http://sourcefabric.booktype.pro/list-groups/)
|
||||
- [People](http://sourcefabric.booktype.pro/list-people/)
|
||||
|
||||
Airtime 2.5 for Broadcasters
|
||||
----------------------------
|
||||
|
||||
- **Introduction**
|
||||
- [What is Airtime?](../index.html)
|
||||
- [Rights and royalties](../rights-and-royalties/index.html)
|
||||
- **Using Airtime**
|
||||
- [On air in 60 seconds!](../on-air-in-60-seconds/index.html)
|
||||
- [Getting started](../getting-started/index.html)
|
||||
- [Smartphone journalism](../smartphone-journalism/index.html)
|
||||
- **The System menu**
|
||||
- [Preferences](../preferences/index.html)
|
||||
- [Users](../users/index.html)
|
||||
- [Media folders](../media-folders/index.html)
|
||||
- [Stream settings](../stream-settings/index.html)
|
||||
- [Support feedback](../support-feedback/index.html)
|
||||
- [Status](../status/index.html)
|
||||
- [Listener stats](../listener-stats/index.html)
|
||||
- **The main menus**
|
||||
- [Now playing](../now-playing/index.html)
|
||||
- [Add media](../add-media/index.html)
|
||||
- [Library](../library/index.html)
|
||||
- [Calendar](../calendar/index.html)
|
||||
- [History](../playout-history/index.html)
|
||||
- [Listen](../listen/index.html)
|
||||
- [Help](../help/index.html)
|
||||
- **Airtime in the studio**
|
||||
- [Recording shows](../recording-shows/index.html)
|
||||
- [Live shows with Mixxx](../live-shows-with-mixxx/index.html)
|
||||
- [Icecast and SHOUTcast](../icecast-and-shoutcast/index.html)
|
||||
- **Installation**
|
||||
- [Preparing the server](../preparing-the-server/index.html)
|
||||
- [Easy setup](../easy-setup/index.html)
|
||||
- [Automated installation](../automated-installation/index.html)
|
||||
- [Manual installation](../manual-installation/index.html)
|
||||
- [Setting the server time](../setting-the-server-time/index.html)
|
||||
- **Administration**
|
||||
- [Preparing media for ingest](../preparing-media-for-ingest/index.html)
|
||||
- [Using the airtime-import script](index.html)
|
||||
- [The airtime-log command](../the-airtime-log-command/index.html)
|
||||
- [Backing up the server](../backing-up-the-server/index.html)
|
||||
- [Upgrading](../upgrading/index.html)
|
||||
- [Troubleshooting](../troubleshooting/index.html)
|
||||
- [Using Monit](../using-monit/index.html)
|
||||
- **Advanced configuration**
|
||||
- [Automated file import](../automated-file-import/index.html)
|
||||
- [Icecast handover](../icecast-handover/index.html)
|
||||
- [Promoting your station](../promoting-your-station/index.html)
|
||||
- [Stream player for your website](../stream-player-for-your-website/index.html)
|
||||
- [Exporting the schedule](../exporting-the-schedule/index.html)
|
||||
- [Interface customization](../interface-customization/index.html)
|
||||
- [Interface localization and Git](../interface-localization/index.html)
|
||||
- [Host configuration](../host-configuration/index.html)
|
||||
- [Airtime API authentication](../airtime-api-authentication/index.html)
|
||||
- [Secure login with SSL or TLS](../secure-login-with-ssl/index.html)
|
||||
- [Icecast statistics with Piwik](../icecast-statistics-with-piwik/index.html)
|
||||
- **Appendix**
|
||||
- [HD Audio Models](../hd-audio-models/index.html)
|
||||
- [About this manual](../about-this-manual/index.html)
|
||||
|
||||
Using the import script
|
||||
=======================
|
||||
|
||||
###NOTE: This page has issues, as the import script is not currently functional
|
||||
|
||||
|
||||
If you have a large number of files in your media library, importing these files one at a time into a broadcast automation system would be time-consuming and tedious. That's why Airtime includes a script that can import an entire directory of files in one go.
|
||||
|
||||
Copying versus watching
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue