external/iiab
1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-03-09 15:40:17 +00:00
Code Issues Releases Wiki Activity

AzuraCast README.rst cleanup

Browse source
This commit is contained in:
A Holt 2019-06-22 14:18:16 -04:00 • committed by GitHub
parent 158c27ca39
commit 335bae678c
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

18
roles/azuracast/README.rst
View file

@ -2,19 +2,19 @@
AzuraCast README
==========
This 'AzuraCast' playbook adds `AzuraCast <https://azuracast.com/>`_ to Internet-in-a-Box (IIAB) for network radio station functionality. With 'AzuraCast', one can schedule podcasts, music, and even do live streaming of audio content. A variety of streaming formats are supported.
This 'AzuraCast' playbook adds `AzuraCast <https://azuracast.com/>`_ to Internet-in-a-Box (IIAB) for network radio station functionality. With 'AzuraCast' you and your community can schedule podcasts, music, and even do live streaming of audio content. A variety of streaming formats are supported.
Currently, this will only run on Ubuntu 18.04, Debian 9, Debian 10. This will not run on raspberry pi.
Currently, this will only run on Ubuntu 18.04, Debian 9, Debian 10. At present, it will not run on Raspberry Pi.
Using It
--------
**ISSUE!** Since the AzuraCast installer installs docker and docker-compose, it creates many network interfaces which confuses the IIAB network detection logic. So, it is highly recommended that to get AzuraCast, and a functional IIAB server, the following sequence be followed.
**ISSUE!** Since the AzuraCast installer installs docker and docker-compose, it creates many network interfaces which confuse the IIAB network detection logic (`#1753 <https://github.com/iiab/iiab/pull/1753>`_). So, as of 2019-06-21, follow this sequence to get AzuraCast working on your IIAB server:
* Do a normal IIAB install with `azuracast_install` and `azuracast_enabled` set to `false`.
* Set the above variables to true.
* On the console, `./runrole azuracast` or a full IIAB install with `./iiab-install --reinstall`
* After the playbook completes, AzuraCast will be available on `http://box.lan:10080`
* Visiting that URL will prompt the user to do initial setup: user accounts, managing stations, radio streams, etc.
* Do a normal IIAB install (http://download.iiab.io) keeping ``azuracast_install`` and ``azuracast_enabled`` False, per the defaults.
* Set the two above variables to True in `/etc/iiab/local_vars.yml <http://FAQ.IIAB.IO#What_is_local_vars.yml_and_how_do_I_customize_it.3F>`_
* As root, do ``cd /opt/iiab/iiab`` then ``./runrole azuracast`` (or do ``./iiab-install --reinstall`` for a full IIAB install)
* After the Ansible playbook completes, AzuraCast's console will be available on http://box.lan:10080
* This site will prompt you to set up: user accounts, managing stations, radio streams, etc.
Note: When creating a station from the admin console. The default streaming ports for the `station` and `autodj` need to be in the port range 10000-10100.
Note: When creating a station from AzuraCast's console, its default streaming ports for ``station`` and ``autodj`` need to be in the `port range 10000-10100 <https://github.com/iiab/iiab/wiki/IIAB-Networking#list-of-ports--services>`_.