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

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

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.