2 # Ian Beckwith <ianb@erislabs.net>
5 use lib '/home/ianb/projects/id3fs/id3fs/lib'; # FIXME: remove
7 use Getopt::Long qw(Configure);
11 $me=($0=~/(?:.*\/)?(.*)/)[0];
17 my @extensions=qw(mp3); # ogg flac); # FIXME
19 Configure(qw(bundling no_ignore_case));
20 my $optret=GetOptions(
21 "verbose|v" => \$verbose,
22 "quiet|q" => sub { $verbose=0; },
24 "dir|d=s" => \$basedir,
25 "database|f=s" => \$dbpath,
26 "extensions|e=s" => sub { @extensions=split(/\s+|\s*,\s*/, $_[1]); },
29 usage() if(!@ARGV || !$optret || $help);
31 if(@ARGV > 1 && !defined($basedir))
33 die("$me: --basedir must be specified if multiple paths are supplied\n");
36 my $db=ID3FS::DB->new($me, $dbpath, $basedir, $ARGV[0]);
37 $db->last_update(time());
41 File::Find::find( {wanted => \&wanted, follow => 1, no_chdir => 1}, $path);
47 if(/.*\.(.*)/) { $ext=lc($1); }
50 print("$_\n") if $verbose;
52 elsif(-f && scalar(grep({ $ext eq lc($_);} @extensions)))
61 die("Usage: $me [-vqh] [-d basedir] [-f dbpath] [-e mp3,ogg,flac] [--] DIR...\n".
62 " -v|--verbose\t\t\tVerbose\n".
63 " -q|--quiet\t\t\tQuiet (default)\n".
64 " -d|--dir=PATH\t\t\tBase directory of source files (default: ARGV[0])\n".
65 " -f|--database=FILE\t\tPath to database file (default: basedir/.id3fs)\n".
66 " -e|--extensions=EXT1,EXT2\tFile extensions to index (default: mp3, ogg, flac)\n".
67 " -h|--help\t\t\tThis help\n".
68 " --\t\t\t\tEnd of options\n");
75 id3fs-index - Add files to id3fs index
79 B<id3fs-index> [B<-vqh>] S<[B<-d >I<basedir>]> S<[B<-f >I<dbpath>]> S<[B<-e >I<mp3,ogg,flac>]> [B<-->] [I<DIR>...]
83 Extracts id3 tags from mp3 files (and comment tags from ogg and flac
84 files) and adds them to a sqlite database, ready for mounting
93 Enable verbose operation.
97 Quiet (no output). This is the default.
99 =item S<B<-d >I<PATH>> | S<B<--dir=>I<PATH>>
101 Specify base directory of source files. All files will be indexed
102 relative to this point.
104 If not specified, defaults to the first non-option argument on the
105 command line. Note that to avoid ambiguities, if more than one
106 directory is specified on the command line, the base directory must
107 be specified explicitly.
109 All files indexed must be under the base directory.
111 =item S<B<-f >I<FILE>> | S<B<--database=>I<FILE>>
113 Database file to use. If not specified, defaults to
114 a hidden file called B<".id3fs"> under the base directory.
116 =item S<B<-e >I<EXT1,EXT2>> | S<B<--extensions=>I<EXT1,EXT2>>
118 File extensions to consider when indexing.
119 Defaults to B<.mp3>, B<.ogg> and B<.flac>.
123 Show a short help message.
133 Index all files in the current directory:
137 Index current directory, printing each subdirectory as it recurses
142 Just index some sub-directories:
144 id3fs-index -d . dir1 dir2
146 Store the database in a custom location:
148 id3fs-index -f ~/.id3fs/index.sqlite .
150 Only index .mp3 and .flac files:
152 id3fs-index -e mp3,flac .
156 Please report any found to ianb@erislabs.net
164 Ian Beckwith <ianb@erislabs.net>
168 The latest version can be found at:
170 B<http://erislabs.net/ianb/projects/id3fs/>
174 Copyright 2010 Ian Beckwith <ianb@erislabs.net>
176 This program is free software: you can redistribute it and/or modify
177 it under the terms of the GNU General Public License as published by
178 the Free Software Foundation; either version 3 of the License, or
179 (at your option) any later version.
181 This program is distributed in the hope that it will be useful,
182 but WITHOUT ANY WARRANTY; without even the implied warranty of
183 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
184 GNU General Public License for more details.
186 You should have received a copy of the GNU General Public License
187 along with this program. If not, see <http://www.gnu.org/licenses/>.