summaryrefslogtreecommitdiff
path: root/doc/tips/automatically_adding_metadata.mdwn
blob: e6d02defa7ac94c3e42260e755152194099fee38 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
git-annex's [[metadata]] works best when files have a lot of useful
metadata attached to them.

To make git-annex automatically set the year and month when adding files,
run `git config annex.genmetadata true`.

A git commit hook can be set up to extract lots of metadata from files
like photos, mp3s, etc.

1. Install the `extract` utility, from <http://www.gnu.org/software/libextractor/>  
   `apt-get install extract`
2. Download [[pre-commit-annex]] and install it in your git-annex repository
   as `.git/hooks/pre-commit-annex`.  
   Remember to make the script executable!
3. Run: `git config metadata.extract "artist album title camera_make video_dimensions"`

Now any fields you list in metadata.extract to will be extracted and
stored when files are committed.

To get a list of all possible fields, run: `extract -L | sed 's/ /_/g'`

By default, if a git-annex already has a metadata field for a file,
its value will not be overwritten with metadata taken from files.
To allow overwriting, run: `git config metadata.overwrite true`