z-amp-minimal
v1.0.5
Published
A minimalist theme for Z-Amp that provides a basic audio player
Downloads
31
Readme
z-amp-minimal
A simple but stylish audio player for the web, built with z-amp-core
The Minimal theme includes the following Z-Amp components:
- Audio Player
- Playlist Manager
- Equalizer
- Audio HTML Visualizer
Installation
At present, the Minimal theme is installable as an importable script in your site's markup. In the <head> section of the page, include the following code snippet:
<script type="text/javascript" src="https://unpkg.com/z-amp-minimal/build/z-amp-minimal.bundle.min.js"></script>Quick Start
<script type="text/javascript">
window.onload = () => {
ZAmp.amp()
.then((amp) => {
amp.playlist.clear();
amp.playlist.addTrack({url: "<TRACK URL>", title: "<TRACK TITLE>", artist: "<TRACK ARTIST>"});
});
}
</script>Make sure to replace the variables with your own values. Repeat the addTrack statement for any number of tracks that you wish to add to the playlist.
Features
Auto-compacting design
Minimal will ensure that it takes up the least amount of screen real-estate possible. When it's not being interacted with (doesn't have focus or mouse over), it will reduce its size to include only a play/pause button and the name of the current song (if it's playing).
Hidden controls
When the player is selected it automatically reveals next, previous and play/pause buttons, as well as controls for shuffle and loop.
Playlist
One of the Minimal theme's selectable panels is a playlist that contains all of the player's current tracks. Select one to change the track or scroll through the list to find the track you're looking for. The current track is marked with a timer and a small visual EQ.
Equalizer
The second of the Minimal theme's selectable panels allows you to choose from three different presets of a seven-band EQ: Bass, Rock or Club. Manually adjusting one of the frequencies automatically selects Custom mode.
Further Support
For more information about what you can do with Z-Amp, check out the website for further documentation.