Skip to content

mitchray/ample

Repository files navigation

Ample: A web browser client for Ampache v6+

Ample screenshot

Demo

View demo

  • User demo
  • Password demodemo

Translations

Edit or add new languages via Inlang

Installing

  1. Download Ample
    • Either from a prebuilt release
    • or compile yourself from Git repository (see Developing)
  2. Place it anywhere on your server
    • If you want to keep it close to your Ampache install, copy the ample folder into your Ampache public folder, then you can access by adding /ample to your Ampache server address e.g. yourampache.com/ample
    • Otherwise, you can put it anywhere you like (even on a different server from Ampache, just be mindful that the Ampache server will need CORS)
  3. At the login screen, enter the full URL of the Ampache server you wish to connect to
    • Alternatively you can hardcode an instance of Ample to a specific Ampache server, see Config file

Developing

  • Clone the Ample repository and from the ample directory cd ample
  • Install packages npm install
  • For development and hot reloading npm run dev
  • For building npm run build, and see the contents of dist

Additional console logging can be enabled by setting debugMode true in src/stores/state.js

Config file

{
  // your Ampache server URL without trailing slash
  "ampacheURL": "https://example.com", 
}