Skip to content

adambeer/beatstream-backend

Repository files navigation

Beat-Stream App PHP Backend

Description

This is the backend for the Beat-Stream music streaming app.

Requirements

  • PHP 5.4.0 or higher
  • MySQL
  • Optional: Google API key for accessing YouTube's search API
  • Optional: Last.fm API key for accessing artist/song database used for searching

Developer Documentation

http://adambeer.ca/beatstream

ATTENTION! The steps that are labled as "optional" above and below are optional because the features will work out-of-the-box but you may want to use your own keys for both YouTube and the Last.fm search service. The keys provided with the backend are my own keys and if everyone were to use them, errors would start to pop up saying too many requests are being sent. Using your own key will ensure that only your activity is counted towards these services and you wont run into problems.

Installation

  • First get web hosting. Set it up on your computer (advanced), use my company, or use your preferred web hosting provider.
  • Download the App backend zip file from GitHub.
  • Upload the ZIP file to a separate folder on your web hosting and unzip the ZIP file
  • Optional: Create a new Google API Project as well as an API key for accessing YouTube
    • In the top left beside Google APIs, click the dropdown and select New Project
    • Enter a name and push Create. With your new project selected, click "Credentials" on the left
    • Push the Create Credentials dropdown and select API Key. Copy the value from the input and then push Close.
    • Open the server_settings.php file with any text editor and paste the API key value in the place of the current value of $youtube_API_key
    • Save the file and make sure it is re-uploaded/pushed to the web server
  • Optional: Get a Last.fm API Account for searching for artists/songs in the app.
    • Click Get an API Account in the top-ish right
    • Follow the steps to create the account
    • Your API key will be displayed on the page once your account is created
    • Open the server_settings.php file with any text editor and paste the API key value in the place of the current value of $lastfm_API_key
    • Save the file and make sure it is re-uploaded/pushed to the web server
  • Create a new MySQL database, and copy the contents of the .sql file included in the ZIP and execute the code through something like phpMyAdmin (if you dont know how to do this, Google it)
  • Open the server_settings.php file with any text editor and update the database settings to your newly created database. Save the file and make sure it is re-uploaded/pushed to the web server.
  • Thats it! You'll want to open your app now and when prompted, type out or paste the url to the app backend files. If you created a "musicapp" folder on your website, the url will be http://yourwebsite.com/musicapp.

About

Personal music streaming service app backend

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages