alexdx-ca / ample Goto Github PK

Built with Svelte & wavesurfer.js

• Largely untested with multiple users
• Transcoding is untested as I don't use it
• It is designed to be a front-end companion to an existing Ampache server, not a complete replacement

View demo

• User demo
• Password demodemo

• Smartlist autoplay when nearing end of the queue
• Dark & light mode with adaptive interface colors
• Fade out/in on pause/resume/next/previous
• Media keys support
• Volume normalization (ReplayGain & EBU R128)
• Night/headphone mode to boost quieter parts of songs
• Toggleable notifications for
  • Alternate song versions (radio edit, acoustic, live, demo etc)
  • Missing volume gain tags
  • Missing song rating
  • Missing/untimestamped song lyrics
• Same powerful Advanced Search as Ampache
• Compare an artist's collection with MusicBrainz recordings (if the artist has an MBID associated with it)
• Skip songs below a specified rating when adding to queue
• 'Unrated' dashboard + Multi-rater

Edit or add new languages via Inlang

• Ampache 6+
• A modern web browser (Chrome/Edge 88+, Firefox 78+, Safari 14+)

• Easy mode (recommended)
  • Grab a prebuilt release
  • Copy the hhamp folder into your Ampache server public folder
  • Access by adding /hhamp to your Ampache server address e.g. yourampache.com/hhamp or localhost/ampache/hhamp
• Hard mode
  • Grab a prebuilt release or build yourself from Git repository (see Developing)
  • Put it anywhere you like, but you will have to deal with CORS if it is on a different domain/subdomain from the Ampache server you are connecting to.
• Enter the URL of the Ampache server you wish to connect to on the login screen
  • Alternatively add the URL to hhamp.json to hardcode it (rename hhamp.json.dist & use the full URL with no trailing slash i.e. https://yourampache.com)

• Clone the HHAmp repository and from the hhamp directory cd hhamp
• 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/server.js

A big thank you to Mitch Ray for creating the original version of Ample 2.03! Your hard work and dedication have provided us with a fantastic foundation to build upon. We greatly appreciate your contributions to the open-source community.

Original Ample 2.03 Repository