Ample: A web browser client for Ampache v6+
![Ample screenshot](https://private-user-images.githubusercontent.com/5735900/337302548-194c98a2-db2b-4f6c-be3b-92c80342436a.jpg?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjIwMjM4MDYsIm5iZiI6MTcyMjAyMzUwNiwicGF0aCI6Ii81NzM1OTAwLzMzNzMwMjU0OC0xOTRjOThhMi1kYjJiLTRmNmMtYmUzYi05MmM4MDM0MjQzNmEuanBnP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDcyNiUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA3MjZUMTk1MTQ2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9ODc5YTY3MmFjODI5ZDY4Mjc1OTIzYjRiMGE4NGFjMGQ1ZDA4YjA5MWUzOGE5MzllN2ZjMDgyODM2YzAzYWY1ZiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.EBZYQHn6ihXRVVXDVQl4PRjmtMnrazlvHxErisVYhGY)
- Download Ample
- Either from a prebuilt release
- or compile yourself from Git repository (see Developing)
- Place it anywhere on your server
- Even on a different server from Ampache, just be mindful that the remote Ampache server will need configuring
- Set up the config file
Edit or add new languages via Inlang Fink
Save as config/ample.json
, must be valid JSON (i.e. no trailing comma on the last item)
Key | Type | Description |
---|---|---|
ampacheURL | Required | Full URL to the Ampache server |
guestUserAPIKey | Optional | Login with this user's API key (use lowest Guest level permissions, this is public) |
loginMessage | Optional | Will be displayed on the login screen |
logo | Optional | Use custom image on the login screen (full URL or relative path to Ample folder) |
Example
{
"ampacheURL": "https://example.com",
"guestUserAPIKey": "123456789",
"loginMessage": "There's no place like 127.0.0.1",
"logo": "./config/logo.svg"
}
- 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 ofdist
Additional console logging can be enabled by setting debugMode true
in src/stores/state.js