From a168afeeeff501433310401c6f4da9921837bd2a Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 30 Aug 2022 10:56:42 -0400 Subject: [PATCH 1/7] 6-generic-apps/tasks/main.yml: AzuraCast restoration --- roles/6-generic-apps/tasks/main.yml | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/roles/6-generic-apps/tasks/main.yml b/roles/6-generic-apps/tasks/main.yml index 1c36cb5d3..4c4ea9522 100644 --- a/roles/6-generic-apps/tasks/main.yml +++ b/roles/6-generic-apps/tasks/main.yml @@ -3,12 +3,6 @@ - name: ...IS BEGINNING ==================================== meta: noop -# UNMAINTAINED -- name: AZURACAST - include_role: - name: azuracast - when: azuracast_install is defined and azuracast_install - # UNMAINTAINED - name: DOKUWIKI include_role: @@ -27,6 +21,11 @@ name: elgg when: elgg_install is defined and elgg_install +- name: AZURACAST + include_role: + name: azuracast + when: azuracast_install + - name: GITEA include_role: name: gitea From 162c86236b7aaa5f66596da393a156edf2ab6ce4 Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 31 Aug 2022 09:26:03 -0400 Subject: [PATCH 2/7] Update azuracast/README.rst 3+ years later (WiP) --- roles/azuracast/README.rst | 31 +++++++++++++++++++++++++------ 1 file changed, 25 insertions(+), 6 deletions(-) diff --git a/roles/azuracast/README.rst b/roles/azuracast/README.rst index fca21ce96..da7d1abab 100644 --- a/roles/azuracast/README.rst +++ b/roles/azuracast/README.rst @@ -2,18 +2,37 @@ AzuraCast README ================ -This playbook adds `AzuraCast `_ 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. +This playbook adds `AzuraCast `_ to Internet-in-a-Box (IIAB) for "radio station" functionality. You and your community can schedule podcasts, music, and even do live streaming of audio content. A variety of streaming formats are supported. -Please see AzuraCast's `screenshots `_. +As soon as you install AzuraCast with IIAB, it can stream MP3 files (and similar) for you, using `LiquidSoap `_ to help you schedule or randomize playback of MP3 songs (and similar). -As of 2019-08-04, this will only run on Ubuntu 18.04, and tentatively on Debian 10 "Buster" (`#1766 `_). Support for Raspberry Pi remains a goal for now — please if you can, consider helping us solve this critical challenge (`#1772 `_, `AzuraCast/AzuraCast#332 `_). +Please see AzuraCast's `screenshots `_ and `docs <./README.rst#Requirements>`_. + +Optionally, live-streaming can also be made to work, e.g. if you install `Mixxx or BUTT `_ on your own. If so, you have many options to configure streaming with `Icecast `_, `Shoutcast `_, etc. + +Requirements +------------ + +AzuraCast recommends `2-to-4 GB RAM minimum `_. + +As of 2022-08-31, AzuraCast should run on Ubuntu 22.04 and 64-bit Raspberry Pi OS: `#1772 `_, `AzuraCast/AzuraCast#332 `_, `PR #2946 `_ + +Other Linux distributions may also work, at your own risk, especially if Docker runs smoothly. Using It -------- -* Do a normal IIAB install (https://download.iiab.io), making sure to set both variables ``azuracast_install`` and ``azuracast_enabled`` to ``True`` when it prompts you to edit `/etc/iiab/local_vars.yml `_, as you begin the installation. -* When the IIAB software install completes, it will ask you to reboot, and AzuraCast's console will then be available at http://box.lan:10080 +* Do a normal IIAB install (https://download.iiab.io), making sure to set both variables ``azuracast_install`` and ``azuracast_enabled`` to ``True`` when IIAB's installer prompts you to edit `/etc/iiab/local_vars.yml `_ +* When the IIAB software install completes, it will ask you to reboot, and AzuraCast's console will then be available at http://box.lan:12080 * This console site will prompt you to complete AzuraCast's initial setup: user accounts, managing stations, radio streams, etc. * Finally, check out some `how-to videos `_ to learn to manage your own radio station! -Note: When creating a station using AzuraCast's console, its default streaming ports for ``station`` and ``autodj`` need to be in the `port range 10000-10100 `_. +Note: When creating a station using AzuraCast's console, its default streaming ports for ``station`` and ``autodj`` need to be in the `port range 12000-12100 `_ (port 12443 may also be required!) + +AzuraCast Docs +-------------- + +- https://docs.azuracast.com +- https://docs.azuracast.com/en/getting-started/installation/post-installation-steps +- https://docs.azuracast.com/en/getting-started/updates +- https://docs.azuracast.com/en/user-guide/streaming-software From 80513db2673895026a7ebc8a2a0bd1825d52e9c2 Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 31 Aug 2022 09:30:32 -0400 Subject: [PATCH 3/7] azuracast/README.rst: Fix anchor tag #azuracast-docs --- roles/azuracast/README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/azuracast/README.rst b/roles/azuracast/README.rst index da7d1abab..7d3f05f92 100644 --- a/roles/azuracast/README.rst +++ b/roles/azuracast/README.rst @@ -6,7 +6,7 @@ This playbook adds `AzuraCast `_ to Internet-in-a-Box (I As soon as you install AzuraCast with IIAB, it can stream MP3 files (and similar) for you, using `LiquidSoap `_ to help you schedule or randomize playback of MP3 songs (and similar). -Please see AzuraCast's `screenshots `_ and `docs <./README.rst#Requirements>`_. +Please see AzuraCast's `screenshots `_ and `docs <./README.rst#azuracast-docs>`_. Optionally, live-streaming can also be made to work, e.g. if you install `Mixxx or BUTT `_ on your own. If so, you have many options to configure streaming with `Icecast `_, `Shoutcast `_, etc. From 1d6a6b3bd48e0059f556771d7d90a1b82d84e59a Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 31 Aug 2022 09:32:26 -0400 Subject: [PATCH 4/7] azuracast/README.rst: Emphasize RasPiOS needs to be 64-bit --- roles/azuracast/README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/azuracast/README.rst b/roles/azuracast/README.rst index 7d3f05f92..515a8c6de 100644 --- a/roles/azuracast/README.rst +++ b/roles/azuracast/README.rst @@ -15,7 +15,7 @@ Requirements AzuraCast recommends `2-to-4 GB RAM minimum `_. -As of 2022-08-31, AzuraCast should run on Ubuntu 22.04 and 64-bit Raspberry Pi OS: `#1772 `_, `AzuraCast/AzuraCast#332 `_, `PR #2946 `_ +As of 2022-08-31, AzuraCast should run on Ubuntu 22.04 and **64-bit** Raspberry Pi OS: `#1772 `_, `AzuraCast/AzuraCast#332 `_, `PR #2946 `_ Other Linux distributions may also work, at your own risk, especially if Docker runs smoothly. From f691b389ba277f4eb1598142bbcabacdd99618ac Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 31 Aug 2022 09:40:23 -0400 Subject: [PATCH 5/7] Install AzuraCast in Stage 9 (9-local-addons) --- roles/9-local-addons/tasks/main.yml | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/roles/9-local-addons/tasks/main.yml b/roles/9-local-addons/tasks/main.yml index d63d5b8c1..f9ea8e20f 100644 --- a/roles/9-local-addons/tasks/main.yml +++ b/roles/9-local-addons/tasks/main.yml @@ -3,7 +3,12 @@ - name: ...IS BEGINNING ==================================== meta: noop -# Is porting to Python 3 complete, and if so does this belong elsewhere? +- name: AZURACAST + include_role: + name: azuracast + when: azuracast_install + +# Porting to Python 3 is complete: does this belong elsewhere? - name: CAPTIVE PORTAL include_role: name: captiveportal From 1e5e3c25b325d74b86a611a12ed3d1af06e28a84 Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 31 Aug 2022 09:41:03 -0400 Subject: [PATCH 6/7] 6-generic-apps/tasks/main.yml: AzuraCast moved to Stage 9 --- roles/6-generic-apps/tasks/main.yml | 5 ----- 1 file changed, 5 deletions(-) diff --git a/roles/6-generic-apps/tasks/main.yml b/roles/6-generic-apps/tasks/main.yml index 4c4ea9522..f43e878f3 100644 --- a/roles/6-generic-apps/tasks/main.yml +++ b/roles/6-generic-apps/tasks/main.yml @@ -21,11 +21,6 @@ name: elgg when: elgg_install is defined and elgg_install -- name: AZURACAST - include_role: - name: azuracast - when: azuracast_install - - name: GITEA include_role: name: gitea From 0b822d7204b1c05b11ecbf08f4f2991c34cc9c75 Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 31 Aug 2022 09:55:40 -0400 Subject: [PATCH 7/7] Tighten up azuracast/README.rst --- roles/azuracast/README.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/roles/azuracast/README.rst b/roles/azuracast/README.rst index 515a8c6de..e4d750046 100644 --- a/roles/azuracast/README.rst +++ b/roles/azuracast/README.rst @@ -2,9 +2,9 @@ AzuraCast README ================ -This playbook adds `AzuraCast `_ to Internet-in-a-Box (IIAB) for "radio station" functionality. You and your community can schedule podcasts, music, and even do live streaming of audio content. A variety of streaming formats are supported. +Install `AzuraCast `_ to your Internet-in-a-Box (IIAB) if you want "radio station" functionality. You and your community can then schedule podcasts, music, and even do live streaming of audio content (video streaming might also be possible in future!) -As soon as you install AzuraCast with IIAB, it can stream MP3 files (and similar) for you, using `LiquidSoap `_ to help you schedule or randomize playback of MP3 songs (and similar). +As soon as you install AzuraCast with IIAB, it can stream MP3 files (and similar files) using `LiquidSoap `_ to help you schedule or randomize playback of MP3 songs (and similar). Please see AzuraCast's `screenshots `_ and `docs <./README.rst#azuracast-docs>`_. @@ -24,10 +24,10 @@ Using It * Do a normal IIAB install (https://download.iiab.io), making sure to set both variables ``azuracast_install`` and ``azuracast_enabled`` to ``True`` when IIAB's installer prompts you to edit `/etc/iiab/local_vars.yml `_ * When the IIAB software install completes, it will ask you to reboot, and AzuraCast's console will then be available at http://box.lan:12080 -* This console site will prompt you to complete AzuraCast's initial setup: user accounts, managing stations, radio streams, etc. +* That console site will prompt you to complete AzuraCast's initial setup: user accounts, managing stations, radio streams, etc. * Finally, check out some `how-to videos `_ to learn to manage your own radio station! -Note: When creating a station using AzuraCast's console, its default streaming ports for ``station`` and ``autodj`` need to be in the `port range 12000-12100 `_ (port 12443 may also be required!) +NOTE: When creating a station using AzuraCast's console, its default streaming ports for ``station`` and ``autodj`` need to be in the `port range 12000-12100 `_ (port 12443 may also be required!) AzuraCast Docs --------------