jPlaylister v0.70 | Release Date: 2014.11.23
A jPlayer Audio/Video Playlist Generator
NEW
See the Mobile/Full-Screen Mode
Updated based on jPlayer 2.8.2 -- very important update as 2.6 stopped working on many mobile browsers. You can use the official source to update your existing code, but alum art will be stretched to fit poster size. There may be other cosmetic changes/fixes with my code you'll miss.
What it does
The JPlayer Playlister is kind of like a front-end for JPlayer; the intention is to allows you to create a JPlayer Playlist more easily. By simply extracting the source to your web-server and copying your files into the 'media' folder from the source code, the songs should be made available on the demo page's JPlayer implementation.
The original project has been overhauled a few times to add more features. Most notable among them are: playlist sorting options, folder/filetype filtering options, album art display as poster image (for a/v or media playlists), playlist cacheing (for large playlists), and server-side configurable with URL argument overrides for many customization options.
The newest addition is the full-screen/mobile mode which aims to make jPlaylister easier to implement, is ready for mobile, and features subdued controls via a modal window out of the box.
Source / Download
Change Log
v0.70
- continued work on fs/m (full-screen/mobile) mode for mobile ready, full-screen (full-window), implementation.
- revised code based on JPlayer v2.8.2. This update was necessary as many mobile implementations stopped working completely.
- fs/mobile mode | utilized a mobile friendly skin by nightwolf based on blue monday for larger buttons and less options.
v0.68
- added fs/m (full-screen/mobile) mode for mobile ready, full-screen (full-window), implementation.
- revised code based on JPlayer v2.6 and getID3 1.9.6.
- added auto-scrolling code to playlist (when $plheight set or using fs/m mode)
- added sort options (see jPlaylister_info.txt).
- added 'maxtracks' argument which allows limiting of a playlist size -- pagination may come in the future.
- added configurable js warning for android browser visitors (Chrome works, but not stock android browser).
v0.67
- added basic time-based caching for playlists. this drastically reduces load times for large playlists when used properly. see changelog (index.php when downloaded) for details.
- revised code based on JPlayer v2.2.
- added id3 sort by 'track' method and abilty to force two digit track numbers and revised much of existing sorting logic. added a few configurable options.
- added logic to collapse multiple files with the same name (except extension) to one Playlist entry, allowing JPlayer to pick the best file for the current browser.
- added code to display the number of files in a (sub)folder for the filter list.
- tons of fixes...
v0.65
- added ability to display album art (embedded or specified) as poster image in non-audio modes
v0.6
- revised playlister based on JPlayer v2.1
- added video and av playlist support
- updated GETID3 class to v1.9.3
- fixed bugs and refined code
v0.5
- updated to accomodate JPlayer v2.1 as a drop-in solution
- added config variable and URL argument for autoplay
- refined sorting options
- fixed bugs and refined code
v0.4
- added advanced filtering capability
- rewrote to make use of JPlayer 2.0
- fixed bugs and refined code
v0.3
- added recursion play music from infinite(?) subfolders
- added basic sorting options: mtime(file modified time), file name, or random
v0.2
- revised code to look at target folder and one level of subfolders
Implementations
Showcase
Bio
This page demonstrates the JPlayer Playlister, by
Chapman IT.
The original, far more elementary, use of this code can be seen
here. Backstory can be found there, as well. Since then, many features have been added, as detailed in the revision history above. Also, many others have extended the functionality of the code to perform useful tasks such as accept user submissions.
_Props_
I implemented this player, and coded the Playlister (Playlist Generator)...but couldn't have done it without lots of help:
JPlayer » Awesome HTML5 (flash fallback) Audio/Video player with playlist capability which is the foundation upon which this project was built; and the bricks comprising the walls, for that matter.
getID3 » PHP Class allowing the easy access to ID3 information for various audio files.
_Using the Code_
A basic grasp of PHP will help, and perhaps be necessary, to use this code. You may be able to scrape by if you don't know Javascript (like me).
Basically, though, assuming you are running a web server with PHP installed and configured, you will need to
extract the contents of the JPlayer Playlister (download from links above)
and drop some audio and/or video video files or folders into the
'media' folder. After that, load up the page and you should be all set.
The Playlister uses JPlayer to play songs/videos in target directory
and all subfolders, offering some filtering options to play songs from specific subfolders and sorting options to determine the order.
There are some configuration options at the top of 'index.php' which you can change to your liking. Let me know if you have any trouble. Email me(thenickchapmanATgmail.com) or post a comment at
my blogspot featurette:
JPlayer Playlister.
-
Nick C