Lizzy v1.1.1

Table of contents

1. Features
2. License
3. Download
4. Documentation
5. Getting started
6. Details
7. Build
8. Playlist information
9. Other solutions
10. Third-party libraries

Features

• Wide and extensible playlist support (see the detailed list of currently supported playlist formats)
• Automatic detection of the type of input playlist
• Information on playlist format support by some media players (input and output)
• Physical access to the individual contents of a playlist is not required (performed on demand)
• Information on playlist items (media contents): MIME type, length, duration, width/height
• Powerful yet simple generic playlist representation
• Direct handling of a given specific playlist type (eg. ASX, WPL) is possible
• Playlist normalization (empty items removal, simplification, reduction)

License

Download

Documentation

• The detailed list of currently supported playlist formats is presented here
• The Lizzy library Java reference documentation (javadoc)
• The project version history is here
• Some DTDs and XML Schemas that you may find useful
• The licences (and binaries) of the third-party libraries used at run-time

Getting started

• User: open a command prompt (Windows) or a shell terminal (Unix-like). Change the directory to the Lizzy binary distribution root.
  The usage of the Lizzy tools can be obtained through the following commands:
  • "Transcode" (Windows) or "sh Transcode.sh" (Unix). This tool converts an input playlist to a (possibly new) format. A copy of the last recent usage is located here.
    Example: "Transcode -o new-playlist.xspf old-playlist.m3u".
  • "AddToPlaylist" (Windows) or "sh AddToPlaylist.sh" (Unix). This tool adds URLs, files and/or directories to a (possibly new) single playlist. A copy of the last recent usage is located here.
    Example: "AddToPlaylist -o new-playlist.asx music-directory this-file.mp3 anotherfile.wav".
  CAUTION: in order to use FFMPEG as content metadata provider, you have to put the needed dynamic libraries in the "lib" folder:
  • On a Windows platform, they are "avcodec-51.dll", "avformat-51.dll" and "avutil-49.dll" (you can find them here);
  • On a Linux platform, they are "libavcodec.so", "libavformat.so" and "libavutil.so".
• Developer: a sample introducing the main API methods is described here.
  For a more complete usage, the best is to to refer to the source code of the Transcode or AddToPlaylist class, i.e. the command-line tools.

Details

• Java 2 SE (including the Service Provider Interface, JAXB, JavaSound and ImageIO facilities)
• Castor, a Java ↔ XML binding framework
• Apache Ant
• Xdoclet 2
• XML, RSS, Atom
• FFMPEG

1. Through JAXB: see the RMP format.
2. By using directly any available XML parser: see the KPL format.
3. Through the Castor framework: see all other XML-based formats.

Build

1. The Sun Java SE Development Kit (JDK) 6: http://java.sun.com/javase/downloads.
   Install the JDK for example in directory 'C:\Program Files\Java\jdk1.6.0_xx' (on Windows) or '/usr/java/jdk1.6.0_xx' (on *nix), where 'xx' must be replaced by the appropriate update number (21 in my case).
   Set the following system environment variables:
   on Windows,
   JAVA_HOME=C:\Program Files\Java\jdk1.6.0_xx
   PATH=%PATH%;%JAVA_HOME%\bin
   on *nix,
   export JAVA_HOME='/usr/java/jdk1.6.0_xx'
   export PATH=$PATH:$JAVA_HOME/bin
2. Apache Ant 1.8.1: http://ant.apache.org/bindownload.cgi
   Install Ant for example in directory 'C:\apache-ant-1.8.1' (on Windows) or '/usr/java/apache-ant-1.8.1' (on *nix).
   Set the following system environment variables:
   on Windows,
   ANT_HOME=C:\apache-ant-1.8.1
   PATH=%PATH%;%ANT_HOME%\bin
   on *nix,
   export ANT_HOME='/usr/java/apache-ant-1.8.1'
   export PATH=$PATH:$ANT_HOME/bin

        ant
        

Playlist information

• General information:
• A survey of playlist formats
• Playlist on Wikipedia
• Playlist on VideoLAN Wiki
• Streamalot Playlists
• Schworak: Music And Sound
• Wasabi Developer Manual: Winamp And Wasabi: Playlists and the Playlist Directory Service
• ASX:
• Windows Media Metafile Elements Reference
• ASX Elements Reference
• Atom:
• The Atom Syndication Format
• Hypetape:
• Hypetape's playlist format
• M3U:
• WINAMP.COM M3U and PLS Specification
• The M3U (.m3u) Playlist File Format
• PLA:
• Playlist format specification for iriver T50
• PLIST:
• XML.com: Hacking iTunes
• Introduction to Property List Programming Topics for Core Foundation
• RSS / Media RSS:
• RSS 2.0 at Harvard Law
• RSS 2.0 Specification (RSS Advisory Board)
• Media RSS Module - RSS 2.0 Module (Yahoo!)
• Media RSS Namespace Extension
• SMIL:
• W3C Synchronized Multimedia
• WPL:
• Windows Media Playlist Elements Reference
• XSPF:
• XSPF: XML Shareable Playlist Format

Other solutions

Third-party libraries

The next table describes all 3d-party libraries necessary to use the Lizzy library. All the associated license files may be found in the directory docs/licenses of the binary project distribution.

The table below describes the additional 3d-party tools and libraries used during the development process (in particular to build the distribution). In each mentioned directory, you will find the associated license.