foam is a web player frontend for Ampache using the Fomantic UI CSS framework. It is mostly PHP, JS, CSS and HTML and designed to be simple and portable.
The micro player is js and uses the howler audio library. The Ampache json API calls are made via PHP.
- Browse by recently played, newest added, most frequent, favourited and random album views.
- Browse by artists, albums or tracks with filters.
- Browse, create and add to playlists.
- Play or shuffle albums.
- Add individual songs or albums to current play queue.
- View current queue via pulldown list. Jump ahead or back in queue via clickable list.
- Drag and drop reorder of play queue. Save play queue to permanent playlist.
- Top of screen micro player with transport controls, mini art thumbnail and volume, mute controls.
- Favourite or unfavourite individual tracks or albums.
- Download links for individual tracks.
- Smart search bar for album, artist and song search.
- Advanced dual pipeline player with mixing capabilities.
- Mix crates, advanced tagging and filters.
- Waveform and bpm analysis.
- Volume normalisation.
- Auto mixing/crossfading.
- Streaming and radio.
Simply drop everything into your public html directory of your PHP enabled web server and away you go. No building should be necessary as it is designed to be self contained.
You need an Ampache server somewhere.
Some options (mainly theming) can be found in config/foam.conf.php which sets a few php variables.
Ampache authentication is stored in browser cookies. If "Remember me" is NOT selected cookies will expire after the current browser session. This is advisable on a public or borrowed computer - always close your browser when finished to destroy all session cookies.
If "Remember me" is selected cookies will live for 1 year. Use the logout option in settings to remove cookies and force login.
Note: If you change Ampache credentials so your current cookies no longer validate you will be asked to re-login. Note: You should NOT consider foam as highly secure. It is still in development.
Status: 100% operational on desktop. Formatting improvements and bug fixing now underway in Phase 2.
Finally! The last (and hardest to code) features are working. Seek by using the track slider and reorder the queue by drag and drop.
You can see a video of many working features here: https://www.youtube.com/watch?v=VK_6-VN4e8o
Finished the core functionality including all major features for first stable release.
Adjust styling to polish fonts, palette, element position, theme options and bug fixing.
Code optimisation, clean up, minimisation, speed, etc.
- Recent, newest, frequent, favourites and random albums views.
- Single album view with track listing after clicking on an album
- All albums view with pagination navigation
- Play track in album view by clicking track title or track number
- DL link in track listing
- pause/play toggle, Previous/Next skip buttons in microplayer
- mute/unmute volume button in microplayer
- volume slider
- links to artist from track listing (or anywhere artist name appears)
- Artist all tracks view
- Artists all albums view
- Playback timer and slider position update during playback.
- Album play and shuffle buttons and functions
- Album view and artist track views now create a queue when played.
- iFrame to separate micro player from content browsing
- Queue pulldown from micro player with clickable tracks
- Add a track to queue from hidden vertical ellipsis menu per song
- Add track to next queue position as Play Next option from menu
- Playlists view and playlist tracks view when you click a playlist
- Playlists can be played, shuffled or tracks added to the queue like albums
- Pagination on recent, frequent and newest album views for next/prev navigation
- All artists view and all tracks view
- Popup song menus for Play next, Add to queue, go to album, go to artist
- Album and Playlist menu to add all songs to end of queue
- Filters now work on albums view, artists view and tracks view
- Series match to find other albums in multi disc or multi volume sets
- Smart search from top bar with results page
- Adding or removing favourites (coloured star) from tracks and albums
- Playlist create, add & remove tracks from new or existing playlists
- Rename and delete playlists from playlist tracks view
- Clear queue
- Browser authentication for Ampache with cookies
- Save current queue to a playlist
- Genre information in artists view
- Better logic for first/last page and pagination controls
- Play next for whole album
- Customisable themes in foam.conf.php
- Queue manipulation (remove track)
- Track seeking via slider
- Queue manipulation (re-order)
- Mobile device friendly view
- Page sometimes locks stopping playback until refreshed - http sockets issue
- Settings menu items get css style overridden
- Need a timeout if ampache host unreachable in order to sign in again
- Long album/playlists get tracks truncated
- Sometimes the track timer glitches after seeking with the slider
Once I have a working release then contributions and suggestions always welcome.
Testing on Chrome (Windows and Linux) during initial development.
- Ampache: dev (testing 5.0)
- Apache: 2.4.41
- PHP: 7.4.3
- Inspired by the subsonic player subplayer - a really nice looking web player for subsonic.
- Using Fomantic UI components (v2.8.7 included).
- Using howler.js audio library for media playback (In HTML mode for better FLAC playback).
- Fomantic (Semantic) UI is still dependent on jquery (pulled from CDN - no need to include it).
- Of course you need a backend Ampache server.
- And a PHP enabled webserver (PHP version 7.4+ recommended).
Licensed under the GNU General Public License v3.0.