tilderadio
/
AzuraCast
mirror of https://github.com/AzuraCast/AzuraCast.git
4
0
Fork 0
Code Issues Releases Wiki Activity

Update links across application to point to new documentation.

This commit is contained in:
Buster "Silver Eagle" Neece 2021-02-15 15:36:34 -06:00
parent 3d50d1286b
commit ec2ec899d8
No known key found for this signature in database
GPG Key ID: 6D9E12FF03411F4E
16 changed files with 260 additions and 132 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
.github/ISSUE_TEMPLATE/bug_report.md vendored
View File

@ -1,14 +1,13 @@
---
name: Bug Report
about: Report an error you're encountering with your AzuraCast installation.
name: Bug Report about: Report an error you're encountering with your AzuraCast installation.
---
<!--
Notes:
- Please be kind and patient in your interactions with us. We are a small team of volunteers working solely on donations. Thank you in advance.
- Ansible installation methods are not officially supported and support may not be provided outside of the rare circumstances.
- Ansible installation methods are not officially supported and support may not be provided outside of the rare circumstances.
- Always check your logs before submitting!
- Make sure your issue isn't already answered here: https://www.azuracast.com/help/
- Make sure your issue isn't already answered here: https://docs.azuracast.com/en/user-guide/troubleshooting
-->
**Using Docker installation method**
@ -51,11 +50,11 @@ Steps to reproduce the behavior:
**Device(s):**
- Device: <!-- [e.g. Desktop, iPhone6] -->
- OS: <!-- [e.g. iOS] -->
- Browser: <!-- [e.g. chrome, safari] -->
- Version: <!-- [e.g. 22] -->
- Device: <!-- [e.g. Desktop, iPhone6] -->
- OS: <!-- [e.g. iOS] -->
- Browser: <!-- [e.g. chrome, safari] -->
- Version: <!-- [e.g. 22] -->
**Additional context**
<!-- Add any other context about the problem here. -->

30
.github/ISSUE_TEMPLATE/config.yml vendored
View File

@ -1,18 +1,18 @@
blank_issues_enabled: false
blank_issues_enabled : false
contact_links:
- name: AzuraCast Help Page
url: https://www.azuracast.com/help/
about: Check the AzuraCast help page for solutions to common problems.
contact_links :
- name : AzuraCast Help Page
url : https://docs.azuracast.com/en/user-guide/troubleshooting
about : Check the AzuraCast help page for solutions to common problems.
- name: New Feature Suggestion
url: https://features.azuracast.com
about: Submit an idea for a new feature via our FeatureUpvote site.
- name: Submit New Translations
url: https://translate.azuracast.com
about: Submit and manage translations for the AzuraCast application.
- name : New Feature Suggestion
url : https://features.azuracast.com
about : Submit an idea for a new feature via our FeatureUpvote site.
- name: Join AzuraCast Discord
url: https://www.azuracast.com/discord
about: Join the Discord community for help and support from other station owners.
- name : Submit New Translations
url : https://translate.azuracast.com
about : Submit and manage translations for the AzuraCast application.
- name : Join AzuraCast Discord
url : https://discord.gg/azuracast
about : Join the Discord community for help and support from other station owners.

2
CHANGELOG.md
View File

