git-annex-metadata

git-annex-metadata(1)        General Commands Manual       git-annex-metadata(1)



NAME
       git-annex-metadata - sets or gets metadata of a file

SYNOPSIS
       git annex metadata [path ...]

DESCRIPTION
       The content of an annexed file can have any number of metadata fields
       attached to it to describe it. Each metadata field can in turn have any
       number of values.

       This command can be used to set metadata, or show the currently set
       metadata.

       When run without any -s or -t parameters, displays the current metadata.

OPTIONS
       -g field / --get field

              Get the value(s) of a single field.

              The values will be output one per line, with no other output, so
              this is suitable for use in a script.

       -s field=value / --set field=value
              Set a field's value, removing any old values.

       -s field+=value / --set field+=value
              Add an additional value, preserving any old values.

       -s field?=value / --set field?=value
              Set a value, but only if the field does not already have a value
              set.

       -s field-=value / --set field-=value
              Remove a value from a field, leaving any other values that the
              field has set.

       -r field / --remove field
              Remove all current values of the field.

       -t tag / --tag tag
              Set a tag. Note that a tag is just a value of the "tag" field.

       -u tag / --unset tag
              Unset a tag.

       --force
              By default, git annex metadata refuses to recursively set metadata
              throughout the files in a directory. This option enables such
              recursive setting.

       file matching options
              The git-annex-matching-options(1) can be used to specify files to
              act on.

       --json Enable JSON output. This is intended to be parsed by programs that
              use git-annex. Each line of output is a JSON object.

       --all  Specify instead of a file to get/set metadata on all known keys.

       --unused
              Specify instead of a file to get/set metadata on files found by
              last run of git-annex unused.

       --key=keyname
              Specify instead of a file to get/set metadata of the specified
              key.

EXAMPLES
       To set some tags on a file and also its author:

        git annex metadata annexscreencast.ogv -t video -t screencast -s
       author+=Alice

SEE ALSO
       git-annex(1)

       git-annex-view(1)

AUTHOR
       Joey Hess <id@joeyh.name>

                                                           git-annex-metadata(1)