2 Copyright (C) 2013-2022 Carl Hetherington <cth@carlh.net>
4 This file is part of DCP-o-matic.
6 DCP-o-matic is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 DCP-o-matic is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with DCP-o-matic. If not, see <http://www.gnu.org/licenses/>.
22 /** @file src/tools/dcpomatic_kdm_cli.cc
23 * @brief Command-line program to generate KDMs.
29 #include "dkdm_wrapper.h"
31 #include "exceptions.h"
33 #include "kdm_with_metadata.h"
35 #include <dcp/certificate.h>
36 #include <dcp/decrypted_kdm.h>
37 #include <dcp/encrypted_kdm.h>
41 using std::dynamic_pointer_cast;
43 using std::make_shared;
44 using std::runtime_error;
45 using std::shared_ptr;
48 using boost::optional;
50 #if BOOST_VERSION >= 106100
51 using namespace boost::placeholders;
53 using namespace dcpomatic;
57 help (std::function<void (string)> out)
59 out (String::compose("Syntax: %1 [OPTION] <FILM|CPL-ID|DKDM>", program_name));
60 out (" -h, --help show this help");
61 out (" -o, --output output file or directory");
62 out (" -K, --filename-format filename format for KDMs");
63 out (" -Z, --container-name-format filename format for ZIP containers");
64 out (" -f, --valid-from valid from time (in local time zone of the cinema) (e.g. \"2013-09-28 01:41:51\") or \"now\"");
65 out (" -t, --valid-to valid to time (in local time zone of the cinema) (e.g. \"2014-09-28 01:41:51\")");
66 out (" -d, --valid-duration valid duration (e.g. \"1 day\", \"4 hours\", \"2 weeks\")");
67 out (" -F, --formulation modified-transitional-1, multiple-modified-transitional-1, dci-any or dci-specific [default modified-transitional-1]");
68 out (" -p, --disable-forensic-marking-picture disable forensic marking of pictures essences");
69 out (" -a, --disable-forensic-marking-audio disable forensic marking of audio essences (optionally above a given channel, e.g 12)");
70 out (" -e, --email email KDMs to cinemas");
71 out (" -z, --zip ZIP each cinema's KDMs into its own file");
72 out (" -v, --verbose be verbose");
73 out (" -c, --cinema cinema name (when using -C) or name/email (to filter cinemas)");
74 out (" -S, --screen screen name (when using -C) or screen name (to filter screens when using -c)");
75 out (" -C, --certificate file containing projector certificate");
76 out (" -T, --trusted-device file containing a trusted device's certificate");
77 out (" --list-cinemas list known cinemas from the DCP-o-matic settings");
78 out (" --list-dkdm-cpls list CPLs for which DCP-o-matic has DKDMs");
80 out ("CPL-ID must be the ID of a CPL that is mentioned in DCP-o-matic's DKDM list.");
84 out ("Create KDMs for my_great_movie to play in all of Fred's Cinema's screens for the next two weeks and zip them up.");
85 out ("(Fred's Cinema must have been set up in DCP-o-matic's KDM window)");
87 out (String::compose("\t%1 -c \"Fred's Cinema\" -f now -d \"2 weeks\" -z my_great_movie", program_name));
91 class KDMCLIError : public std::runtime_error
94 KDMCLIError (std::string message)
95 : std::runtime_error (String::compose("%1: %2", program_name, message).c_str())
100 static boost::posix_time::ptime
101 time_from_string (string t)
104 return boost::posix_time::second_clock::local_time ();
107 return boost::posix_time::time_from_string (t);
111 static boost::posix_time::time_duration
112 duration_from_string (string d)
115 char unit_buf[64] = "\0";
116 sscanf (d.c_str(), "%d %63s", &N, unit_buf);
117 string const unit (unit_buf);
120 throw KDMCLIError (String::compose("could not understand duration \"%1\"", d));
123 if (unit == "year" || unit == "years") {
124 return boost::posix_time::time_duration (N * 24 * 365, 0, 0, 0);
125 } else if (unit == "week" || unit == "weeks") {
126 return boost::posix_time::time_duration (N * 24 * 7, 0, 0, 0);
127 } else if (unit == "day" || unit == "days") {
128 return boost::posix_time::time_duration (N * 24, 0, 0, 0);
129 } else if (unit == "hour" || unit == "hours") {
130 return boost::posix_time::time_duration (N, 0, 0, 0);
133 throw KDMCLIError (String::compose("could not understand duration \"%1\"", d));
147 list<KDMWithMetadataPtr> kdms,
149 boost::filesystem::path output,
150 dcp::NameFormat container_name_format,
151 dcp::NameFormat filename_format,
153 std::function<void (string)> out
157 int const N = write_zip_files (
160 container_name_format,
162 bind (&always_overwrite)
166 out (String::compose("Wrote %1 ZIP files to %2", N, output));
169 int const N = write_files (
170 kdms, output, filename_format,
171 bind (&always_overwrite)
175 out (String::compose("Wrote %1 KDM files to %2", N, output));
183 find_cinema (string cinema_name)
185 auto cinemas = Config::instance()->cinemas ();
186 auto i = cinemas.begin();
188 i != cinemas.end() &&
189 (*i)->name != cinema_name &&
190 find ((*i)->emails.begin(), (*i)->emails.end(), cinema_name) == (*i)->emails.end()) {
195 if (i == cinemas.end ()) {
196 throw KDMCLIError (String::compose("could not find cinema \"%1\"", cinema_name));
206 list<shared_ptr<Screen>> screens,
207 boost::filesystem::path film_dir,
209 boost::filesystem::path output,
210 dcp::NameFormat container_name_format,
211 dcp::NameFormat filename_format,
212 boost::posix_time::ptime valid_from,
213 boost::posix_time::ptime valid_to,
214 dcp::Formulation formulation,
215 bool disable_forensic_marking_picture,
216 optional<int> disable_forensic_marking_audio,
219 std::function<void (string)> out
222 shared_ptr<Film> film;
224 film = make_shared<Film>(film_dir);
225 film->read_metadata ();
227 out (String::compose("Read film %1", film->name()));
229 } catch (std::exception& e) {
230 throw KDMCLIError (String::compose("error reading film \"%1\" (%2)", film_dir.string(), e.what()));
233 /* XXX: allow specification of this */
234 vector<CPLSummary> cpls = film->cpls ();
236 throw KDMCLIError ("no CPLs found in film");
237 } else if (cpls.size() > 1) {
238 throw KDMCLIError ("more than one CPL found in film");
241 auto cpl = cpls.front().cpl_file;
244 list<KDMWithMetadataPtr> kdms;
245 for (auto i: screens) {
246 auto p = kdm_for_screen (film, cpl, i, valid_from, valid_to, formulation, disable_forensic_marking_picture, disable_forensic_marking_audio);
251 write_files (kdms, zip, output, container_name_format, filename_format, verbose, out);
253 send_emails ({kdms}, container_name_format, filename_format, film->dcp_name(), {});
255 } catch (FileError& e) {
256 throw KDMCLIError (String::compose("%1 (%2)", e.what(), e.file().string()));
262 optional<dcp::EncryptedKDM>
263 sub_find_dkdm (shared_ptr<DKDMGroup> group, string cpl_id)
265 for (auto i: group->children()) {
266 auto g = dynamic_pointer_cast<DKDMGroup>(i);
268 auto dkdm = sub_find_dkdm (g, cpl_id);
273 auto d = dynamic_pointer_cast<DKDM>(i);
275 if (d->dkdm().cpl_id() == cpl_id) {
286 optional<dcp::EncryptedKDM>
287 find_dkdm (string cpl_id)
289 return sub_find_dkdm (Config::instance()->dkdms(), cpl_id);
296 dcp::DecryptedKDM dkdm,
297 dcp::Certificate target,
298 vector<string> trusted_devices,
299 dcp::LocalTime valid_from,
300 dcp::LocalTime valid_to,
301 dcp::Formulation formulation,
302 bool disable_forensic_marking_picture,
303 optional<int> disable_forensic_marking_audio
306 /* Signer for new KDM */
307 auto signer = Config::instance()->signer_chain ();
308 if (!signer->valid ()) {
309 throw KDMCLIError ("signing certificate chain is invalid.");
312 /* Make a new empty KDM and add the keys from the DKDM to it */
313 dcp::DecryptedKDM kdm (
316 dkdm.annotation_text().get_value_or(""),
317 dkdm.content_title_text(),
318 dcp::LocalTime().as_string()
321 for (auto const& j: dkdm.keys()) {
325 return kdm.encrypt (signer, target, trusted_devices, formulation, disable_forensic_marking_picture, disable_forensic_marking_audio);
332 list<shared_ptr<Screen>> screens,
333 dcp::DecryptedKDM dkdm,
335 boost::filesystem::path output,
336 dcp::NameFormat container_name_format,
337 dcp::NameFormat filename_format,
338 boost::posix_time::ptime valid_from,
339 boost::posix_time::ptime valid_to,
340 dcp::Formulation formulation,
341 bool disable_forensic_marking_picture,
342 optional<int> disable_forensic_marking_audio,
345 std::function<void (string)> out
348 dcp::NameFormat::Map values;
351 list<KDMWithMetadataPtr> kdms;
352 for (auto i: screens) {
357 int const offset_hour = i->cinema ? i->cinema->utc_offset_hour() : 0;
358 int const offset_minute = i->cinema ? i->cinema->utc_offset_minute() : 0;
360 dcp::LocalTime begin(valid_from, dcp::UTCOffset(offset_hour, offset_minute));
361 dcp::LocalTime end(valid_to, dcp::UTCOffset(offset_hour, offset_minute));
363 auto const kdm = kdm_from_dkdm(
366 i->trusted_device_thumbprints(),
370 disable_forensic_marking_picture,
371 disable_forensic_marking_audio
374 dcp::NameFormat::Map name_values;
375 name_values['c'] = i->cinema ? i->cinema->name : "";
376 name_values['s'] = i->name;
377 name_values['f'] = kdm.content_title_text();
378 name_values['b'] = begin.date() + " " + begin.time_of_day(true, false);
379 name_values['e'] = end.date() + " " + end.time_of_day(true, false);
380 name_values['i'] = kdm.cpl_id();
382 kdms.push_back (make_shared<KDMWithMetadata>(name_values, i->cinema.get(), i->cinema ? i->cinema->emails : list<string>(), kdm));
384 write_files (kdms, zip, output, container_name_format, filename_format, verbose, out);
386 send_emails ({kdms}, container_name_format, filename_format, dkdm.annotation_text().get_value_or(""), {});
388 } catch (FileError& e) {
389 throw KDMCLIError (String::compose("%1 (%2)", e.what(), e.file().string()));
396 dump_dkdm_group (shared_ptr<DKDMGroup> group, int indent, std::function<void (string)> out)
398 auto const indent_string = string(indent, ' ');
401 out (indent_string + group->name());
403 for (auto i: group->children()) {
404 auto g = dynamic_pointer_cast<DKDMGroup>(i);
406 dump_dkdm_group (g, indent + 2, out);
408 auto d = dynamic_pointer_cast<DKDM>(i);
410 out (indent_string + d->dkdm().cpl_id());
417 kdm_cli (int argc, char* argv[], std::function<void (string)> out)
420 boost::filesystem::path output = boost::filesystem::current_path();
421 auto container_name_format = Config::instance()->kdm_container_name_format();
422 auto filename_format = Config::instance()->kdm_filename_format();
423 optional<string> cinema_name;
424 shared_ptr<Cinema> cinema;
425 optional<boost::filesystem::path> certificate;
426 optional<string> screen;
427 list<shared_ptr<Screen>> screens;
428 optional<dcp::EncryptedKDM> dkdm;
429 optional<boost::posix_time::ptime> valid_from;
430 optional<boost::posix_time::ptime> valid_to;
432 bool list_cinemas = false;
433 bool list_dkdm_cpls = false;
434 optional<string> duration_string;
435 bool verbose = false;
436 dcp::Formulation formulation = dcp::Formulation::MODIFIED_TRANSITIONAL_1;
437 bool disable_forensic_marking_picture = false;
438 optional<int> disable_forensic_marking_audio;
441 program_name = argv[0];
443 /* Reset getopt() so we can call this method several times in one test process */
446 int option_index = 0;
448 static struct option long_options[] = {
449 { "help", no_argument, 0, 'h'},
450 { "output", required_argument, 0, 'o'},
451 { "filename-format", required_argument, 0, 'K'},
452 { "container-name-format", required_argument, 0, 'Z'},
453 { "valid-from", required_argument, 0, 'f'},
454 { "valid-to", required_argument, 0, 't'},
455 { "valid-duration", required_argument, 0, 'd'},
456 { "formulation", required_argument, 0, 'F' },
457 { "disable-forensic-marking-picture", no_argument, 0, 'p' },
458 { "disable-forensic-marking-audio", optional_argument, 0, 'a' },
459 { "email", no_argument, 0, 'e' },
460 { "zip", no_argument, 0, 'z' },
461 { "verbose", no_argument, 0, 'v' },
462 { "cinema", required_argument, 0, 'c' },
463 { "screen", required_argument, 0, 'S' },
464 { "certificate", required_argument, 0, 'C' },
465 { "trusted-device", required_argument, 0, 'T' },
466 { "list-cinemas", no_argument, 0, 'B' },
467 { "list-dkdm-cpls", no_argument, 0, 'D' },
471 int c = getopt_long (argc, argv, "ho:K:Z:f:t:d:F:pae::zvc:S:C:T:BD", long_options, &option_index);
485 filename_format = dcp::NameFormat (optarg);
488 container_name_format = dcp::NameFormat (optarg);
491 valid_from = time_from_string (optarg);
494 valid_to = time_from_string (optarg);
497 duration_string = optarg;
500 if (string(optarg) == "modified-transitional-1") {
501 formulation = dcp::Formulation::MODIFIED_TRANSITIONAL_1;
502 } else if (string(optarg) == "multiple-modified-transitional-1") {
503 formulation = dcp::Formulation::MULTIPLE_MODIFIED_TRANSITIONAL_1;
504 } else if (string(optarg) == "dci-any") {
505 formulation = dcp::Formulation::DCI_ANY;
506 } else if (string(optarg) == "dci-specific") {
507 formulation = dcp::Formulation::DCI_SPECIFIC;
509 throw KDMCLIError ("unrecognised KDM formulation " + string (optarg));
513 disable_forensic_marking_picture = true;
516 disable_forensic_marking_audio = 0;
517 if (optarg == 0 && argv[optind] != 0 && argv[optind][0] != '-') {
518 disable_forensic_marking_audio = atoi (argv[optind++]);
520 disable_forensic_marking_audio = atoi (optarg);
533 /* This could be a cinema to search for in the configured list or the name of a cinema being
534 built up on-the-fly in the option. Cater for both possilibities here by storing the name
535 (for lookup) and by creating a Cinema which the next Screen will be added to.
537 cinema_name = optarg;
538 cinema = make_shared<Cinema>(optarg, list<string>(), "", 0, 0);
541 /* Similarly, this could be the name of a new (temporary) screen or the name of a screen
547 certificate = optarg;
550 /* A trusted device ends up in the last screen we made */
551 if (!screens.empty ()) {
552 screens.back()->trusted_devices.push_back(TrustedDevice(dcp::Certificate(dcp::file_to_string(optarg))));
559 list_dkdm_cpls = true;
565 /* Make a new screen and add it to the current cinema */
566 dcp::CertificateChain chain(dcp::file_to_string(*certificate));
567 auto screen_to_add = std::make_shared<Screen>(screen.get_value_or(""), "", chain.leaf(), boost::none, vector<TrustedDevice>());
569 cinema->add_screen(screen_to_add);
571 screens.push_back(screen_to_add);
575 auto cinemas = Config::instance()->cinemas ();
576 for (auto i: cinemas) {
577 out (String::compose("%1 (%2)", i->name, Emailer::address_list (i->emails)));
582 if (list_dkdm_cpls) {
583 dump_dkdm_group (Config::instance()->dkdms(), 0, out);
587 if (!duration_string && !valid_to) {
588 throw KDMCLIError ("you must specify a --valid-duration or --valid-to");
592 throw KDMCLIError ("you must specify --valid-from");
595 if (optind >= argc) {
596 throw KDMCLIError ("no film, CPL ID or DKDM specified");
599 if (screens.empty()) {
601 throw KDMCLIError ("you must specify either a cinema or one or more screens using certificate files");
604 screens = find_cinema (*cinema_name)->screens ();
606 screens.erase(std::remove_if(screens.begin(), screens.end(), [&screen](shared_ptr<Screen> s) { return s->name != *screen; }), screens.end());
610 if (duration_string) {
611 valid_to = valid_from.get() + duration_from_string (*duration_string);
615 out (String::compose("Making KDMs valid from %1 to %2", boost::posix_time::to_simple_string(valid_from.get()), boost::posix_time::to_simple_string(valid_to.get())));
618 string const thing = argv[optind];
619 if (boost::filesystem::is_directory(thing) && boost::filesystem::is_regular_file(boost::filesystem::path(thing) / "metadata.xml")) {
625 container_name_format,
630 disable_forensic_marking_picture,
631 disable_forensic_marking_audio,
637 if (boost::filesystem::is_regular_file(thing)) {
638 dkdm = dcp::EncryptedKDM (dcp::file_to_string (thing));
640 dkdm = find_dkdm (thing);
644 throw KDMCLIError ("could not find film or CPL ID corresponding to " + thing);
649 dcp::DecryptedKDM (*dkdm, Config::instance()->decryption_chain()->key().get()),
652 container_name_format,
657 disable_forensic_marking_picture,
658 disable_forensic_marking_audio,
666 } catch (std::exception& e) {
667 return string(e.what());