forked from bennoleslie/pexif
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request bennoleslie#11 from DenisCarriere/patch-1
Update README format to Markdown
- Loading branch information
Showing
2 changed files
with
63 additions
and
56 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,63 @@ | ||
# Python EXIF parsing | ||
|
||
**pexif** is a Python library for parsing and more importantly | ||
editing EXIF data in JPEG files. | ||
|
||
This grew out of a need to add GPS tagged data to my images, | ||
Unfortunately the other libraries out there couldn't do updates and | ||
didn't seem easily architectured to be able to add such a thing. Ain't | ||
reusable software grand! | ||
|
||
## Apps | ||
|
||
- **dump_exif.py**: Output the EXIF file from a given file. | ||
- **setgps.py**: Set the GPS metadata on a file. | ||
- **getgps.py**: Get the GPS metadata from a file. | ||
- **noop.py**: This is a no-op on a jpeg file. Useful for testing images are preserved across | ||
operations using pexif. Note that the binary data will not be exact as pexif will compress | ||
unused space in the file, however running it on a file twice should end up with the same data. | ||
|
||
## Examples | ||
|
||
- **hello.py**: Add a simple description to a photo. | ||
|
||
## Status: | ||
|
||
**WARNING**: This could destroy your images!! Backup your images before using. | ||
|
||
Currently it parses files from my Canon without a problem, and is able to | ||
add a GPS tag without corrupting the rest of the image. | ||
|
||
## References | ||
|
||
This work couldn't be done with the reference for the spec. In particular I worked to: | ||
|
||
- http://www.exiv2.org/Exif2-2.PDF | ||
|
||
For the format of the Canon stuff I used: | ||
|
||
- http://www.burren.cx/david/canon.html | ||
|
||
For the format of FujiFILM make note: | ||
|
||
- http://www.ozhiker.com/electronics/pjmt/jpeg_info/fujifilm_mn.html | ||
|
||
## Acknowledgments: | ||
|
||
[Nick Carter]([email protected]) provided conker.jpg which is used for testing FUJIFILM exif data. | ||
|
||
[Nick Burch]([email protected]) provided noexif.jpg which is used | ||
for testing inputs that don't have an existing EXIF segment. Nick burch | ||
also found an error in GeoTags on the S60. | ||
|
||
[Christopher Jones]([email protected]) who inspired updating | ||
my examples to show how copying EXIF data from one jpeg to another. | ||
|
||
[Roland Klabunde]([email protected]) who also found a bug in | ||
the GeoTag functionality. | ||
|
||
[Marcell Lengyel]([email protected]) for adding better support for | ||
Canon g3 and FujiFilm z5fd. | ||
|
||
[Andrew Baumann](http://ab.id.au/) for finding a bug in dealing with | ||
extended IFD sections, and supplying the timezone adjustment script. |