LibreTime v3.0.0-alpha.6 Release NotesRelease Date: 2018-12-23 // over 3 years ago
📚 The complete LibreTime documentation is available at libretime.org.
🚀 The full tarball for the
3.0.0-alpha.6release 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
- 🗄 Deprecated Features
- ⚡️ Updating
- Known Issues
- Installer Issues
- Media-Monitor config needs manual removing
- Outdated silan reports unreliable cue in/out information
- Liquidsoap support
- No watched folder support
- No Line In recording support
- Playout wont work if locale is missing
- Lack of i18n toolchain is disturbing
- 0️⃣ Turn on the podcast album override by default on new installs.
- Ubuntu 18.04 (Bionic) developer tooling.
- 🔧 Collapse advanced configuration in show edit form.
- Clock icon in calendar for autoloading playlists.
- Let user edit podcast name.
- 0️⃣ Default to creating dynamic smartblock when creating new smartblocks.
- 🔧 Move advanced smartblock configuration to collapsed "Advanced options" section.
- Assume "Y" as answer for questions during installer.
- 🛠 Fix sizing for playlist and smart block on shorter screens.
- ⏱ Increased celery timeout to 1800 seconds (affects podcast downloads and other tasks like things related to the soundcloud integration).
- ✂ remove some obsolete scripts from
- 🛠 Fix version check for cases where GitHub is not available or temporarily fails.
- ⏱ Clarify wording for "Autoloading Playlist" (used to be called "Auto Schedule" or other names).
- ✂ Remove "Record & Rebroadcast" from ui.
- 🛠 Fix scrolling issue in "Add Show" dialog.
- 👍 Allow ampersand in smartblock search criteria.
- 🛠 Fix display of selected tracks in Smartblock criteria.
- ➕ Add docs into enriched tarball for packagers.
- 👌 Improve filling smartblocks, they should not get overscheduled rather than not getting filled up all the way.
- ✂ Remove broken ReCaptcha.
- 🛠 Fix reading metadata from non-mp3 sources (in podcasts and uploads).
- 📇 Update mutagen to fix some edge cases when reading metadata from files in analyzer.
- 🛠 Fix shuffling playlists that contain a smart block.
- ✂ Remove unused zfdebug from dev environment.
🗄 Deprecated Features
- 🚀 The contents of
/etc/airtime/rabbitmq-analyzer.inihave been moved to the main
/etc/airtime/airtime.conffile and the env specific symlink is no longer needed. See below for instructions on how to migrate from a pre-release that created those files.
- 🚀 As per the announcement in the
3.0.0-alpha.5release notes we are dropping Ubuntu 14.04 (Trusty) as a supported platform.
- ✂ Removed Amazon S3 storage support.
- ✂ Remove "Record & Rebroadcast" from ui.
📄 The main installation docs may be found at http://libretime.org/install/. They describe a "developer" install using the bundled
🚀 We are preparing packages for supported distros and you can take those for a spin if you would like to. Usually the packages get built pretty soon after a release is published. If the current version is not available from the below sources you should wait for a while until they get uploaded.
⚡️ Please reference these links for further information on how to install from packages. The install docs will get updated to show how to install packages once we have validated that the packages work properly and when the packages are available from a repository allowing you to automate updating to a new version.
⚡️ 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 pullin your local working copy and re-run the
./installscript with the same
--web-userarguments 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, 3.0.0-alpha.1 and, 3.0.0-alpha.2
🔧 The configuration file structure has changed. Please move the contents of the
/etc/airtime/rabbitmq-analyzer.inifiles into the main
/etc/airtime/airtime.conf. In all known cases you need to add the following section to the 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_s3section if it was in any of the files.
Analyzer grabs all the needed info from the main
airtime.conffile starting with
↪ The following issues may need a workaround for the time being. Please search the issues before reporting problems not listed below.
📦 The installer is generally a bit unstable, we hope to be able to offer some reasonable packages at some point. Some of the GUI driven parts before the first login are also in a somewhat questionable state, ymmv.
🚀 For now the installer distro selection is pretty good at auto-detecting your os and usually does an ok job depending on your distro. You should usually not need to pass a --distribution and --release parameter, those are still supported for the time being but their use is not recommended.
💻 The ui works best if you don't use it in an opinionated fashion and change just the bare minimal.
📄 If you want a secure environment you should work through the preparing the server docs (up until the dragons) and be prepared to fix some of the issues the installer gets wrong manually by hacking the config file after the fact.
🏗 If you want to skip the installer GUI completely you can configure LibreTime using
airtime_mvc/build/airtime.example.confas an template. Due to some python/PHP differences you must remove all comments from the example to use it 😞. You'll also have to create some folder structures manually and check if the music dir got properly created directly in the database. Referencing a second
install -fiapinstall on a non productive system for reference can help with this type of bootstrap.
Media-Monitor config needs manual removing
🚚 If you are using the
installscript you should most likely remove the
[media-monitor]config section from your
/etc/airtime/airtime.conffile 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 some Debian based Platforms (ie. Ubuntu). This affects all distros supported by the installer except Debian testing 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.
👀 Check your version of silan by running
silan --version. This should report
0.3.3or higher. If not please see the Silan Installation wiki page for more details & workarounds.
📦 To date silan 0.3.3 or higher is in Debian testing & Ubuntu Bionic. You can check the upstream progress the Debian PTS and Ubuntu launchpad. This section will get removed once the package is in stable.
tldr: Silan Installation
👍 Liquidsoap Support
🏗 Libretime currently only supports liquidsoap
< 1.3.0out 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
#352 reports that liquidsoap
< 1.3.0can exhibit issues on some Debian based installs. One fix for the issue is to install liquidsoap
1.3.0and 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
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.6/ 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
👍 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 commands. 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 localectllocalectl set-locale LANG="en\_US.utf8"
⚡️ These instructions do not seem to work on all Debian based distros so you might need to use
#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 probably want to support bidirectional translation syncing with zanata.
🍱 I would like to use this space to extend a warm welcome to our new Maintainers @paddatrapper, @frecuencialibre and @ned-kelly. We are happy to have you on board. Thank you very much for helping maintain LibreTime ❤️