A React interface for Ampache player.
Phyks (Lucas Verney) 5f6eec6330 Clicking on play button next to song title on playlist page was not starting playback when nothing was already playing 2 years ago
app Clicking on play button next to song title on playlist page was not starting playback when nothing was already playing 2 years ago
hooks Major code review 2 years ago
public Clicking on play button next to song title on playlist page was not starting playback when nothing was already playing 2 years ago
scripts Basic error mechanism in webplayer 2 years ago
.babelrc Fix mixed content blocked when browsing the UI on HTTPS 3 years ago
.bootstraprc Move to CSS modules 3 years ago
.eslintignore Major code review 2 years ago
.eslintrc.js Rework webplayer 2 years ago
.gitignore More reliable build, spinning loading wheel and beginning of webplayer 2 years ago
.stylelintrc Add Travis-CI build + restore stylelint 3 years ago
.travis.yml Add Travis-CI build + restore stylelint 3 years ago
CONTRIBUTING.md Add more prettty and human readable artists URLs 2 years ago
LICENSE Initial commit 3 years ago
README.md Set min and max bounds in page modal input. Closes #18 2 years ago
favicon.ico Initial commit 3 years ago
fix.ie9.js Major code review 2 years ago
index.all.js Major code review 2 years ago
index.development.js Major code review 2 years ago
index.html Major code review 2 years ago
index.js Major code review 2 years ago
index.production.js Major code review 2 years ago
package.json Basic webplayer Now able to play a single file, in a format supported by your browser. 2 years ago
webpack.config.base.js Major code review 2 years ago
webpack.config.development.js Major code review 2 years ago
webpack.config.js Initial commit 3 years ago
webpack.config.production.js Major code review 2 years ago

README.md

Ampache React

This is an alternative web interface for Ampache built using Ampache XML API and React.

Trying it out

Just drop this repo in a location served by a webserver, make your webserver serve the public folder and head your browser to the correct URL :)

Or you can use the hosted version.

Requirements

To use this interface, you need:

  • An Ampache server on which you have an account, serving the XML API. Ensures your server has correct CORS header set.
  • A modern browser.

For now, this is a work in progress and as such, the hosted version (or gh-pages branch) always require the latest develop branch of Ampache. As soon as this is stabilized and Ampache gets a new version, this note will be updated with the required Ampache version.

Note that master branch may differ from gh-pages branch from time to time, and master branch may rely on commits that are not yet in Ampache develop branch. gh-pages branch is ensured to be working with latest Ampache develop branch.

Support

The supported browsers should be:

  • IE >= 9 (previous versions of IE are no longer supported by Microsoft)
  • Any last three versions of major browsers (> 1% net share).
  • No support provided for Opera Mini.

If you experience any issue, please report :)

Building

Building of this app relies on webpack.

First do a npm install to install all the required dependencies.

Then, to make a development build, just run webpack in the root folder. To make a production build, just run NODE_ENV=production webpack in the root folder. All files will be generated in the public folder.

Please use the Git hooks (in hooks folder) to automatically make a build before comitting, as commit should always contain an up to date production build.

Compilation cache is stored in .cache at the root of this repo. Remember to clean it in case of compilation issues.

Contributing

See CONTRIBUTING.md file for extra infos.

License

This code is distributed under an MIT license.

Feel free to contribute and reuse. For more details, see LICENSE file.