How to use the Astroblahhh Basic JavaScript MP3 Player

by Apollia of Astroblahhh.Com - http://astroblahhh.com

7/21/2014


#------------------------------------------------------------------------------
#
# Except for parts not by Apollia:
#
#    Copyright (C) 2014  Apollia
#
#    This program is free software: you can redistribute it and/or modify
#    it under the terms of the GNU Affero General Public License as
#    published by the Free Software Foundation, either version 3 of the
#    License, or (at your option) any later version.
#
#    This program is distributed in the hope that it will be useful,
#    but WITHOUT ANY WARRANTY; without even the implied warranty of
#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#    GNU Affero General Public License for more details.
#
#    You should have received a copy of the GNU Affero General Public License
#    along with this program.  If not, see http://www.gnu.org/licenses/ .
#
#
#    Contact info:     http://astroblahhh.com/contact-apollia.shtml 
#
#
# Parts NOT by Apollia include: 
# 
# SoundManager 2, jQuery, and also, some modified snippets from 
# StackOverflow and from cashmusic.js from http://cashmusic.org/
#
# Thanks to the authors of all of the above!



I've only tested this player with:

	* Lucid Puppy Linux 5.2.8 version 004 with its built in web server Hiawatha
	
	* Astroblahhh.Com itself.
	
	* And another website set up pretty much the same way as Astroblahhh.Com.



-----------

If you're using Lucid Puppy 5.2.8 version 004 or something sufficiently similar:


First, decide whether or not you're comfortable running a web server on your computer.  

If you aren't, DON'T proceed with the following steps.


1. Copy all the files from the zip file of the Astroblahhh Music Player into:

	/root/Web-Server/
	
To quickly go to that folder - go to the folder "Hiawatha Web Server Control Scripts", and open the script "Open Web-Server folder".



2. Use the "Start Hiawatha" script in the folder "Hiawatha Web Server Control Scripts" to start the Hiawatha web server.



3. Use the "Open Astroblahhh MP3 Player in Default Web Browser" script in the folder "Hiawatha Web Server Control Scripts".


-------------------------


If you have a website, then, uploading the contents of the zip file to it and then just using your web browser to visit the astroblahhh-basic-mp3-player-version-1-in-javascript.html file wherever it is located on your website will hopefully work.


-------------------------

The sample music is from these public domain MP3s from MusOpen.org - http://musopen.org/

https://musopen.org/music/349/erik-satie/gymnopedie-no-1-harp-arr/
https://musopen.org/music/135/frederic-chopin/etude-no-1-from-etudes-op-25/


To change the player's queue of MP3 files, edit the mp3-player.js file, located here:

	Astroblahhh Basic MP3 Player version 1, in JavaScript/abplayer/players/MP3_Player/mp3-player.js


In the source code of that file, I listed some additional (also legal) MP3s which are commented out since they're too large (and probably too copyrighted) to include in the Astroblahhh Basic MP3 Player's zip file.

But, you can download those MP3s at these addresses:

	http://vgremix.com/songs/cosmo-candle
	http://vgremix.com/songs/nightfall
	http://vgremix.com/songs/stealth-chameleon
	http://vgremix.com/songs/miracle-dance
	
And uncomment the lines mentioning them to make it possible play them in the player.