1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
|
#!/usr/bin/python
# -*- coding: latin1 -*-
### Copyright (C) 2011-12 Damon Lynch <damonlynch@gmail.com>
### This program is free software; you can redistribute it and/or modify
### it under the terms of the GNU General Public License as published by
### the Free Software Foundation; either version 2 of the License, or
### (at your option) any later version.
### This program is distributed in the hope that it will be useful,
### but WITHOUT ANY WARRANTY; without even the implied warranty of
### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
### GNU General Public License for more details.
### You should have received a copy of the GNU General Public License
### along with this program; if not, write to the Free Software
### Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
import subprocess
import multiprocessing, logging
logger = multiprocessing.get_logger()
class XmpMetadataSidecar:
def __init__(self, filename):
self.filename = filename
self.keys = []
def _add_pair(self, key_value_pair):
self.keys.append(key_value_pair)
logger.debug(key_value_pair)
def _generate_exiv2_command_line(self):
# -f option: overwrites any existing xmp file
return ['exiv2', '-f'] + self.keys + ['-exX', self.filename]
def _generate_exiv2_contact_info(self, key, value):
return "-M set Xmp.iptc.CreatorContactInfo/Iptc4xmpCore:%s %s" % (key, value)
def _generate_exiv2_dc(self, key, value):
return "-M set Xmp.dc.%s %s" % (key, value)
def _generate_exiv2_photoshop(self, key, value):
return "-M set Xmp.photoshop.%s %s" % (key, value)
def _generate_exiv2_rights(self, key, value):
return "-M set Xmp.xmpRights.%s %s" % (key, value)
def _generate_exiv2_iptc(self, key, value):
return "-M set Xmp.iptc.%s %s" % (key, value)
def _generate_exiv2_exif(self, key, value):
return "-M set Xmp.exif.%s %s" % (key, value)
def set_location(self, location):
self._add_pair(self._generate_exiv2_iptc('Location', location))
def set_city(self, city):
self._add_pair(self._generate_exiv2_photoshop('City', city))
def set_state_province(self, state):
self._add_pair(self._generate_exiv2_photoshop('State', state))
def set_country(self, country):
self._add_pair(self._generate_exiv2_photoshop('Country', country))
def set_country_code(self, country_code):
self._add_pair(self._generate_exiv2_iptc('CountryCode', country_code))
def set_headline(self, headline):
self._add_pair(self._generate_exiv2_photoshop('Headline', headline))
def set_description_writer(self, writer):
"""
Synonym: Caption writer
"""
self._add_pair(self._generate_exiv2_photoshop('CaptionWriter', writer))
def set_description(self, description):
"""A synonym for this in some older programs is 'Caption'"""
self._add_pair(self._generate_exiv2_dc('description', description))
def set_subject(self, subject):
"""
You can call this more than once, to add multiple subjects
A synonym is 'Keywords'
"""
self._add_pair(self._generate_exiv2_dc('subject', subject))
def set_creator(self, creator):
"""
Sets the author (creator) field. Photo Mechanic calls this 'Photographer'.
"""
self._add_pair(self._generate_exiv2_dc('creator', creator))
def set_creator_job_title(self, job_title):
self._add_pair(self._generate_exiv2_photoshop('AuthorsPosition', job_title))
def set_credit_line(self, credit_line):
self._add_pair(self._generate_exiv2_photoshop('Credit', credit_line))
def set_source(self, source):
"""
original owner or copyright holder of the photograph
"""
self._add_pair(self._generate_exiv2_photoshop('Source', source))
def set_copyright(self, copyright):
self._add_pair(self._generate_exiv2_dc('rights', copyright))
def set_copyright_url(self, copyright_url):
self._add_pair(self._generate_exiv2_rights('WebStatement', copyright_url))
def set_contact_city(self, city):
self._add_pair(self._generate_exiv2_contact_info('CiAdrCity', city))
def set_contact_country(self, country):
self._add_pair(self._generate_exiv2_contact_info('CiAdrCtry', country))
def set_contact_address(self, address):
"""The contact information address part.
Comprises an optional company name and all required information
to locate the building or postbox to which mail should be sent."""
self._add_pair(self._generate_exiv2_contact_info('CiAdrExtadr', address))
def set_contact_postal_code(self, postal_code):
self._add_pair(self._generate_exiv2_contact_info('CiAdrPcode', postal_code))
def set_contact_region(self, region):
"""State/Province"""
self._add_pair(self._generate_exiv2_contact_info('CiAdrRegion', region))
def set_contact_email(self, email):
"""Multiple email addresses can be given, separated by a comma."""
self._add_pair(self._generate_exiv2_contact_info('CiEmailWork', email))
def set_contact_telephone(self, telephone):
"""Multiple numbers can be given, separated by a comma."""
self._add_pair(self._generate_exiv2_contact_info('CiTelWork', telephone))
def set_contact_url(self, url):
"""Multiple URLs can be given, separated by a comma."""
self._add_pair(self._generate_exiv2_contact_info('CiUrlWork', url))
def set_exif_value(self, key, value):
self._add_pair(self._generate_exiv2_exif(key, value))
def write_xmp_sidecar(self):
cmd = self._generate_exiv2_command_line()
if logger.getEffectiveLevel() == logging.DEBUG:
cmd_line = ''
for c in cmd:
cmd_line += c + ' '
cmd_line = cmd_line.strip()
logger.debug("XMP write command: %s", cmd_line)
proc = subprocess.Popen(cmd, stdout=subprocess.PIPE)
return proc.communicate()[0].strip()
if __name__ == '__main__':
import sys
if (len(sys.argv) != 2):
print 'Usage: ' + sys.argv[0] + ' path/to/photo/containing/metadata'
else:
x = XmpMetadataSidecar(sys.argv[1])
x.set_description("This is image is just a sample and is nothing serious. I used to test out writing XMP files in Rapid Photo Downloader.")
x.set_description_writer("Damon Lynch wrote caption")
x.set_headline("Sample image to test XMP")
x.set_subject("Keyword 1")
x.set_subject("Keyword 2")
x.set_city("Minneapolis")
x.set_location("University of Minnesota")
x.set_state_province("Minnesota")
x.set_country("United States of America")
x.set_country_code("USA")
x.set_creator("Damon Lynch")
x.set_creator_job_title("Photographer")
x.set_credit_line("Contact Damon for permission")
x.set_source("Damon Lynch is the original photographer")
x.set_copyright("© 2011 Damon Lynch, all rights reserved.")
x.set_copyright_url("http://www.damonlynch.net/license")
x.set_contact_address("Contact house number, street, apartment")
x.set_contact_city('Contact City')
x.set_contact_region('Contact State')
x.set_contact_postal_code('Contact Post code')
x.set_contact_telephone('+1 111 111 1111')
x.set_contact_country('Contact Country')
x.set_contact_address('Address\nApartment')
x.set_contact_url('http://www.sample.net')
x.set_contact_email('name@email1.com, name@email2.com')
x.write_xmp_sidecar()
|
