id3fs-index - Add files to id3fs index


id3fs-index [-lvh] [-d basedir] [-f dbpath] [-e mp3,ogg,flac] [--] [DIR...]


Extracts id3 tags from mp3 files (and comment tags from ogg and flac files) and adds them to a sqlite database, ready for mounting with id3fsd(8).


-l | --list

List tags in use in specified database.

-d PATH | --dir=PATH

Specify base directory of source files. All files will be indexed relative to this point.

If not specified, defaults to the first non-option argument on the command line. Note that to avoid ambiguities, if more than one directory is specified on the command line, the base directory must be specified explicitly.

All files indexed must be under the base directory.

-f FILE | --database=FILE

Database file to use. If not specified, defaults to a hidden file called ".id3fs" under the base directory.

-e EXT1,EXT2 | --extensions=EXT1,EXT2

File extensions to consider when indexing. Defaults to .mp3, .ogg and .flac.


Enable verbose operation.


Show a short help message.


End of options.


Index all files in the current directory:

    id3fs-index .

Index current directory, printing each subdirectory as it recurses into it:

    id3fs-index -v .

Just index some sub-directories:

    id3fs-index -d . dir1 dir2

Store the database in a custom location:

    id3fs-index -f ~/.id3fs/index.sqlite .

Only index .mp3 and .flac files:

    id3fs-index -e mp3,flac .


Please report any found to


id3fsd(8), the MP3::Tag manpage, the Audio::Flac::Header manpage, the Ogg::Vorbis::Header manpage


Ian Beckwith <>

Many thanks to Aubrey Stark-Toller for help wrangling SQL.


The latest version can be found at:


Copyright (C) 2010 Ian Beckwith <>

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 3 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, see <>.