@ -754,7 +754,7 @@ important updates to the software in that time, especially in the fields of reli
the "Now Playing" API, which is a rich summary of the state of a radio station at the moment. To improve performance
of more popular stations using our software, we've introduced two new methods of accessing this data: a static JSON
file and a live Websocket/EventSource-driven plugin. You can read more on our
new [Now Playing Data APIs Guide](https://www.azuracast.com/developers/nowplaying.html).
new [Now Playing Data APIs Guide](https://docs.azuracast.com/en/developers/apis/now-playing-data).
## Bug Fixes and Minor Updates

3
CODE_OF_CONDUCT.md
View File

@ -4,4 +4,5 @@ All repositories in the AzuraCast organization adhere to the Contributor Covenan
interactions across all media, including our GitHub issues and public social media channels, to adhere to these
guidelines.
Visit [the AzuraCast web site](https://www.azuracast.com/code_of_conduct.html) for the full text of our Code of Conduct.
Visit [the AzuraCast web site](https://docs.azuracast.com/en/contribute/code-of-conduct) for the full text of our Code
of Conduct.

74
CONTRIBUTING.md
View File

@ -1,57 +1,87 @@
# Contributing to AzuraCast
As a free and open-source software project, we eagerly welcome contributions from the community. There are many ways to help contribute to AzuraCast's development, so you can make a difference without being a seasoned developer.
As a free and open-source software project, we eagerly welcome contributions from the community. There are many ways to
help contribute to AzuraCast's development, so you can make a difference without being a seasoned developer.
## Contributing Code Changes
AzuraCast is open-source software, and as part of this dedication to openness and transparency, we fully support contributions from members of the community who are skilled in the languages that we use to build our applications.
AzuraCast is open-source software, and as part of this dedication to openness and transparency, we fully support
contributions from members of the community who are skilled in the languages that we use to build our applications.
A majority of our repositories come with an `.editorconfig` file in the root, which will set many standards for indentation, punctuation and other style items for you automatically. You may need to enable EditorConfig support in your IDE of choice.
A majority of our repositories come with an `.editorconfig` file in the root, which will set many standards for
indentation, punctuation and other style items for you automatically. You may need to enable EditorConfig support in
your IDE of choice.
If your IDE does not support EditorConfig, the most important standard to remember that we follow is the PHP Framework Interoperability Group's [PSR-12 Extended Coding Style](https://www.php-fig.org/psr/psr-12/) standard.
If your IDE does not support EditorConfig, the most important standard to remember that we follow is the PHP Framework
Interoperability Group's [PSR-12 Extended Coding Style](https://www.php-fig.org/psr/psr-12/) standard.
Accessibility, security, and modern best practices are very important in AzuraCast's development. Any newly contributed code can, and should, take advantage of the full suite of new features made available in PHP 7.4 and newer.
Accessibility, security, and modern best practices are very important in AzuraCast's development. Any newly contributed
code can, and should, take advantage of the full suite of new features made available in PHP 7.4 and newer.
Instructions for developing with AzuraCast locally are [available here](https://www.azuracast.com/developers). If you have questions about the guidelines above or about how to contribute to AzuraCast, please create a Github issue, join our [Discord server.](https://www.azuracast.com/discord) Please note that support is offered on an 'as available' basis.
Instructions for developing with AzuraCast locally
are [available here](https://docs.azuracast.com/en/developers/getting-started). If you have questions about the
guidelines above or about how to contribute to AzuraCast, please create a Github issue, join
our [Discord server.](https://www.azuracast.com/discord) Please note that support is offered on an 'as available' basis.
Contributions are also welcome in the supporting technologies used to make AzuraCast possible, such as:
- Dockerfiles (see [our separate repositories](https://github.com/AzuraCast) for Docker containers)
- [Ansible configuration](https://github.com/AzuraCast/AzuraCast/tree/main/util/ansible) for Ansible installs
- Dockerfiles (see [our separate repositories](https://github.com/AzuraCast) for Docker containers)
- [Ansible configuration](https://github.com/AzuraCast/AzuraCast/tree/main/util/ansible) for Ansible installs
## Translating AzuraCast
Do you speak both English and another language? You can help us in a _big_ way by helping translate AzuraCast!
AzuraCast is used around the world, and we want our web application to be accessible to users who aren't familiar with English, our primary language.
AzuraCast is used around the world, and we want our web application to be accessible to users who aren't familiar with
English, our primary language.
Thanks to the help of our friends at CrowdIn, translating the strings used in our application is easy! Just [follow this invite link](https://crowdin.com/project/azuracast/invite) and create an account, and you can start submitting translations. CrowdIn also provides suggested translations in case you are unsure of certain words or phrases.
Thanks to the help of our friends at CrowdIn, translating the strings used in our application is easy!
Just [follow this invite link](https://crowdin.com/project/azuracast/invite) and create an account, and you can start
submitting translations. CrowdIn also provides suggested translations in case you are unsure of certain words or
phrases.
We do our best to incorporate translation changes as frequently as possible, but sometimes new updates are delayed. If you have completed a significant translation project, please feel free to give us a gentle reminder by creating a Github issue. Once the translations have been updated, we will close the issue to let you know.
We do our best to incorporate translation changes as frequently as possible, but sometimes new updates are delayed. If
you have completed a significant translation project, please feel free to give us a gentle reminder by creating a Github
issue. Once the translations have been updated, we will close the issue to let you know.
## Testing New Platforms
Getting a project as large and complex as AzuraCast to work on many platforms is a huge effort, and is often far too complex for a single-developer project such as this.
Getting a project as large and complex as AzuraCast to work on many platforms is a huge effort, and is often far too
complex for a single-developer project such as this.
Thankfully, we've adopted support for Docker, a tool that allows us to create prebuilt images with all of our software stack properly configured and arranged, which you can then run on just about any host that will run the latest version of Docker. It's portable, it's cross-platform, and pulling down new updates are far easier than before; for these reasons, we heavily emphasize using Docker over our older, Ubuntu-specific Ansible installation.
Thankfully, we've adopted support for Docker, a tool that allows us to create prebuilt images with all of our software
stack properly configured and arranged, which you can then run on just about any host that will run the latest version
of Docker. It's portable, it's cross-platform, and pulling down new updates are far easier than before; for these
reasons, we heavily emphasize using Docker over our older, Ubuntu-specific Ansible installation.
Although we use Docker in local development and on our testing and demonstration servers, sometimes a problem will occur that stops a particular host from working with our application. If you're a user affected by such an issue, we encourage you to advise us by creating a Github issue, especially if there is a known solution to the issue that we can apply.
Although we use Docker in local development and on our testing and demonstration servers, sometimes a problem will occur
that stops a particular host from working with our application. If you're a user affected by such an issue, we encourage
you to advise us by creating a Github issue, especially if there is a known solution to the issue that we can apply.
## The "Do Nots" of Contributing
While we appreciate everyone who is eager to contribute to this project and help it succeed, we must ask that some forms of interaction be avoided:
While we appreciate everyone who is eager to contribute to this project and help it succeed, we must ask that some forms
of interaction be avoided:
- Please **do not e-mail the project developer directly** with questions or issues specific to AzuraCast, unless you were specifically requested to do so as part of an ongoing issue. Contacting me directly prevents me from tracking all outstanding issues in one place, and harms the transparency that is essential to FOSS development. If, however, you are e-mailing me to offer me a paying job...go nuts.
- Please **do not e-mail the project developer directly** with questions or issues specific to AzuraCast, unless you
were specifically requested to do so as part of an ongoing issue. Contacting me directly prevents me from tracking all
outstanding issues in one place, and harms the transparency that is essential to FOSS development. If, however, you
are e-mailing me to offer me a paying job...go nuts.
- Please **do not create "this doesn't work" issues** that are just one sentence long and don't provide any insight into the scope of the issue, what changes might have triggered it, or what platform you're running on. At the very minimum, please fill out the template provided, as it gives us a lot of information to debug and provide you with support.
- Please **do not create "this doesn't work" issues** that are just one sentence long and don't provide any insight into
the scope of the issue, what changes might have triggered it, or what platform you're running on. At the very minimum,
please fill out the template provided, as it gives us a lot of information to debug and provide you with support.
- Please **refer to existing Github issues** if you are curious about the status of outstanding bug reports or new enhancement requests. Always remember that this is a volunteer project primarily built and maintained by a single developer, and manage your expectations accordingly.
- Please **refer to existing Github issues** if you are curious about the status of outstanding bug reports or new
enhancement requests. Always remember that this is a volunteer project primarily built and maintained by a single
developer, and manage your expectations accordingly.
## Support AzuraCast
### Support us on GitHub Sponsors
Donating through GitHub Sponsors is the best way to show your support for AzuraCast's development. You can change your pledge at any time through the Sponsors Page. GitHub will match every sponsor on our page so every donation counts.
Donating through GitHub Sponsors is the best way to show your support for AzuraCast's development. You can change your
pledge at any time through the Sponsors Page. GitHub will match every sponsor on our page so every donation counts.
[GitHub Sponsor Page][sponsor]
@ -60,12 +90,14 @@ Donating through GitHub Sponsors is the best way to show your support for AzuraC
### Donate to our Patreon
Donating to AzuraCast's Patreon is a great way to show your ongoing support for the project's continual development and updates. You can edit your pledge or cancel at any time.
Donating to AzuraCast's Patreon is a great way to show your ongoing support for the project's continual development and
updates. You can edit your pledge or cancel at any time.
<a href="https://www.patreon.com/bePatron?u=232463" target="_blank" title="Become a Patron"><img src="https://c5.patreon.com/external/logo/become_a_patron_button.png"></a>
### Donate via Ko-Fi
If you'd like to make a one-time donation through PayPal, you can do so by buying our lead developer a coffee (or two!) via the Ko-Fi payment service. Every donation is greatly appreciated.
If you'd like to make a one-time donation through PayPal, you can do so by buying our lead developer a coffee (or two!)
via the Ko-Fi payment service. Every donation is greatly appreciated.
<a href="https://ko-fi.com/A736ATQ" target="_blank" title="Buy me a coffee!"><img height='32' style='border:0px;height:32px;' src='https://az743702.vo.msecnd.net/cdn/kofi1.png?v=b' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>

128
README.md
View File

@ -8,50 +8,73 @@
[![Docker Pulls](https://img.shields.io/docker/pulls/azuracast/azuracast_radio.svg)](https://hub.docker.com/r/azuracast/azuracast_radio/)
[![Twitter Follow](https://img.shields.io/twitter/follow/azuracast.svg?style=social&label=Follow)](https://twitter.com/azuracast)
**AzuraCast** is a self-hosted, all-in-one web radio management suite. Using its easy installer and powerful but intuitive web interface, you can start up a fully working web radio station in a few quick minutes.
**AzuraCast** is a self-hosted, all-in-one web radio management suite. Using its easy installer and powerful but
intuitive web interface, you can start up a fully working web radio station in a few quick minutes.
![](https://www.azuracast.com/img/ScreenshotTour.gif)
AzuraCast works for web radio stations of all types and sizes, and is built to run on even the most affordable VPS web hosts. AzuraCast's mascot is [Azura Ruisselante](https://www.azuracast.com/about/mascot.html), created by [Tyson Tan](https://tysontan.deviantart.com/).
AzuraCast works for web radio stations of all types and sizes, and is built to run on even the most affordable VPS web
hosts. AzuraCast's mascot is Azura Ruisselante, created by [Tyson Tan](https://tysontan.deviantart.com/).
**AzuraCast is currently in beta.** Many web radio stations already run AzuraCast, but keeping your server up-to-date with the latest code from the GitHub repository is strongly recommended for security, bug fixes and new feature releases. It's unlikely, but updates may result in unexpected issues or data loss, so always make sure to keep your station's media files backed up in a second location.
**AzuraCast is currently in beta.** Many web radio stations already run AzuraCast, but keeping your server up-to-date
with the latest code from the GitHub repository is strongly recommended for security, bug fixes and new feature
releases. It's unlikely, but updates may result in unexpected issues or data loss, so always make sure to keep your
station's media files backed up in a second location.
To install AzuraCast, you should have a basic understanding of the Linux shell terminal. Once installed, every aspect of your radio station can be managed via AzuraCast's web interface.
To install AzuraCast, you should have a basic understanding of the Linux shell terminal. Once installed, every aspect of
your radio station can be managed via AzuraCast's web interface.
## Live Demo
Want to see AzuraCast for yourself? Check out [screenshots](https://www.azuracast.com/about/screenshots.html) or visit
our demo site at [demo.azuracast.com](https://demo.azuracast.com/):
Want to see AzuraCast for yourself? Visit our demo site at [demo.azuracast.com](https://demo.azuracast.com/):
* Username: `demo@azuracast.com`
* Password: `demo`
## Install AzuraCast
Follow our **[installation guide](https://azuracast.com/install/)** for instructions on how to install AzuraCast on your own server.
Follow our **[installation guide](https://docs.azuracast.com/en/getting-started/installation)** for instructions on how
to install AzuraCast on your own server.
## Features
#### For Radio Stations
- **Rich Media Management:** Upload songs, edit metadata, preview songs and organize music into folders from your browser.
- **Playlists:** Add music to standard-rotation playlists (in sequential or shuffled playback order) or schedule a playlist to play at a scheduled time, or once per x songs/minutes/etc.
- **Live DJs:** Set up individual DJ/streamer accounts and see who's currently streaming from your station's profile page.
- **Web DJ:** Broadcast live directly from your browser, with no extra software needed, with AzuraCast's built-in Web DJ tool.
- **Public Pages:** AzuraCast includes embeddable public pages that you can integrate into your existing web page or use as the basis for your own customized player.
- **Listener Requests:** Let your listeners request specific songs from your playlists, both via an API and a simple public-facing listener page.
- **Rich Media Management:** Upload songs, edit metadata, preview songs and organize music into folders from your
browser.
- **Playlists:** Add music to standard-rotation playlists (in sequential or shuffled playback order) or schedule a
playlist to play at a scheduled time, or once per x songs/minutes/etc.
- **Live DJs:** Set up individual DJ/streamer accounts and see who's currently streaming from your station's profile
page.
- **Web DJ:** Broadcast live directly from your browser, with no extra software needed, with AzuraCast's built-in Web DJ
tool.
- **Public Pages:** AzuraCast includes embeddable public pages that you can integrate into your existing web page or use
as the basis for your own customized player.
- **Listener Requests:** Let your listeners request specific songs from your playlists, both via an API and a simple
public-facing listener page.
- **Remote Relays:** Broadcast your radio signal (including live DJs) to any remote server running Icecast or SHOUTcast.
- **Web Hooks:** Integrate your station with Slack, Discord, TuneIn, Twitter and more by setting up web hooks that connect to third-party services.
- **Detailed Analytics and Reports:** Keep track of every aspect of your station's listeners over time. View reports of each song's impact on your listener count. You can also generate a report that's compatible with SoundExchange for US web radio royalties.
- **Web Hooks:** Integrate your station with Slack, Discord, TuneIn, Twitter and more by setting up web hooks that
connect to third-party services.
- **Detailed Analytics and Reports:** Keep track of every aspect of your station's listeners over time. View reports of
each song's impact on your listener count. You can also generate a report that's compatible with SoundExchange for US
web radio royalties.
#### For Server Administrators
- **Role-based User Management:** Assign global and per-station permissions to a role, then add users to those roles to control access.
- **Custom Branding:** Modify every aspect of both the internal and public-facing AzuraCast pages by supplying your own custom CSS and JavaScript.
- **Authenticated RESTful API:** Individual users in the system can create API keys which have the same permissions they have in the system. The AzuraCast API is a powerful and [well-documented](https://www.azuracast.com/api/index.html) tool for interacting with installations.
- **Web Log Viewing:** Quickly diagnose problems affecting any part of the AzuraCast system through the system-wide web log viewer.
- **Automatic Radio Proxies:** Many users can't connect directly to radio station ports (i.e. 8000) by default, so AzuraCast includes an automatic nginx proxy that lets listeners connect via the http (80) and https (443) ports. These proxies are also compatible with services like CloudFlare.
- **Storage Location Management:** Station media, live recordings and backups can be stored localy or on an S3 compatible storage provider.
- **Role-based User Management:** Assign global and per-station permissions to a role, then add users to those roles to
control access.
- **Custom Branding:** Modify every aspect of both the internal and public-facing AzuraCast pages by supplying your own
custom CSS and JavaScript.
- **Authenticated RESTful API:** Individual users in the system can create API keys which have the same permissions they
have in the system. The AzuraCast API is a powerful and [well-documented](https://www.azuracast.com/api/index.html)
tool for interacting with installations.
- **Web Log Viewing:** Quickly diagnose problems affecting any part of the AzuraCast system through the system-wide web
log viewer.
- **Automatic Radio Proxies:** Many users can't connect directly to radio station ports (i.e. 8000) by default, so
AzuraCast includes an automatic nginx proxy that lets listeners connect via the http (80) and https (443) ports. These
proxies are also compatible with services like CloudFlare.
- **Storage Location Management:** Station media, live recordings and backups can be stored localy or on an S3
compatible storage provider.
### What's Included
@ -62,7 +85,9 @@ AzuraCast will automatically retrieve and install these components for you:
* **[Liquidsoap](https://www.liquidsoap.info/)** as the always-playing "AutoDJ"
* **[Icecast 2.4](https://icecast.org/)** as a radio broadcasting frontend (Icecast-KH installed on supported platforms)
For x86/x64 installations, [SHOUTcast 2 DNAS](http://wiki.shoutcast.com/wiki/SHOUTcast_DNAS_Server_2) can also be used as a broadcasting frontend. SHOUTcast is non-free software and does not come bundled with AzuraCast, but can be installed via the administration panel after AzuraCast has been installed.
For x86/x64 installations, [SHOUTcast 2 DNAS](http://wiki.shoutcast.com/wiki/SHOUTcast_DNAS_Server_2) can also be used
as a broadcasting frontend. SHOUTcast is non-free software and does not come bundled with AzuraCast, but can be
installed via the administration panel after AzuraCast has been installed.
#### Supporting Software
@ -73,49 +98,76 @@ For x86/x64 installations, [SHOUTcast 2 DNAS](http://wiki.shoutcast.com/wiki/SHO
## AzuraCast API
Once installed and running, AzuraCast exposes an API that allows you to monitor and interact with your stations. Documentation about this API and its endpoints are available on the [AzuraCast API Documentation](https://www.azuracast.com/api/index.html).
Once installed and running, AzuraCast exposes an API that allows you to monitor and interact with your stations.
Documentation about this API and its endpoints are available on
the [AzuraCast API Documentation](https://www.azuracast.com/api/index.html).
## License
AzuraCast is licensed under the [Apache license, version 2.0](https://github.com/AzuraCast/AzuraCast/blob/main/LICENSE.txt). This project is free and open-source software, and pull requests are always welcome.
AzuraCast is licensed under
the [Apache license, version 2.0](https://github.com/AzuraCast/AzuraCast/blob/main/LICENSE.txt). This project is free
and open-source software, and pull requests are always welcome.
## Need Help?
If you need help with AzuraCast, the first place you should visit is our [Support page](https://www.azuracast.com/help/), which features solutions to a number of commonly encountered issues and questions, as well as instructions on how to check your server's log files for more details. If you do need our help via GitHub, supplying these logs is absolutely essential in helping us diagnose and resolve your issue.
If you need help with AzuraCast, the first place you should visit is
our [Support page](https://docs.azuracast.com/en/user-guide/troubleshooting)
, which features solutions to a number of commonly encountered issues and questions, as well as instructions on how to
check your server's log files for more details. If you do need our help via GitHub, supplying these logs is absolutely
essential in helping us diagnose and resolve your issue.
New feature requests are powered by FeatureUpvote. You can visit our [Feature Request Page](https://features.azuracast.com/) to submit a new feature request or vote on existing ones.
New feature requests are powered by FeatureUpvote. You can visit
our [Feature Request Page](https://features.azuracast.com/) to submit a new feature request or vote on existing ones.
For bug and error reports, we rely exclusively on our [GitHub Issues board](https://github.com/AzuraCast/AzuraCast/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc) to diagnose, track and update these reports. First, check to make sure the issue you're experiencing isn't already reported on GitHub. If it is, you can subscribe to the existing ticket for updates on the issue's progress. If your issue or request isn't already reported, click the "New Issue" button to create it. Make sure to follow the template provided, as it asks important details that are very important to our team.
For bug and error reports, we rely exclusively on
our [GitHub Issues board](https://github.com/AzuraCast/AzuraCast/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc) to
diagnose, track and update these reports. First, check to make sure the issue you're experiencing isn't already reported
on GitHub. If it is, you can subscribe to the existing ticket for updates on the issue's progress. If your issue or
request isn't already reported, click the "New Issue" button to create it. Make sure to follow the template provided, as
it asks important details that are very important to our team.
Please keep in mind that AzuraCast is a free software project built and maintained by volunteers, so there may be some delays in getting back to you. We will make the absolute best effort possible to resolve your issues and answer your questions.
Please keep in mind that AzuraCast is a free software project built and maintained by volunteers, so there may be some
delays in getting back to you. We will make the absolute best effort possible to resolve your issues and answer your
questions.
## Communities and Social Media
We frequently post to social media any time there are significant updates to our software, security issues that users should be aware of, or upcoming changes to third-party software. You can get these updates in a more timely fashion by following our accounts:
We frequently post to social media any time there are significant updates to our software, security issues that users
should be aware of, or upcoming changes to third-party software. You can get these updates in a more timely fashion by
following our accounts:
- On Twitter at [@AzuraCast](https://twitter.com/azuracast), or
- On Mastodon at [@AzuraCast@fosstodon.org](https://fosstodon.org/@AzuraCast)
If you are an AzuraCast user, station owner, developer or other contributor, you can also join our Discord community, where you can ask questions, share your station and more:
If you are an AzuraCast user, station owner, developer or other contributor, you can also join our Discord community,
where you can ask questions, share your station and more:
- [Discord](https://azuracast.com/discord)
- [Discord](https://discord.gg/azuracast)
Note that our social media channels aren't the best way to report issues to us; instead, you should use the GitHub issues instructions above, as this allows our whole team to help resolve and track the progress of the issue in one location.
Note that our social media channels aren't the best way to report issues to us; instead, you should use the GitHub
issues instructions above, as this allows our whole team to help resolve and track the progress of the issue in one
location.
## Friends of AzuraCast
We would like to thank the following organizations for their support of AzuraCast's ongoing development:
- [DigitalOcean](https://m.do.co/c/21612b90440f) for generously providing the server resources we use for our demonstration instance, our staging and testing environments, and more
- [JetBrains](https://www.jetbrains.com/) for making our development faster, easier and more productive with tools like PhpStorm
- [CrowdIn](https://crowdin.com/) for giving us a simple and powerful tool to help translate our application for users around the world
- [Netlify](https://www.netlify.com/) for supporting open-source software like ours and for serving as the host of our primary [azuracast.com](https://www.azuracast.com/) web site.
- [DigitalOcean](https://m.do.co/c/21612b90440f) for generously providing the server resources we use for our
demonstration instance, our staging and testing environments, and more
- [JetBrains](https://www.jetbrains.com/) for making our development faster, easier and more productive with tools like
PhpStorm
- [CrowdIn](https://crowdin.com/) for giving us a simple and powerful tool to help translate our application for users
around the world
- [Netlify](https://www.netlify.com/) for supporting open-source software like ours and for serving as the host of our
primary [azuracast.com](https://www.azuracast.com/) web site.
- The creators and maintainers of the many free and open-source tools that AzuraCast is built on, who have done so much to help move FOSS forward
- The creators and maintainers of the many free and open-source tools that AzuraCast is built on, who have done so much
to help move FOSS forward
## Support AzuraCast Development
AzuraCast will always be available free of charge, but if you find the software useful and would like to support the project's lead developer, visit either of the links below. Your support is greatly appreciated.
AzuraCast will always be available free of charge, but if you find the software useful and would like to support the
project's lead developer, visit either of the links below. Your support is greatly appreciated.
<a href="https://ko-fi.com/silvereagle" target="_blank" title="Buy me a coffee!"><img height='32' style='border:0px;height:32px;' src='https://az743702.vo.msecnd.net/cdn/kofi1.png?v=b' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>

5
SUPPORT.md
View File

@ -1,5 +1,6 @@
# Support for AzuraCast
We've centralized all of our help and common support issues to a single location on our homepage. Click the link below for more information.
We've centralized all of our help and common support issues to a single location on our homepage. Click the link below
for more information.
- [AzuraCast Help Page](https://www.azuracast.com/help/)
- [AzuraCast Help Page](https://docs.azuracast.com/en/user-guide/troubleshooting)

2
config/forms/settings.php
View File

@ -207,7 +207,7 @@ return [
'markup' => '<strong>' . $releaseChannelName . '</strong>',
'description' => __(
'For information on how to switch your release channel, visit <a href="%s" target="_blank">this page</a>.',
'https://www.azuracast.com/administration/system/release-channels.html'
'https://docs.azuracast.com/en/getting-started/updates/release-channels'
),
],
],

4
docker-compose.sample.yml
View File

@ -49,7 +49,7 @@ services :
container_name : azuracast_web
image : "azuracast/azuracast_web_v2:${AZURACAST_VERSION:-latest}"
# Want to customize the HTTP/S ports? Follow the instructions here:
# https://www.azuracast.com/help/docker/#use-non-standard-ports
# https://docs.azuracast.com/en/administration/docker#using-non-standard-ports
ports :
- '${AZURACAST_SFTP_PORT:-2022}:2022'
depends_on :
@ -117,7 +117,7 @@ services :
# This default mapping is the outgoing and incoming ports for the first 50 stations.
# You can override this port mapping in your own docker-compose.override.yml file.
# For instructions, see:
# https://www.azuracast.com/help/docker/#expand-the-docker-radio-station-port-range
# https://docs.azuracast.com/en/administration/docker#expanding-the-station-port-range
- '8000:8000'
- '8005:8005'
- '8006:8006'

2
frontend/vue/station_playlists/form/PlaylistFormBasicInfo.vue
View File

@ -79,7 +79,7 @@
<translate key="lang_form_type_custom">Advanced</translate>
<span class="form-text mt-0">
<translate key="lang_form_type_custom_desc">Manually define how this playlist is used in Liquidsoap configuration.</translate>
<a href="https://www.azuracast.com/station-management/playlists/#advanced-playlists" target="_blank">
<a href="https://docs.azuracast.com/en/user-guide/playlists/advanced-playlists" target="_blank">
<translate key="lang_form_type_custom_more">Learn about Advanced Playlists</translate>
</a>
</span>

2
src/Version.php
View File

@ -22,7 +22,7 @@ class Version
public const LATEST_COMPOSE_REVISION = 11;
public const LATEST_COMPOSE_URL = 'https://raw.githubusercontent.com/AzuraCast/AzuraCast/main/docker-compose.sample.yml';
public const UPDATE_URL = 'https://www.azuracast.com/administration/system/updating.html';
public const UPDATE_URL = 'https://docs.azuracast.com/en/getting-started/updates';
public const CHANGELOG_URL = 'https://github.com/AzuraCast/AzuraCast/blob/main/CHANGELOG.md';
// phpcs:enable

45
templates/frontend/account/login.phtml
View File

@ -1,8 +1,12 @@
<?php
$this->layout('minimal', [
'title' => __('Log In'),
'page_class' => 'login-content',
]);
$this->layout(
'minimal',
[
'title' => __('Log In'),
'page_class' => 'login-content',
]
);
?>
<div class="public-page">
@ -11,16 +15,21 @@ $this->layout('minimal', [
<div class="row mb-4">
<div class="col-sm">
<h2 class="card-title mb-0 text-center">
<?php if ($customization->hideProductName()): ?>
<?php
if ($customization->hideProductName()): ?>
<?=__('Welcome!')?>
<?php else: ?>
<?php
else: ?>
<?=sprintf(__('Welcome to %s!'), $environment->getAppName())?>
<?php endif; ?>
<?php
endif; ?>
</h2>
<h3 class="text-center">
<?php if (!empty($customization->getInstanceName())): ?>
<?php
if (!empty($customization->getInstanceName())): ?>
<small class="text-muted"><?=$this->e($customization->getInstanceName())?></small>
<?php endif; ?>
<?php
endif; ?>
</h3>
</div>
</div>
@ -31,14 +40,18 @@ $this->layout('minimal', [
<i class="material-icons mr-1" aria-hidden="true">email</i>
<strong><?=__('E-mail Address')?></strong>
</label>
<input type="email" name="username" class="form-control" placeholder="<?=__('name@example.com')?>" aria-label="<?=__('E-mail Address')?>" required autofocus>
<input type="email" name="username" class="form-control" placeholder="<?=__(
'name@example.com'
)?>" aria-label="<?=__('E-mail Address')?>" required autofocus>
</div>
<div class="form-group mt-2">
<label for="password" class="mb-2">
<i class="material-icons mr-1" aria-hidden="true">vpn_key</i>
<strong><?=__('Password')?></strong>
</label>
<input type="password" name="password" class="form-control" placeholder="<?=__('Enter your password')?>" aria-label="<?=__('Password')?>" required>
<input type="password" name="password" class="form-control" placeholder="<?=__(
'Enter your password'
)?>" aria-label="<?=__('Password')?>" required>
</div>
<div class="form-group mt-2">
<div class="custom-control custom-checkbox">
@ -48,13 +61,17 @@ $this->layout('minimal', [
</label>
</div>
</div>
<button type="submit" role="button" title="<?=__('Sign in')?>" class="btn btn-login btn-primary btn-block mt-2 mb-3">
<button type="submit" role="button" title="<?=__(
'Sign in'
)?>" class="btn btn-login btn-primary btn-block mt-2 mb-3">
<?=__('Sign in')?>
</button>
</form>
<p class="text-center"><?=__('Please log in to continue.')?> <?=sprintf(__('<a href="%s" target="_blank">Forgot your password?</a>'),
'https://www.azuracast.com/help/docker/#reset-an-account-password')?></p>
<p class="text-center"><?=__('Please log in to continue.')?> <?=sprintf(
__('<a href="%s" target="_blank">Forgot your password?</a>'),
'https://docs.azuracast.com/en/administration/users#resetting-an-account-password'
)?></p>
</div>
</div>
</div>

4
templates/main.phtml
View File

@ -106,7 +106,7 @@ endif; ?>">
</a>
</li>
<li>
<a class="dropdown-item" href="https://www.azuracast.com/help/" target="_blank">
<a class="dropdown-item" href="https://docs.azuracast.com/en/user-guide/troubleshooting" target="_blank">
<i class="material-icons" aria-hidden="true">help</i>
<?=__('Help')?>
</a>
@ -185,7 +185,7 @@ endif; ?> role="contentinfo">
<br>
<?=__(
'Like our software? <a href="%s" target="_blank">Donate to support AzuraCast!</a>',
'https://www.azuracast.com/donate.html'
'https://docs.azuracast.com/en/contribute/donate'
)?>
</footer>

20
templates/minimal.phtml
View File

@ -43,16 +43,19 @@ $page_class .= ' theme-' . $customization->getPublicTheme();
<?=$this->section('content')?>
<?php if (!$customization->hideProductName() && !$hide_footer): ?>
<?php
if (!$customization->hideProductName() && !$hide_footer): ?>
<footer id="footer" class="footer-alt" role="contentinfo">
<?=sprintf(__('Powered by %s'),
'<a href="https://azuracast.com/" target="_blank">' . $environment->getAppName() . '</a>' . ' ')?><br>
<?=sprintf(__('Mascot designed by %s'),
'<a href="https://tysontan.deviantart.com/" target="_blank">Tyson Tan</a>')?>
<?=sprintf(
__('Powered by %s'),
'<a href="https://azuracast.com/" target="_blank">' . $environment->getAppName() . '</a>' . ' '
)?>
</footer>
<?php endif; ?>
<?php
endif; ?>
<?php if (null !== $flash && $flash->hasMessages()): ?>
<?php
if (null !== $flash && $flash->hasMessages()): ?>
<script type="text/javascript" nonce="<?=$assets->getCspNonce()?>">
$(function () {
<?php foreach($flash->getMessages() as $message): ?>
@ -60,6 +63,7 @@ $page_class .= ' theme-' . $customization->getPublicTheme();
<?php endforeach; ?>
});
</script>
<?php endif; ?>
<?php
endif; ?>
</body>
</html>

12
templates/partials/log_help_card.phtml
View File

@ -3,13 +3,17 @@
<h2 class="card-title"><?=__('Need Help?')?></h2>
</div>
<div class="card-body">
<p><?=__('You can find answers for many common questions in our <a href="%s" target="_blank">support documents</a>.',
'https://www.azuracast.com/help/')?></p>
<p><?=__(
'You can find answers for many common questions in our <a href="%s" target="_blank">support documents</a>.',
'https://docs.azuracast.com/en/user-guide/troubleshooting'
)?></p>
<p><?=__('If you\'re experiencing a bug or error, you can submit a GitHub issue using the link below.')?></p>
<p><?=__('Your current installation type is <b>%s</b>. Be sure to include this when creating a new issue.',
($environment->isDocker() ? 'Docker' : 'Ansible'))?></p>
<p><?=__(
'Your current installation type is <b>%s</b>. Be sure to include this when creating a new issue.',
($environment->isDocker() ? 'Docker' : 'Ansible')
)?></p>
</div>
<div class="card-actions">
<a class="btn btn-outline-primary" role="button" href="https://github.com/AzuraCast/AzuraCast/issues/new/choose" target="_blank">

44
templates/stations/streamers/index.phtml
View File

@ -1,11 +1,17 @@
<?php
$this->layout('main', ['title' => __('Streamer/DJ Accounts'), 'manual' => true]);
/** @var \App\Assets $assets */
$assets->load('StationStreamers')
->addInlineJs($this->fetch('stations/streamers/index.js', [
'station_tz' => $station_tz,
]));
->addInlineJs(
$this->fetch(
'stations/streamers/index.js',
[
'station_tz' => $station_tz,
]
)
);
?>
<div class="row">
@ -22,10 +28,14 @@ $assets->load('StationStreamers')
<dl>
<dt class="mb-1"><?=__('Server')?>:</dt>
<dd><code><?=$this->e($server_url)?></code></dd>
<?php if ($ip): ?>
<dd><?=__('You may need to connect directly via your IP address, which is <code>%s</code>.',
$ip)?></dd>
<?php endif; ?>
<?php
if ($ip): ?>
<dd><?=__(
'You may need to connect directly via your IP address, which is <code>%s</code>.',
$ip
)?></dd>
<?php
endif; ?>
<dt class="mb-1"><?=__('Port')?>:</dt>
<dd><code><?=(int)$stream_port?></code></dd>
@ -38,10 +48,14 @@ $assets->load('StationStreamers')
<dl>
<dt class="mb-1"><?=__('Server')?>:</dt>
<dd><code><?=$this->e($server_url)?></code></dd>
<?php if ($ip): ?>
<dd><?=__('You may need to connect directly via your IP address, which is <code>%s</code>.',
$ip)?></dd>
<?php endif; ?>
<?php
if ($ip): ?>
<dd><?=__(
'You may need to connect directly via your IP address, which is <code>%s</code>.',
$ip
)?></dd>
<?php
endif; ?>
<dt class="mb-1"><?=__('Port')?>:</dt>
<dd><code><?=__('%d (%d for some clients)', (int)$stream_port, ((int)$stream_port + 1))?></code>
@ -55,8 +69,12 @@ $assets->load('StationStreamers')
</dd>
</dl>
<p><?=sprintf(__('Setup instructions for broadcasting software are available <a href="%s" target="_blank">on the AzuraCast Wiki</a>.'),
'https://www.azuracast.com/station-management/djs/streaming_software.html')?></p>
<p><?=sprintf(
__(
'Setup instructions for broadcasting software are available <a href="%s" target="_blank">on the AzuraCast Wiki</a>.'
),
'https://docs.azuracast.com/en/user-guide/streaming-software'
)?></p>
</div>
</div>
</div>