SimPlEd - Simple Playlist Editor

What is it?

SimPlEdi is a webbased playlist (m3u) editor for mp3 files which are used in popular music players like Winamp or XMMS. The filelocations are stored relative to the playlist location which makes it possible to use the generated lists on changing environments as mounted network drives or CDROMs.


Installation

Make sure you have the MP3::Info perl module installed. If not do so:

# perl -MCPAN -e shell
cpan> install MP3::Info
Copy all files to a directory below your webserver root. Make sure your server executes CGIs from this directory.

Attention: This program is not intended to run on a public accessable webserver! It is not secure! You have been warned.


Configuration

Edit the config.pl file. All paths have to be given without trailing slashes. Specify where your mp3 collection is in $REALDIR. $WEBDIR is the path to your mp3s when accessed via http, $RELDIR is the relative path from the location of your playlists which is stored in $SAVEDIR. Note: The webserver have to be allowed to write in $SAVEDIR

SimPlEdi can edit ID3 tags of MP3 files. If you wish it can rename the filename, too. Set $RENAMEONTAG to 1 if you want that for default else set it to 0. You can define how a file should be named by set up the string in $MP3SYNTAX with the following placeholders:

%aArtist or Bandname
%tSongtitle
%dAlbum
%cFilecomment
%yReleaseyear
%nTrack number
%gGenre

You may change the colorscheme by altering the style.css stylesheet.


Using it

Loading and creation of Playlists

When there is no playlist loaded your'e prompted to open or create one. Either select one from the drop down list and press open or enter a name into the textfield and press save.

Browsing files

In left frame you can browse your mp3 collection. Selecting a folder ( folder ) name traverses into that folder. Selecting up.. will return to the parent directory.

To add a file to the current playlist click on add. Note: This button is only available when a playlist is loaded

On MP3 files you get some infos on the files icon: When you move your pointer over the icon you'll see length and bitrate of the song in a tooltip. The background color of the icon tells you something about the quality:

Bitrates lower than 96 kbps
Bitrates between 96 and 128 kbps
Bitrates above 128 kbps

Editing ID3 tags

This is only supported on MP3 files (I don't have .ogg files yet but adding support for ogg-tags should be easy if wished). To edit an MP3 tag click on the icon MP3.
Enter the desired informations and press save to save them. If you check the rename file box the file will renamed based on the infos you entered. You can cancel the edition by pressing back
Note: Only version 1 tags are supported!

Playing single files

Simply click on a filename to listen to that file.

Searching files

You can search for files matching given keywords by entering the keywords in the search field and hitting Search. All given words have to be found in the filename to be displayed. The search is caseinsensitive and you can search for word parts.

Example: A search for 'give lov' would return "Give me some loving" but not "Love me tender".

By clicking on the 'Search Results' title in the right frame you can return to the browsing mode after a search.

Working with Playlists

When a playlist is loaded it's content is diplayed in the right frame. You can move a file in the list by pressing the up and down buttons or remove a file from list by pressing the remove button beside the filename.

Press sort list to order your list by alphabet or press shuffle list to randomize it.

To rename a list simply enter a new name in the textbox at the top of the right frame and press save. To load the whole playlist to your audionplayer click on the play button. The close button will close the current playlist and delete will delete it.


Feedback

Yes please! Send Ideas, Bugreports and Patches to a.gohr@web.de


Copyleft

SimPlEdi - A webbased playlist editor
Copyright © 2002 Andreas Gohr <a.gohr@web.de>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA