* 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 Library 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.
*/
mp3_playlist - Overview
-----------------------
I developed this small program because I started to learn C just a few weeks ago. Additionally I had the idea to have a better overview of my mp3 files and to build playlists for the main purposes automatically. For sure this C code is still not perfect, but I had already some fun developing this. If you think this progam is useless, no problem, I like it.
This program produces mp3 playlists from all mp3's found in a given directory. It creates m3u files which can be loaded with winamp, xmms and the dbox audioplayer. It's looking for ID3 Tag Version 1 and Version 2, if Version 2 is available it is use for the playlists.
--------------------------------------------------------------
ATTENTION: When running this program it will delete all *.m3u files in the following directories:
- main output directory (m3u directory)
- subdirectories title/ artist/ and album/
--------------------------------------------------------------
The following playlists can be generated:
- Yearly playlists
These playlists are stord in the main output directory
- Title playlists
are produces aphabetical and are stored as A.m3u .... in the title subdirectory
- Artist playlists
are produces aphabetical and are stored as A.m3u .... in the title subdirectory
- Album playlists
are produced for each mp3 album found in your mp3 directory
Installation
------------
To install this software you need to have the libid3tag install on your system. If you are installing the libid3tag from the source tarball you have to create a id3tag.pc in your /usr/lib/pkgconfig (or /usr/local/lib/pkgconfig). Here a small sample file:
/usr/lib/pkgconfig/id3tag.pc
prefix=/usr
exec_prefix=/usr
libdir=/usr/lib
includedir=/usr/include
Name: id3tag
Description: ID3 tag libraryRequires:
Version: 0.15.1b
Libs: -L/usr/lib -lid3tag -lz
Cflags: -I/usr/include
The rest of the installation works as always..
./configure
make
make install
Deinstallation
--------------
make uninstall
Additional Information
----------------------
Please see the mp3_sample_config file in the doc subdirectory. I have added some comments to show the use of the config file.
Commandline parameter are shown when using mp3_config -h
More information about details during the execution of the program can be found in the mp3_playlist.log file which is located in the main playlist directory after execution.
The filenames in the playlists are produced with relative pathnames. This is to ensure that the mp3 files can be located on a server and can be used with different clients which are conncted with samba or nfs. You have to mount the directory before it is spitted between mp3 source files and m3u playlists.
Example
mp3 files: /export/hda1/mp3/musicfiles
playlist: /export/hda1/playlists
You have to mount: /export/hda1
This program has been developed on a linux system and I don't have an idea if it is running on other platforms on an emulator????
Please report problems by email to software@panczyk.org
Have fun
Matthias
|
