Skip to content
This repository was archived by the owner on Aug 6, 2024. It is now read-only.

lacymorrow/xspf-playlister-php

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Warning

This project is unmaintained.

XSPF Playlister

Media files -> .xspf playlists

Generate an XSPF playlist file for audio and video files using PHP. Use it on the command line once or as a dead-simple way to keep a playlist on the internet up to date.

A Python implementation of the XSPF Playlister Generator ported here: https://github.com/lacymorrow/xspf-playlister-py

Created for: lacymorrow/xspf-jukebox.

Usage

Place all of your media files into a folder called media. Copy playlister.php and the getid3 directory to the same location as the media directory. Run playlister.php or open it in your browser to generate and print your XSPF file. That's it!

  • root
    • playlister.php
    • getid3
      • ...

File Types

Supports mp3, wav, and ogg audio and mp4, webm, and ogv video formats.

If two video files of different types share a filename, they will be interpreted as two sources for the same track.

Tracks will be titled by their filename sans extension. Additional creator and album information can be provided by organizing your files into a media/creator/album/file hierarchy.

An image may be associated with a track by giving it the same filename. To associate one image with an entire folder of tracks, give it the filename artwork. artwork images associate themselves to every sibling and child directory and may be placed anywhere in your media directory hierarchy, so an artwork.jpg in the media directory will act as a global image, filling in for every track that did not already have one provided.

By default, the getid3 library is used to scan mp3 files and will automatically use the meta information associated with a track, rather than the menu directory hierarchy. In order to alleviate server load, a small caching mechanism is in place.

By default the playlist is cached every hour. Open playlister.php and edit the settings between lines 20-40 to change the functionality or provide a different media directory.

Command Line:

php playlister.php path/to/media > playlist.xspf

License

MIT © Lacy Morrow

About

⚙️ Generate an XSPF playlist file for audio and video files using PHP. Used by XSPF-Jukebox.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages