Pre-release
Pre-release

@hairmare hairmare released this Oct 13, 2018 · 6 commits to master since this release

Assets 3

The complete LibreTime documentation is available at libretime.org.

The full tarball for the 3.0.0-alpha.5 release of LibreTime is available here.

Since this is an alpha release there will be bugs in the code. Please report new issues and/or feature requests in the issue tracker.

Table of Contents

Features

  • Interface improvements
  • Raspbian 9 support in installer script
  • Allow skipping RabbitMQ and PostgreSQL install in installer script with --no-rabbitmq and --no-postgres

Bugfixes

  • Remove [media-monitor] section from default install (look here for workaround)
  • Fix last help links that pointed to sourcefabric and update others to point to discourse
  • Fix for ShoutCAST DNAS rejecting title updates when artist is missing
  • Initial fixes for native IPv6 support
  • Support modern pika versions
  • Disable podcast subscription limit
  • Return proper Content-Length for legacy database entries missing the info

Deprecated Features

Updating

See the docs for complete information on updating. Please ensure that you have proper backups and a rollback scenario in place before updating.
If the update does not go smoothly, it may cause significant downtime, so you should always have a fallback system available during the update to ensure broadcast continuity.

If you installed from GitHub you can git pull in you local working copy and re-run the ./install script with the same --web-root and --web-user arguments you used during the initial install. Tarball users can leave out the git pull part and just call the new version of the install script.

Updating from 3.0.0-alpha or 3.0.0-alpha.2

The configuration file structure has changed. Please move the contents of the /etc/airtime/cloud_storage.conf and /etc/airtime/rabbitmq-analyzer.ini files into the main /etc/airtime/airtime.conf. In all known cases you need to add the following section to the file.

[current_backend]
storage_backend=file

You can then remove the files and the symlink.

rm /etc/airtime/cloud_storage.conf \
   /etc/airtime/rabbitmq-analyzer.ini \
   /etc/airtime/production

While you're at you may also want to remove the amazon_s3 section if it was in any of the files.

Analyzer grabs all the needed info from the main airtime.conf file starting with 3.0.0-alpha.5.

Deprecation Announcement for Ubuntu 14.04 (Trusty)

Up until 3.0.0-alpha.4 Ubuntu 14.04 (Trusty) was in the list of supported distros.

Given that Ubuntu 16.04 (Xenial) and Ubuntu 18.04 (Bionic) are now available and Trusty is EOL in April 2019 LibreTime has to update its support matrix. This info is in the release notes as an early warning since we are deprecating a major os version with an upcoming release.

Known Issues

The following issues may need a workaround for the time being. Please search the issues before reporting problems not listed below.

Media-Monitor config needs manual removing

If you are using the install script you should most likely remove the [media-monitor] config section from your /etc/airtime/airtime.conf file to ensure you do not run into the problems described in
#450. We recommend you do this before running the update since there are no known LibreTime releases that depend on the config value.

Outdated silan reports unreliable cue in/out information

Out of the box the installer installs a broken, outdated version of silan on most Debian based Platforms (ie. Ubuntu). This affects all distros supported by the installer except Debian unstable which has the silan 0.3.3 and CentOS which does not have upstream packages and you may either install from source or use the 0.3.3 packages from RaBe APEL.

You can check the version of silan by running with silan --version which should report 0.3.3 or with sudo dpkg -s silan | awk '/Version/ {print $2}' that will show the exact package version you installed. Please include this information if you file bugs concerning silan.

There are multiple workarounds to this issue and a bug against the upstream has been fixed. Kyle Robbertze @paddatrapper has taken over maintainership of the silan packages in Debian as he is currently packaging LibreTime for Debian. The silan package is in testing as can be seen in the Debian PTS. This section will get updated once the package is in stable.

Until this is sorted you should pre-install silan from a source you trust. If your distro has not updated to 0.3.3 yet you can also help by asking your distros maintainers for a bump.

The following solutions have been reported to work. If they do not work, please note that it is your responsibility to get working silan packages.

