web-music-player

Web Music Player is a simple way to play your own music on any device connected to the web (pc, smartphone, tablet, ...). It can work as a standalone application or in your smartphone browser.

You can manage your music with the MusicBrainz API integration.

Live demo here.

Installation and usage

Following example is based on Linux distribution with Apache :

1. Download the latest version here
2. Untar the archive : tar -xvzf web-music-player-master.tar.gz
3. Move the files into you web server directory mv web-music-player-master /var/www/wmp
4. Fix file permissions chown www-data:www-data /var/www/wmp -R
5. Create database stuff using with the database setup page
6. Update Admin user (edit password obviously)
7. Remove unnecessary files (/docs, /configuration/setup.php, ...)
8. Set your library folder
9. Enjoy 🎵

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

• Nioc - Initial work

See also the list of contributors who participated in this project.

Motivation

Our aim is to provide an easy to use web player able to handle a local catalog. Some awesome projects already exists but often with a complicated code.

API

Please see API description.

Contributing

The project is open and any contribution is welcome!

To keep the code clean, we use php-cs-fixer, before commit launch this on each edited files:

php /usr/local/bin/php-cs-fixer fix /path/to/editedFile.php -v --fixers=-psr0

You can handle all edited files with this single line:

cd /var/www/wmp; for file in $(git diff-index --name-only HEAD); do php /usr/local/bin/php-cs-fixer fix "$file" -v --fixers=-psr0; done

A little how-to for github:

1. Fork it
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes (with a detailled message): git commit -am 'Add an awesome feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details

Included project

This project includes the following:

• Font Awesome
• AngularJS
• normalize.css
• getID3()
• Sortable
• angular-loading-bar