UPDATE-MUSIC-SYMLINKS(User Contributed Perl DocumentatUPDATE-MUSIC-SYMLINKS(1)NAMEupdate-music-symlinks - maintain a directory of symlinks to music
SYNOPSISupdate-music-symlinks [-v] [-q] [-h]
DESCRIPTIONupdate-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 ALSOmp3-archive-tools(1), mp3lint(1)AUTHOR
Ian Beckwith <ianb@nessie.mcc.ac.uk>
AVAILABILITYupdate-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)
