INSTALLATION

REQUIREMENTS

Before starting you MUST have Azuracast installed either on your PC or hosted online. The Azuracast install guides can be found here - https://www.azuracast.com/docs/getting-started/installation/

 

Once Azuracast has been installed you can grab either the PHP or Windows file versions of the Touchlink Jukebox below, the PHP based one is for online hosting & Windows files for a local install.

 

FOR WINDOWS INSTALLS YOU WILL BE ASKED UPON INSTALL FOR:

 

API Base URL

Station ID

API Key

 

The API Base URL is going to be the URL/IP you use to login to Azuracast followed by /api (E.G. https://touchlink.co.uk/api)

 

The Station ID is found by loggin into Azuracast, going to system administration & then stations. You will then see both your station name & ID below it which may have an underscore between words, this is the name you need.

 

API key can be setup by clicking on the Menu within Azuracast, go to My Account and then press the +Add API Key button. Give it a description, press the create key and then copy the API key into the installer.

 

Please be aware the user you create the API key for must have sufficient permission within Azuracast for the station, Admin accounts etc will have this as default.

 

Press next on the installer, once complete the Jukebox will load up in your browser. We recommend adding this page to a bookmark for easy access in the future. To change any settings add /admin.php onto the URL.

 

For video playback to work you will also need a Youtube V3 Data API key, you can create one here - https://developers.google.com/youtube/v3

 

Once you have the key navigate to where you have installed the Jukebox (If default this will be: C:\Program Files (x86)\Touchlink Jukebox for AzuraCast\web) and edit the api_config.php file, you will see {YOUTUBE_API_KEY} to be replaced with your own, also ensure you remove the {} surrounding it.

 

For videos to load (Using video.php etc) on windows it will be blocked if using an internal IP to access such as 192.168.1.1, you will need to change this to your computer hostname.local (e.g. http://my-pc.local:8080/video.php) if you do not know your hostname open command prompt and type in: ipconfig /all

 

This will display your hostname at the top.

 

FOR ONLINE HOSTED PHP FILES:

 

Edit the api_config.php file to enter in your Azuracast API URL, station name & API key, optionally the Youtube Data v3 API key can also be filled. The instructions for finding these is the same as above.

 

Once saved navigate to /admin.php and ensure you enter the station name again and press save to trigger creation of settings.json, now if you visit index.php or any of the secondary screen files your Jukebox will load and pull through the Azuracast information.

NOT YOUR STYLE?

All themes are CSS styles meaning you can create your own with ease, modifying any colours, fonts, spacing, sizes or effects. Either add your new theme to the themes folder and add one line of code into the admin file or simply overwrite a pre-existing theme to save any extra coding.