Silan from OBS build (#177 (comment))

Works for all relevant Debian and Ubuntu distros and installs silan 0.3.3~nmu1.

# install package signing key from obs
wget -qO- http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_7.0/Release.key \
  | apt-key add -

# add OBS repo to sources list (pick the distro you need)

# Debian Stretch
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_9.0_standard/ ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Debian Jessie
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_8.0 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Ubuntu Xenial
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/xUbuntu_16.04 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Ubuntu Trusty (14.04) EOL in April 2019
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/Ubuntu_14.10_standard/ ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list

# update local package database
apt-get update

# install silan 0.3.3 from obs packages
apt-get install silan

Local armhf builds for Raspberry Pi 3 (#214 (comment))

Since build.opensuse.org can't build Debian packages on arm due to missing dependencies, the 0.3.3~nmu1 arm package was built in a docker crossdev environment. This is reported to work on Debian Jessie on a Raspberry Pi 3 Model B.

curl -L -O https://github.com/LibreTime/libretime/files/1049738/silan_0.3.3.nmu1_armhf.deb.tar.gz
tar xvf silan_0.3.3.nmu1_armhf.deb.tar.gz
sudo dpkg -i silan_0.3.3~nmu1_armhf.deb

Legacy upstream silan packages (#197)

Legacy upstream hosts patched packages for Ubuntu Trusty on apt.sourcefabric.org. They install as 0.3.2~trusty~sfo-1.

sudo tee -a /etc/apt/sources.list <<EOD
deb http://apt.sourcefabric.org/ trusty main
EOD

sudo apt-get update
sudo apt-get install sourcefabric-keyring
sudo apt-get update
sudo apt-get install --reinstall silan=0.3.2~trusty~sfo-1

Remove silan completely (#193 (comment))

It is worth mentioning that you can disable cue point detection by removing silan from the system.

sudo apt-get uninstall silan

Reportedly this might have side effects.

Liquidsoap Support

Libretime currently only supports liquidsoap < 1.3.0 out of the box. If you install a current version of liquidsoap using OPAM or through the Rabe Liquidsoap Distribution for CentOS (RaBe LSD) you will most likely have liquidsoap 1.3.2 or 1.3.3 installed.

#352 reports that liquidsoap < 1.3.0 can exhibit issues on some Debian based installs. One fix for the issue is to install liquidsoap 1.3.0 and to use the following patching steps. Kyle from silan fame is taking the needed steps to get liquidsoap maintained again in Debian so we expect the situation to improve over time.

You can check your liquidsoap version by running liquidsoap --version.

If you already have liquidsoap >= 1.3.0 you have a couple of options.

Liquidsoap 1.3.0 Patchset (#192)

You can patch your installation of LibreTime to support liquidsoap 1.3.0.

An up to date patch is available through GitHub and can be applied to an unpacked tarball as follows.

cd libretime-3.0.0-alpha.5/
curl -L https://github.com/LibreTime/libretime/compare/master...radiorabe:feature/liquidsoap-1.3.0.patch | patch -p1

Git users can pull from the branch at master...radiorabe:feature/liquidsoap-1.3.0 directly.

Install old liquidsoap from opam (#192)

You can downgrade an OPAM install of liquidsoap by running the following command.

opam install "liquidsoap<1.3.0"

No watched folder support

Currently LibreTime does not support watching folders as described in the manual. Uploading files through the web interface works fine and can be automated via a REST API. Re-implementing watched folder support is on the roadmap. Please consider helping out with the code to help speed things along if you want to use the feature.

No line in support

Line In recording can be enabled in the UI but doesn't currently work. This feature went missing from LibreTime due to the fact that we based our code off of the saas-dev branch of legacy upstream and support for recording hasn't been ported to the new airtime analyzer ingest system. #42 currently tracks the progress being made on line in recording.

Playout wont work if locale is missing

Some minimal OS installs do not have a default locale configured. This only seems to affect some VPS installs as they often do not have a locale setup in the default images provided.

You can set up the locale using a combination of the following command. You might also want to consult the documentation of your VPS provider as it may contain an official way to set up locales when provisioning a VPS.

# Set locale using systemds localectl
localectl set-locale LANG="en_US.utf8"

These instructions do not seem to work on all Debian based distros so you might need to use update-locale as follows.

#Purge all locales but en_US.UTF-8
sudo locale-gen --purge en_US.UTF-8
#Populate LANGUAGE=
sudo update-locale LANGUAGE="en_US.UTF-8"

Lack of i18n toolchain is disturbing

Some translations might miss the tarball. They didn't get lost but the build chain needs fixing. Work is in #301 and additional work is needed as it has become clear that we proabably want to support bidirectional translation syncing with zanata.

Colophon

Sorry for the late release, RelEng has been busy with adulting and generally having a life as of lately. I'm still very much committed to LibreTime but can only find a limited amount of time to look into Issues due to beeing busy qualifying LibreTime for production workloads at my station. I plan on re-shifting my focus on pull request reviews and RelEng to address my lack of time going further.

Pre-release
Pre-release

@hairmare hairmare released this Feb 3, 2018 · 90 commits to master since this release

Assets 3

The complete LibreTime documentation is available at libretime.org.

The full tarball for the 3.0.0-alpha.4 release of LibreTime is available here.

Since this is an alpha release there will be bugs in the code. Please report new issues and/or feature requests in the issue tracker.

Table of Contents

Features

  • Updated Hungarian translations
  • Preview tracks in generated SmartBlocks
  • New icon to mark autoplaylist based show on calendar page
  • Relative date filters for Smartblocks

Bugfixes

  • Fix updating track information from pypo on TLS only setups
  • Fix seeking in track preview
  • Fix advanced search in calendar mode
  • Validate contents of VERSION file to fix non-enriched git tarball install
  • dead code removal of legacy media-monitor code base

Deprecated Features

Updating

See the docs for complete information on updating. Please ensure that you have proper backups and a rollback scenario in place before updating.
If the update does not go smoothly, it may cause significant downtime, so you should always have a fallback system available during the update to ensure broadcast continuity.

If you installed from GitHub you can git pull in you local working copy and re-run the ./install script with the same --web-root and --web-user arguments you used during the initial install. Tarball users can leave out the git pull part and just call the new version of the install script.

Updating from 3.0.0-alpha or 3.0.0-alpha.2

The configuration file structure has changed. Please move the contents of the /etc/airtime/cloud_storage.conf and /etc/airtime/rabbitmq-analyzer.ini files into the main /etc/airtime/airtime.ini. In all known cases you need to add the following sections to the file.

[current_backend]
storage_backend=file

[amazon_S3]
provider=amazon_S3
bucket=0
api_key=0
api_key_secret=0

You can then remove the files and the symlink.

rm /etc/airtime/cloud_storage.conf \
   /etc/airtime/rabbitmq-analyzer.ini \
   /etc/airtime/production

Analyzer grabs all the needed info from the main airtime.ini file starting with 3.0.0-alpha.4.

Known Issues

The following issues may need a workaround for the time being. Please search the issues before reporting problems not listed below.

Outdated silan reports unreliable cue in/out information

Out of the box the installer installs a broken, outdated version of silan on most Debian based Platforms (ie. Ubuntu). This affects all distros supported by the installer except Debian unstable which has the silan 0.3.3 and CentOS which does not have upstream packages and you may either install from source or use the 0.3.3 packages from RaBe APEL.

You can check the version of silan by running with silan --version which should report 0.3.3 or with sudo dpkg -s silan | awk '/Version/ {print $2}' that will show the exact package version you installed. Please include this information if you file bugs concerning silan.

There are multiple workarounds to this issue and a bug against the upstream has been fixed. Kyle Robbertze @paddatrapper has taken over maintainership of the silan packages in Debian as he is currently packaging LibreTime for Debian. The silan package is in testing as can be seen in the Debian PTS. This section will get updated once the package is in stable.

Until this is sorted you should pre-install silan from a source you trust. If your distro has not updated to 0.3.3 yet you can also help by asking your distros maintainers for a bump.

The following solutions have been reported to work.

Silan from OBS build (#177 (comment))

Works for all relevant Debian and Ubuntu distros and installs silan 0.3.3~nmu1.

# install package signing key from obs
wget -qO- http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_7.0/Release.key \
  | apt-key add -

# add OBS repo to sources list (pick the distro you need)

# Debian Stretch
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_9.0_standard/ ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Debian Jessie
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_8.0 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Ubuntu Xenial
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/xUbuntu_16.04 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Ubuntu Trusty
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/xUbuntu_14.04 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list

# update local package database
apt-get update

# install silan 0.3.3 from obs packages
apt-get install silan

Local armhf builds for Raspberry Pi 3 (#214 (comment))

Since build.opensuse.org can't build Debian packages on arm due to missing dependencies, the 0.3.3~nmu1 arm package was built in a docker crossdev environment. This is reported to work on Debian Jessie on a Raspberry Pi 3 Model B.

curl -L -O https://github.com/LibreTime/libretime/files/1049738/silan_0.3.3.nmu1_armhf.deb.tar.gz
tar xvf silan_0.3.3.nmu1_armhf.deb.tar.gz
sudo dpkg -i silan_0.3.3~nmu1_armhf.deb

Legacy upstream silan packages (#197)

Legacy upstream hosts patched packages for Ubuntu Trusty on apt.sourcefabric.org. They install as 0.3.2~trusty~sfo-1.

sudo tee -a /etc/apt/sources.list <<EOD
deb http://apt.sourcefabric.org/ trusty main
EOD

sudo apt-get update
sudo apt-get install sourcefabric-keyring
sudo apt-get update
sudo apt-get install --reinstall silan=0.3.2~trusty~sfo-1

Remove silan completely (#193 (comment))

It is worth mentioning that you can disable cue point detection by removing silan from the system.

sudo apt-get uninstall silan

Reportedly this might have side effects.

Liquidsoap Support

Libretime currently only supports liquidsoap < 1.3.0 out of the box. If you install a current version of liquidsoap using OPAM or through the Rabe Liquidsoap Distribution for CentOS (RaBe LSD) you will most likely have liquidsoap 1.3.2 or 1.3.3 installed.

#352 reports that liquidsoap < 1.3.0 can exhibit issues on some Debian based installs. One fix for the issue is to install liquidsoap 1.3.0 and to use the following patching steps. Kyle from silan fame is taking the needed steps to get liquidsoap maintained again in Debian so we expect the situation to improve over time.

You can check your liquidsoap version by running liquidsoap --version.

If you already have liquidsoap >= 1.3.0 you have a couple of options.

Liquidsoap 1.3.0 Patchset (#192)

You can patch your installation of LibreTime to support liquidsoap 1.3.0.

An up to date patch is available through GitHub and can be applied to an unpacked tarball as follows.

cd libretime-3.0.0-alpha.4/
curl -L https://github.com/LibreTime/libretime/compare/master...radiorabe:feature/liquidsoap-1.3.0.patch | patch -p1

Git users can pull from the branch at master...radiorabe:feature/liquidsoap-1.3.0 directly.

Install old liquidsoap from opam (#192)

You can downgrade an OPAM install of liquidsoap by running the following command.

opam install "liquidsoap<1.3.0"

No watched folder support

Currently LibreTime does not support watching folders as described in the manual. Uploading files through the web interface works fine and can be automated via a REST API. Re-implementing watched folder support is on the roadmap. Please consider helping out with the code to help speed things along if you want to use the feature.

No line in support

Line In recording can be enabled in the UI but doesn't currently work. This feature went missing from LibreTime due to the fact that we based our code off of the saas-dev branch of legacy upstream and support for recording hasn't been ported to the new airtime analyzer ingest system. #42 currently tracks the progress being made on line in recording.

Playout wont work if locale is missing

Some minimal OS installs do not have a default locale configured. This only seems to affect some VPS installs as they often do not have a locale setup in the default images provided.

You can set up the locale using a combination of the following command. You might also want to consult the documentation of your VPS provider as it may contain an official way to set up locales when provisioning a VPS.

# Set locale using systemds localectl
localectl set-locale LANG="en_US.utf8"

These instructions do not seem to work on all Debian based distros so you might need to use update-locale as follows.

#Purge all locales but en_US.UTF-8
sudo locale-gen --purge en_US.UTF-8
#Populate LANGUAGE=
sudo update-locale LANGUAGE="en_US.UTF-8"

Lack of i18n toolchain is disturbing

Some translations might miss the tarball. They didn't get lost but the build chain needs fixing. Work is in #301 and additional work is needed as it has become clear that we proabably want to support bidirectional translation syncing with zanata.

Colophon

This is the first release that contains code contributions from more than 5 developers. Also, we reached 💯 🌟 a while ago and this is the fifth release since we forked almost a year ago. I'm looking forward to celebrating the one year anniversary of LibreTime soon.

A large thanks from RelEng goes to everyone who put their hard work into LibreTime both here on GitHub as well as on our Discourse. Cutting these releases wouldn't be half as rewarding without the constant feedback from the community.

Pre-release

@hairmare hairmare released this Oct 18, 2017 · 181 commits to master since this release

Assets 3

The complete LibreTime documentation is available at libretime.org.

The full tarball for the 3.0.0-alpha.3 release of LibreTime is available here.

Since this is an alpha release there will be bugs in the code. Please report new issues and/or feature requests in the issue tracker.

Table of Contents

Features

  • Debian 9 support in installer shell script
  • Simplify configuration file structure
  • Lots of work on Hungarian (hu_HU) translation
  • Automatic Creation of Smartblocks and Playlists for new Podcasts
  • Duplicate Smartblock functionality in context menu
  • Better server preparation docs with firewall infos

Bugfixes

  • CORS responses work for all browsers and with TLS or on non default ports
  • Fix update warning for pre-release candidates
  • Dont install dev packages in installer for faster installs
  • Some php 7.1 patches
  • Better logging for analyzer and pypo
  • Fix chunked podcast downloading
  • Fix TLS timestamp updating

Deprecated Features

Updating

See the docs for complete information on updating. Please ensure that you have proper backups and a rollback scenario in place before updating.
If the update does not go smoothly, it may cause significant downtime, so you should always have a fallback system available during the update to ensure broadcast continuity.

If you installed from GitHub you can git pull in you local working copy and re-run the ./install script with the same --web-root and --web-user arguments you used during the initial install. Tarball users can leave out the git pull part and just call the new version of the install script.

Updating from 3.0.0-alpha or 3.0.0-alpha.2

The configuration file structure has changed. Please move the contents of the /etc/airtime/cloud_storage.conf and /etc/airtime/rabbitmq-analyzer.ini files into the main /etc/airtime/airtime.ini. In all known cases you need to add the following sections to the file.

[current_backend]
storage_backend=file

[amazon_S3]
provider=amazon_S3
bucket=0
api_key=0
api_key_secret=0

You can then remove the files and the symlink.

rm /etc/airtime/cloud_storage.conf \
   /etc/airtime/rabbitmq-analyzer.ini \
   /etc/airtime/production

Analyzer grabs all the needed info from the main airtime.ini file starting with 3.0.0-alpha.3.

Known Issues

The following issues need a workaround for the time being. Please search the issues before reporting problems not listed below.

Outdated silan reports unreliable cue in/out information

Out of the box the installer installs a broken, outdated version of silan on most Debian based Platforms (ie. Ubuntu). This affects all distros supported by the installer except Debian unstable which has the silan 0.3.3 and CentOS which does not have upstream packages and you may either install from source or use the 0.3.3 packages from RaBe APEL.

You can check the version of silan by running with silan --version which should report 0.3.3 or with sudo dpkg -s silan | awk '/Version/ {print $2}' that will show the exact package version you installed. Please include this information if you file bugs concerning silan.

There are multiple workarounds to this issue and a bug against the upstream has been opened with Debian. Until this is sorted you should pre-install silan from a source you trust. If your distro has not updated to 0.3.3 yet you can also help by asking your distros maintainers for a bump.

Kyle Robbertze @paddatrapper has taken over maintainership of the silan packages in Debian as he is currently packaging LibreTime for Debian. Thank you very much Kyle!

The following solutions have been reported to work.

Silan from OBS build (#177 (comment))

Works for all relevant Debian and Ubuntu distros and installs silan 0.3.3~nmu1.

# install package signing key from obs
wget -qO- http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_7.0/Release.key \
  | apt-key add -

# add OBS repo to sources list (pick the distro you need)

# Debian Stretch
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_9.0_standard/ ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Debian Jessie
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_8.0 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Ubuntu Xenial
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/xUbuntu_16.04 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Ubuntu Trusty
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/xUbuntu_14.04 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list

# update local package database
apt-get update

# install silan 0.3.3 from obs packages
apt-get install silan

Local armhf builds for Raspberry Pi 3 (#214 (comment))

Since build.opensuse.org can't build Debian packages on arm due to missing dependencies, the 0.3.3~nmu1 arm package was built in a docker crossdev environment. This is reported to work on Debian Jessie on a Raspberry Pi 3 Model B.

curl -L -O https://github.com/LibreTime/libretime/files/1049738/silan_0.3.3.nmu1_armhf.deb.tar.gz
tar xvf silan_0.3.3.nmu1_armhf.deb.tar.gz
sudo dpkg -i silan_0.3.3~nmu1_armhf.deb

Legacy upstream silan packages (#197)

Legacy upstream hosts patched packages for Ubuntu Trusty on apt.sourcefabric.org. They install as 0.3.2~trusty~sfo-1.

sudo tee -a /etc/apt/sources.list <<EOD
deb http://apt.sourcefabric.org/ trusty main
EOD

sudo apt-get update
sudo apt-get install sourcefabric-keyring
sudo apt-get update
sudo apt-get install --reinstall silan=0.3.2~trusty~sfo-1

Remove silan completely (#193 (comment))

It is worth mentioning that you can disable cue point detection by removing silan from the system.

sudo apt-get uninstall silan

Reportedly this might wake the 🐈 (happy-cuteness-overload-small aww) or have other side effects.

Liquidsoap >= 1.3.0 Support

Libretime currently only supports liquidsoap < 1.3.0 out of the box. If you install a current version of liquidsoap using OPAM or through the Rabe Liquidsoap Distribution for CentOS (RaBe LSD) you will most likely have liquidsoap 1.3.1 installed.

You can check your liquidsoap version by running liquidsoap --version.

If you already have liquidsoap >= 1.3.0 you have a couple of options.

Liquidsoap 1.3.0 Patchset (#192)

You can patch your installation of LibreTime to support liquidsoap 1.3.0.

An up to date patch is available through GitHub and can be applied to an unpacked tarball as follows.

cd libretime-3.0.0-alpha.3/
curl -L https://github.com/LibreTime/libretime/compare/master...radiorabe:feature/liquidsoap-1.3.0.patch | patch -p1

Git users can pull from the branch at master...radiorabe:feature/liquidsoap-1.3.0 directly.

Install old liquidsoap from opam (#192)

You can downgrade an OPAM install of liquidsoap by running the following command.

opam install "liquidsoap<1.3.0"

No watched folder support

Currently LibreTime does not support watching folders as described in the manual. Uploading files through the web interface works fine and can be automated via a REST API. Re-implementing watched folder support is on the roadmap. Please consider helping out with the code to help speed things along if you want to use the feature.

No line in support

Line In recording can be enabled in the UI but doesn't currently work. This feature went missing from LibreTime due to the fact that we based our code off of the saas-dev branch of legacy upstream and support for recording hasn't been ported to the new airtime analyzer ingest system. #42 currently tracks the progress being made on line in recording.

Playout wont work if locale is missing

Some minimal OS installs do not have a default locale configured. This only seems to affect some VPS installs as they often do not have a locale setup in the default images provided.

You can set up the locale using a combination of the following command. You might also want to consult the documentation of your VPS provider as it may contain an official way to set up locales when provisioning a VPS.

# Set locale using systemds localectl
localectl set-locale LANG="en_US.utf8"

these instructions do not seem to work on all Debian based distros so you might need to use update-locale as follows.

#Purge all locales but en_US.UTF-8
sudo locale-gen --purge en_US.UTF-8
#Populate LANGUAGE=
sudo update-locale LANGUAGE="en_US.UTF-8"

Colophon

It's been awesome to see that the interest in LibreTime isn't dying off.

I recently did some cleaning up of the labels and milestones in the issue tracker and would like to ask everyone to help out with tagging issues and managing milestones.

Currently the milestones only contain issues likely to be finished in the development window of the respective version. This includes things that already have a pull-request or issues with a high priority due to their sensible or blocking nature. Feel free to request new labels and unversioned milestones if you feel you can use them.

That's all for these release notes. I'd also like to note that I plan on doing releases more often. They will be smaller but there will be less changes per release.

Pre-release

@hairmare hairmare released this Jul 12, 2017 · 260 commits to master since this release

Assets 3

The complete LibreTime documentation is available at libretime.org.

The full tarball for the 3.0.0-alpha.2 release of LibreTime is available here.

Since this is an alpha release there will be bugs in the code. Please report new issues and/or feature requests in the issue tracker.

Table of Contents

Features

Bugfixes

  • Fix reversed name & description fields in stream 3 additional options
  • Use file-magic instead of python-magic for working install with distro packages
  • Use local angular install on radio page instead of cdn
  • Allow deleting of initial admin user
  • Fix gitattribute issues with the docs
  • and some more small stuff

Deprecated Features

  • The installer distro selection process has been upgraded and the --distribution and --release parameters are not needed anymore. They are still supported for the time being but their use is not recommended.

Updating

See the docs for complete information on updating. Please ensure that you have proper backups and a rollback scenario in place before updating.
If the update does not go smoothly, it may cause significant downtime, so you should always have a fallback system available during the update to ensure broadcast continuity.

If you installed from GitHub you can git pull in you local working copy and re-run the ./install script with the same --web-root and --web-user arguments you used during the initial install. Tarball users can leave out the git pull part and just call the new version of the install script.

Deprecation Announcement for Debian 7 (Wheezy)

Up until 3.0.0-alpha.2 Debian 7 (Wheezy) was in the list of supported distros.

Given that Debian 9 (Stretch) is now available and installing LibreTime on Wheezy probably never worked properly out of the box LibreTime has to update its support matrix. This info is in the release notes as an early warning since we are deprecating a major os version with an upcoming release.

Known Issues

The following issues need a workaround for the time being. Please search the issues before reporting problems not listed below.

Outdated silan reports unreliable cue in/out information

Out of the box the installer installs a broken, outdated version of silan on all Debian based Platforms (ie. Ubuntu). This affects all distros supported by the installer except CentOS which does not have upstream packages and you may either install from source or use the 0.3.3 packages from RaBe APEL.

You can check the version of silan by running with silan --version which should report 0.3.3 or with sudo dpkg -s silan | awk '/Version/ {print $2}' that will show the exact package version you installed. Please include this information if you file bugs concerning silan.

There are multiple workarounds to this issue and a bug against the upstream has been opened with Debian. Until this is sorted you should pre-install silan from a source you trust. If your distro has not updated to 0.3.3 yet you can also help by asking your distros maintainers for a bump.

LibreTime is looking for a Debian Maintainer willing to adopt silan. This would be a much appreciated good deed to the open source broadcast community, both terrestrial and online. Your contribution to silan could literally make a difference to millions of listeners daily.

The following solutions have been reported to work.

Silan from OBS build (#177 (comment))

Works for all relevant Debian and Ubuntu distros and installs silan 0.3.3~nmu1.

# install package signing key from obs
wget -qO- http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_7.0/Release.key \
  | apt-key add -

# add OBS repo to sources list (pick the distro you need)

# Debian Wheezy
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_7.0 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Debian Jessie
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_8.0 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Ubuntu Trusty
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/xUbuntu_14.04 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Ubuntu Xenial
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/xUbuntu_16.04 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list

# update local package database
apt-get update

# install silan 0.3.3 from obs packages
apt-get install silan

Local armhf builds for Raspberry Pi 3 (#214 (comment))

Since build.opensuse.org can't build Debian packages on arm due to missing dependencies, the 0.3.3~nmu1 arm package was built in a docker crossdev environment. This is reported to work on Debian Jessie on a Raspberry Pi 3 Model B.

curl -L -O https://github.com/LibreTime/libretime/files/1049738/silan_0.3.3.nmu1_armhf.deb.tar.gz
tar xvf silan_0.3.3.nmu1_armhf.deb.tar.gz
sudo dpkg -i silan_0.3.3~nmu1_armhf.deb

Legacy upstream silan packages (#197)

Legacy upstream hosts patched packages for Ubuntu Trusty on apt.sourcefabric.org. They install as 0.3.2~trusty~sfo-1.

sudo tee -a /etc/apt/sources.list <<EOD
deb http://apt.sourcefabric.org/ trusty main
EOD

sudo apt-get update
sudo apt-get install sourcefabric-keyring
sudo apt-get update
sudo apt-get install --reinstall silan=0.3.2~trusty~sfo-1

Remove silan completely (#193 (comment))

It is worth mentioning that you can disable cue point detection by removing silan from the system.

sudo apt-get uninstall silan

Reportedly this might wake the 🐈 (happy-cuteness-overload-small aww) or have other side effects.

Liquidsoap >= 1.3.0 Support

Libretime currently only supports liquidsoap < 1.3.0 out of the box. If you install a current version of liquidsoap using OPAM or through the Rabe Liquidsoap Distribution for CentOS (RaBe LSD) you will most likely have liquidsoap 1.3.1 installed.

You can check your liquidsoap version by running liquidsoap --version.

If you already have liquidsoap >= 1.3.0 you have a couple of options.

Liquidsoap 1.3.0 Patchset (#192)

You can patch your installation of LibreTime to support liquidsoap 1.3.0.

An up to date patch is available through GitHub and can be applied to an unpacked tarball as follows.

cd libretime-3.0.0-alpha.2/
curl -L https://github.com/LibreTime/libretime/compare/master...radiorabe:feature/liquidsoap-1.3.0.patch | patch -p1

Git users can pull from the branch at master...radiorabe:feature/liquidsoap-1.3.0 directly.

Install old liquidsoap from opam (#192)

You can downgrade an OPAM install of liquidsoap by running the following command.

opam install "liquidsoap<1.3.0"

Colophon

I made some git of theseus graphs on the history of LibreTime. What makes these interesting is that the project started in CVS, was migrated to Subversion and then to Git the commit history always being preserved. Let's have a look down the shoulders of the giants we are standing on.

stack_plot

More GoT graphs can be found in the wiki. I didn't originally know that the code started out as not much PHP (0e968e6), with C++ making an early entry soon after (9c60b17). At the time (2004) LibreTime seems to have been called livesupport. In 2006(ish) it was rebranded to CampCaster (fe31d2d), with the rename to Airtime being worked on somewhere in 2010 (169c4ec).

Pre-release

@hairmare hairmare released this Apr 20, 2017 · 292 commits to master since this release

Assets 3

The complete LibreTime documentation is available at libretime.org.

Since this is an alpha release there will be bugs in the code. Please report any issues and/or feature requests in the issue tracker.

Features

  • Make overriding of album tag in downloaded Podcasts configurable
  • Configurable master and show sources in settings
  • Version check on main interface against Github
  • updated i18n strings (complete ru_RU translation)
  • Allow closing "Scheduled Shows" tab in Showbuilder
  • FreeIPA Auth Adaptor

Bugfixes

  • Use restart=always in systemd installs
  • Do not depend on hardcoded admin password for autoplaylist feature
  • more legacy upstream branding removal
  • restore table settings (ie. columns and sort) on login
  • translatable radio page
  • line-in recording almost works again
  • no more oopsing on week info API

Deprecated Features

  • The ubuntu Vagrant box has been replaced with ubuntu-xenial and ubuntu-trusty. The debian box has been replaced with debian-jessie and debian-wheezy. Users of the old boxes should switch to a new box so we can drop the old box after this release.

Known Issues

The following issues need a workaround for the time being. Please search the issues before reporting problems not listed below.

Outdated silan reports unreliable cue in/out information

Out of the box the installer installs a broken, outdated version of silan on all Debian based Platforms (ie. Ubuntu). This affects all distros supported by the installer except CentOS which does not have upstream packages and you may either install from source or use the 0.3.3 packages from RaBe APEL.

You can check the version of silan by running with silan --version which should report 0.3.3 or with sudo dpkg -s silan | awk '/Version/ {print $2}' that will show the exact package version you installed. Please include this information if you file bugs concerning silan.

There are multiple workarounds to this issue and a bug against the upstream has been opened with Debian. Until this is sorted you should pre-install silan from a source you trust. If your distro has not updated to 0.3.3 yet you can also help by asking your distros maintainers for a bump.

The following solutions have been reported to work.

Silan from OBS build (#177 (comment))

Works for all relevant Debian and Ubuntu distros and installs silan 0.3.3~nmu1.

# install package signing key from obs
wget -qO- http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_7.0/Release.key \
  | apt-key add -

# add OBS repo to sources list (pick the distro you need)

# Debian Wheezy
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_7.0 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Debian Jessie
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/Debian_8.0 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Ubuntu Trusty
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/xUbuntu_14.04 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list
# Ubuntu Xenial
echo 'deb http://download.opensuse.org/repositories/home:/hairmare:/silan/xUbuntu_16.04 ./' \
  > /etc/apt/sources.list.d/hairmare_silan.list

# update local package database
apt-get update

# install silan 0.3.3 from obs packages
apt-get install silan

Legacy upstream silan packages (#197)

Legacy Upstream hosts patched packages for Ubuntu Trusty on apt.sourcefabric.org. They install as 0.3.2~trusty~sfo-1.

sudo tee -a /etc/apt/sources.list <<EOD
deb http://apt.sourcefabric.org/ trusty main
EOD

sudo apt-get update
sudo apt-get install sourcefabric-keyring
sudo apt-get update
sudo apt-get install --reinstall silan=0.3.2~trusty~sfo-1
Pre-release

@hairmare hairmare released this Mar 15, 2017 · 441 commits to master since this release

Assets 4

The first release from the LibreTime Community.

Features

  • Working installer for Debian and Ubuntu
  • Automated Vagrant setup for developers on either Debian, Ubuntu or CentOS
  • Removed visible legacy upstream branding
  • Disable most legacy upstream "pro" SaaS integrations
  • "pro" widgets for everyone
  • AutoDJ support for shows
  • Tons of bugfixes like working silan cue cuts and more

The complete LibreTime documentation is available at libretime.org.

Since this is an alpha release there will be bugs in the code. Some features that went missing in legacy upstreams "pro" branch have been backported while others are still waiting for such treatment. Please report any issues and/or feature requests in the issue tracker.

The attached debian package is considered unstable as it has not had any serious testing at all. It mainly demonstrates that we are able to build one.