lltag_formats(5) [debian man page]

lltag_formats(5)						File Formats Manual						  lltag_formats(5)

NAME

       formats - Internal formats database file for lltag

DESCRIPTION

       The  internal format database is usually stored in /etc/lltag/formats.  The user may override this file by defining a $HOME/.lltag/formats.
       If this file exists, the system-wide one is ignored.

       These files contain entries starting with a line such as:

       [%n - %a - %t]
	      A title between bracket that will be displayed at runtime.

       Then, the following 3 lines must be given to explain how the format is actually used to parse filenames:

       type = basename
	      The type is either basename (to parse the last part of the path to a file) or path (to parse the directory part of  the  path  to  a
	      file).   When actually parsing the path to target files, basename and path parsers will be assembled.  All possible combination will
	      be tried.

       regexp = %L%N%S-%S%A%S-%S%A%L
	      A string composed of any characters, with the following special fields:

	      %L for delimiter (empty by default, multiple spaces if --spaces was given)

	      %S for a space (or multiple spaces if --spaces was given)

	      %N for numbers

	      %A for an alphanumeric string without /

	      %P for any path (alphanumeric string with /)

	      %% for %

       indices = NUMBER,ARTIST,TITLE
	      A list of fields to match (either given by their full name or associated letter) corresponding to each %N or %A field in the  previ-
	      ous  format.   It  may be AUTHOR (or a), ALBUM (A), GENRE (g), NUMBER (n), TITLE (t), DATE (d), COMMENT (c) or IGNORE (i).  See also
	      FORMAT in the manpage of lltag for details about these fields.

SEE ALSO

       lltag(1)

AUTHOR

       Brice Goglin

								   NOVEMBER 2006						  lltag_formats(5)

lltag_config(5) 						File Formats Manual						   lltag_config(5)

NAME

       config - Configuration file for lltag

DESCRIPTION

       The following options may be stored in /etc/lltag/config or the user's $HOME/.lltag/config, or in any file passed with --config.

       Such a configuration file may also be generated with --gencfg.

Obtaining tags
       format = "string"
	      Add  a user-defined format [-R].	Might be used multiple times.  Default is to guess if no user-defined formats and no default field
	      values are given.
       guess = <0/1>
	      Try to guess if user-defined formats do not match [-G].  Default is 0 (disabled) when no user-defined formats and no explicit values
	      are given.
       tag = <TAG=value>
	      Add an explicit tag [--tag].  Might be used multiple times.

Tweaking filename parsing
       no_path = <0/1>
	      Do not use file path when matching filename [-p].  Default is 0 (disabled).
       spaces = <0/1>
	      Allow no or multiple spaces [--spaces].  Default is 0 (disabled).

Cleaning obtained tags
       edit = <0/1>
	      Edit tags immediately [--edit].  Default is 0 (disabled).
       maj = <0/1>
	      Upcase first letters of words in tags [--maj].  Default is 0 (disabled).
       regexp = "s/from/to/"
	      Replace  from  with  to  in all tags.  title,number:s/from/to/ replaces in title and number tags only.  Might be used multiple times
	      [--regexp].  Default is to not apply any regexp.
       sep = "string"
	      Replace |-separated strings with space in tags.  Default is to not replace any separator.

Configuration of tag application
       type = <mp3|ogg|flac|none>
	      Force mp3, ogg of flac instead of by-extension detection [--mp3, --ogg and --flac].  Default is none.
       clear_tags = <0/1>
	      Clear all tags of audio files.  [--clear].  Default is 0 (disabled).
       append_tags = <0/1>
	      Append tags only instead of replacing old ones.  [--append].  Default is 0 (disabled).
       no_tagging = <0/1>
	      Do not actually tag files [--no-tagging].  Default is 0 (disabled).
       preserve_time = <0/1>
	      Preserve file modification time during tagging [--preserve-time].  Default is 0 (disabled).

Renaming
       rename_format = "string"
	      Rename file according to format [--rename].  Default is to not rename.
       rename_min = <0/1>
	      Lowcase tags before renaming [--rename-min].  Default is 0 (disabled).
       rename_regexp = "s/from/to/"
	      Replace from with to in all tags before renaming.  title,number:s/from/to/ replaces in title and number tags only.   Might  be  used
	      multiple times [--rename-regexp].  Default is to not apply any regexp.
       rename_sep = "string"
	      Replace spaces with a string in tags before renaming [--rename-sep].  Default is to not replace any separator.
       rename_slash = "string"
	      Replace slashes with a string in tags before renaming [--rename-slash].  Default is to replace with a dash.
       rename_ext = <0/1>
	      Assume the rename format provides an extension [--rename-ext].  Default is 0 (disabled).

Miscellaneous
       dry_run = <0/1>
	      Do nothing but show what would have been done [--dry-run].  Default is 0 (disabled).
       yes = <0/1>
	      Tag without asking for confirmation when guessing and rename without asking for confirmation [--yes].  Default is 0 (disabled).
       ask = <0/1>
	      Always ask for confirmation before tagging [--ask].  Default is 0 (disabled).
       recursive = <0/1>
	      Recursively traverse all given subdirectories [-R].  Default is 0 (disabled).
       verbose = <integer>
	      Message  verbosity  level [-v and -q].  Default is 0 (only important messages).  Other possible values are 1 (show usage information
	      when a menu is displayed for the first time) and 2 (always show usage information before a menu appears).

CDDB configuration
       cddb_server_name = hostname
	      Change the CDDB server name.  Default is www.freedb.org.
       cddb_server_port = <port>
	      Change the CDDB server port.  Default is 80 (HTTP).

SEE ALSO

       lltag(1)

       The config template file provided within the documentation directory.

AUTHOR

       Brice Goglin

								   NOVEMBER 2006						   lltag_config(5)