OnWorks favicon

btag - Online in the Cloud

Run btag in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command btag that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



btag - A command line based multimedia tagger


btag [options] path1 [path2] [path3] ...


btag is a TagLib-based command line multimedia tag editor that attempts to automate the
process of tagging a lot of files at once. It uses the tags found in the supplied files as
well as interactive user input to determine new values for the tags. It can also
optionally rename files and directories based on those new values.

You can supply paths to files or directories to btag. Directories are recursively
traversed and all files found are tagged. Directories are also handled differently in the
sense that btag will attempt to keep information about the previously tagged files to
provide sane defaults for all other files in the same parent directory. Only files with
file extensions supported by TagLib are considered.


-D/--dry-run Don't do anything, just show what would have been done
(dry run mode)

-d/--dir-rename-format format Use format to rename the directories where the multimedia
files were found

-i/--input-filter filter Use filter as the input filter

-f/--filter filter Use filter as both the input and the output filter

-h/--help Display usage information and exit

-n/--renaming-filter filter Use filter as the renaming filter

-o/--output-filter filter Use filter as the input filter

-r/--file-rename-format format Use format to rename the multimedia files

-t/--title-locale locale Use locale for proper (although lax) locale-specific
title casing


btag supports input and output filters that are applied to the text fields (artist, album
and song title). Those filters can protect against basic mistakes such as duplicate
whitespace. Input filters are used on the tags as they are loaded from the multimedia
files. This filtered information is used to provide suggestions to the user when the
interactive tagger requests information for those text fields. If an output filter is
configured, the user input is then filtered, and if the filtered text does not match the
user input, the user is asked for confirmation.

In most cases, the input filter should match the output filter (which is why the -f option
is handy). You may choose to specify only an input filter, in which case the user input is
not filtered. If you don't specify an input filter, though, the default input filter will
be used.

The currently available filters are:

basic Provides basic filtering by removing duplicate or trailing whitespace, is
the default input filter and the base for all other filters

first_upper The first character in the field is uppercased, while all others are

lower All characters are lowercased

title The first character of each word is uppercased (with exceptions), while all
others are lowercased

upper All characters are uppercased

The title capitalization algorithm will follow locale-specific context-insensitive rules
depending on the value of the -t parameter. Note that strict title capitalization rules
often depend on the context in which the words are used, the precise analysis of which is
much beyond the scope of btag. The currently supported title locale specifications are:

en English (default)

es Spanish


If a format is specified with the -r option, the tagged multimedia files are renamed
accordingly. Likewise, if the -d option is used, the directory in which multimedia files
were tagged is renamed according to the specified format.

The specified format is converted to a file or directory name using the following

%artist Artist name

%album Album name

%year Year of release

%track Track number (only replaced by the -r option)

%title Song title (only replaced by the -r option)

Renaming happens after the tags are written, and it's relative to btag's working

For directory renaming, the last known artist, album and year information is used. Only
directories that contain files that were tagged by btag are renamed.

btag does not prevent you from overwriting existing files using the formats described


Renaming filters are used to ensure that the file and directory names generated using the
renaming formats (if specified) are valid (safe) in the context of the current file
system. The following renaming filters are currently available:

conservative Conservative character replacements are performed, recommended for FAT32
file systems

unix Generates file and directory names that should be valid in an Unix
environment (default)


Using title casing with English rules and sensible renaming formats generating FAT32-safe
file and directory names:

$ btag --file-rename-format '%track. %title' \
--dir-rename-format '%album (%year)' \
--filter title --title-locale en \
--renaming-format conservative /path/to/myalbum

Using an input filter only:

$ btag --input-filter lower /path/to/myalbum

Use btag online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    VBA-M (Archived - Now on Github)
    VBA-M (Archived - Now on Github)
    Project has moved to
    Features:Cheat creationsave statesmulti
    system, supports gba, gbc, gb, sgb,
    Download VBA-M (Archived - Now on Github)
  • 2
    Linux System Optimizer and Monitoring
    Github Repository:
    Audience: End Users/Desktop. User
    interface: Qt. Programming La...
    Download Stacer
  • 3
    Fork of TeamWinRecoveryProject(TWRP)
    with many additional functions, redesign
    and more Features:Supports Treble and
    non-Treble ROMsUp-to-date Oreo kernel,
    Download OrangeFox
  • 4
    itop - ITSM  CMDB OpenSource
    itop - ITSM CMDB OpenSource
    IT Operations Portal: a complete open
    source, ITIL, web based service
    management tool including a fully
    customizable CMDB, a helpdesk system and
    a document man...
    Download itop - ITSM CMDB OpenSource
  • 5
    Clementine is a multi-platform music
    player and library organizer inspired by
    Amarok 1.4. It has a fast and
    easy-to-use interface, and allows you to
    search and ...
    Download Clementine
  • 6
    ATTENTION: Cumulative update 2.4.3 has
    been released!! The update works for any
    previous 2.x.x version. If upgrading
    from version v1.x.x, please download and
    Download XISMuS
  • 7
    Modular headtracking program that
    supports multiple face-trackers, filters
    and game-protocols. Among the trackers
    are the SM FaceAPI, AIC Inertial Head
    Tracker ...
    Download facetracknoir
  • More »

Linux commands