DragonFly On-Line Manual Pages

Search: Section:  

UPDATE-MUSIC-SYMLINKS(1)                   User Contributed Perl Documentation


NAME

       update-music-symlinks - maintain a directory of symlinks to music


SYNOPSIS

       update-music-symlinks [-v] [-q] [-h]


DESCRIPTION

       update-music-symlinks creates and maintains a link farm pointing to all
       your music in various places. If you have music spread over multiple
       disks/partitions, or distributed over various directories, this enables
       you to browse it all in a single tree.

       A config file .music-symlinks is used to specify where to find music
       and where to link it. See below for the file format.

       WARNING: Directories that the link farm is created in are deleted
       first. Just in case, the directories are scanned and the program is
       aborted if anything is found in there other than files and symlinks.


OPTIONS

       -v  Verbose

       -q  Quiet (no output). This is the default

       -h  Show a brief usage message


CONFIGURATION

       The configuration for update-music-symlinks is stored in
       $HOME/.music-symlinks.

       The format is simple. Lines starting with # are comments. Blank lines
       are ignored.

       To specify a directory to create links in, start a line with "Dir: "
       (the space is important) then the name, eg:

        Dir: /home/ianb/music/albums

       All non-comment lines up to the following "Dir: " line are treated as
       directories to create links to within that directory.


EXAMPLE

       A complete example .music-symlinks follows:

        # beware, /home/ianb/music/albums will be deleted!
        Dir: /home/ianb/music/albums
        /home/ianb/music/essential
        /home/ianb/music/cache
        /home/ianb/music/cut/albums
        /mnt/bigdisk/music/albums

        # beware, /home/ianb/music/tracks will also be deleted.
        Dir: /home/ianb/music/tracks
        /mnt/bigdisk/tracks
        /home/ianb/music/cut/tracks


ENVIRONMENT

       $HOME
           Used to find .music-symlinks


BUGS

       None known. Please report any found to ianb@nessie.mcc.ac.uk


SEE ALSO

       mp3-archive-tools(1), mp3lint(1)


AUTHOR

       Ian Beckwith <ianb@nessie.mcc.ac.uk>


AVAILABILITY

       update-music-symlinks is part of the mp3-archive-tools package.

       The latest version can be found at:

       http://nessie.mcc.ac.uk/~ianb/projects/mp3-archive-tools/


COPYRIGHT

       Copyright 2003 Ian Beckwith <ianb@nessie.mcc.ac.uk>

       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.,
       675 Mass Ave, Cambridge, MA 02139, USA.

perl v5.20.2                      2003-12-12          UPDATE-MUSIC-SYMLINKS(1)

Search: Section: