mirrors/git-annex
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions

The pre-commit-annex hook script that automatically extracts metadata has been updated to also use exiftool. Thanks, Klaus Ethgen.

Browse source
This commit is contained in:
Joey Hess 2016-02-28 11:10:55 -04:00
parent b946ca44c3
commit 764e57f1f1
Failed to extract signature
4 changed files with 129 additions and 50 deletions
Download patch file Download diff file Expand all files Collapse all files

45
doc/tips/automatically_adding_metadata.mdwn
View file

@ -2,23 +2,48 @@ 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`.
run: `git config annex.genmetadata true`
## git commit hook
A git commit hook can be set up to extract lots of metadata from files
like photos, mp3s, etc.
like photos, mp3s, etc. Whenever annexed files are committed, their
metadata will be extracted and stored.
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"`
Download [[pre-commit-annex]] and install it in your git-annex repository
as `.git/hooks/pre-commit-annex`
Remember to make the script executable! `chmod +x .git/hooks/pre-commit-annex`
Now any fields you list in metadata.extract to will be extracted and
stored when files are committed.
### using extract
The git commit hook can use extract to get metadata.
Install it from <http://www.gnu.org/software/libextractor/>
`apt-get install extract`
Configure which metadata fields to ask extract for: `git config metadata.extract "artist album title camera_make video_dimensions"`
To get a list of all possible fields, run: `extract -L | sed 's/ /_/g'`
### using exiftool
The git commit hook can also use exiftool to get metadata.
Install it from <http://owl.phy.queensu.ca/~phil/exiftool/>
`apt-get install libimage-exiftool-perl`
Configure which metadata fields to ask exiftool for: `git config metadata.exiftool "Model ImageSize FocusRange GPSAltitude GPSCoordinates"`
To get a list of all possible fields, run: `exiftool -list`
### using both extract and exiftool
If you want some metadata that extract knows about, and other metadata
that exiftool knows about, just install them both, and set both
`metadata.extract` and `metadata.exiftool`.
### overwriting existing metadata
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`