2 Copyright (C) 2012-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/>.
21 /** @file src/config.h
22 * @brief Class holding configuration.
26 #ifndef DCPOMATIC_CONFIG_H
27 #define DCPOMATIC_CONFIG_H
30 #include "audio_mapping.h"
33 #include <dcp/name_format.h>
34 #include <dcp/certificate_chain.h>
35 #include <dcp/encrypted_kdm.h>
36 #include <dcp/language_tag.h>
37 #include <boost/signals2.hpp>
38 #include <boost/filesystem.hpp>
43 class CinemaSoundProcessor;
51 extern void save_all_config_as_zip (boost::filesystem::path zip_file);
55 * @brief A singleton class holding configuration.
57 class Config : public State
60 /** @return number of threads which a master DoM should use for J2K encoding on the local machine */
61 int master_encoding_threads () const {
62 return _master_encoding_threads;
65 /** @return number of threads which a server should use for J2K encoding on the local machine */
66 int server_encoding_threads () const {
67 return _server_encoding_threads;
70 boost::optional<boost::filesystem::path> default_directory () const {
71 return _default_directory;
74 boost::optional<boost::filesystem::path> default_kdm_directory () const {
75 return _default_kdm_directory;
78 boost::filesystem::path default_directory_or (boost::filesystem::path a) const;
79 boost::filesystem::path default_kdm_directory_or (boost::filesystem::path a) const;
88 PLAYER_CONTENT_DIRECTORY,
89 PLAYER_PLAYLIST_DIRECTORY,
92 SHOW_EXPERIMENTAL_AUDIO_PROCESSORS,
98 /** @return base port number to use for J2K encoding servers */
99 int server_port_base () const {
100 return _server_port_base;
103 void set_use_any_servers (bool u) {
104 _use_any_servers = u;
105 changed (USE_ANY_SERVERS);
108 bool use_any_servers () const {
109 return _use_any_servers;
112 /** @param s New list of servers */
113 void set_servers (std::vector<std::string> s) {
118 /** @return Host names / IP addresses of J2K encoding servers that should definitely be used */
119 std::vector<std::string> servers () const {
123 bool only_servers_encode () const {
124 return _only_servers_encode;
127 FileTransferProtocol tms_protocol () const {
128 return _tms_protocol;
131 /** @return The IP address of a TMS that we can copy DCPs to */
132 std::string tms_ip () const {
136 /** @return The path on a TMS that we should changed DCPs to */
137 std::string tms_path () const {
141 /** @return User name to log into the TMS with */
142 std::string tms_user () const {
146 /** @return Password to log into the TMS with */
147 std::string tms_password () const {
148 return _tms_password;
151 std::list<std::shared_ptr<Cinema>> cinemas () const {
155 std::list<std::shared_ptr<DKDMRecipient>> dkdm_recipients () const {
156 return _dkdm_recipients;
159 std::list<int> allowed_dcp_frame_rates () const {
160 return _allowed_dcp_frame_rates;
163 bool allow_any_dcp_frame_rate () const {
164 return _allow_any_dcp_frame_rate;
167 bool allow_any_container () const {
168 return _allow_any_container;
171 bool allow_96khz_audio () const {
172 return _allow_96khz_audio;
175 bool show_experimental_audio_processors () const {
176 return _show_experimental_audio_processors;
179 boost::optional<std::string> language () const {
183 int default_still_length () const {
184 return _default_still_length;
187 Ratio const * default_container () const {
188 return _default_container;
191 DCPContentType const * default_dcp_content_type () const {
192 return _default_dcp_content_type;
195 int default_dcp_audio_channels () const {
196 return _default_dcp_audio_channels;
199 std::string dcp_issuer () const {
203 std::string dcp_creator () const {
207 std::string dcp_company_name () const {
208 return _dcp_company_name;
211 std::string dcp_product_name () const {
212 return _dcp_product_name;
215 std::string dcp_product_version () const {
216 return _dcp_product_version;
219 std::string dcp_j2k_comment () const {
220 return _dcp_j2k_comment;
223 int default_j2k_bandwidth () const {
224 return _default_j2k_bandwidth;
227 int default_audio_delay () const {
228 return _default_audio_delay;
231 bool default_interop () const {
232 return _default_interop;
235 std::map<std::string, std::string> default_metadata () const {
236 return _default_metadata;
239 bool upload_after_make_dcp () {
240 return _upload_after_make_dcp;
243 void set_default_kdm_directory (boost::filesystem::path d) {
244 if (_default_kdm_directory && _default_kdm_directory.get() == d) {
247 _default_kdm_directory = d;
251 std::string mail_server () const {
255 int mail_port () const {
259 EmailProtocol mail_protocol () const {
260 return _mail_protocol;
263 std::string mail_user () const {
267 std::string mail_password () const {
268 return _mail_password;
271 std::string kdm_subject () const {
275 std::string kdm_from () const {
279 std::vector<std::string> kdm_cc () const {
283 std::string kdm_bcc () const {
287 std::string kdm_email () const {
291 std::string notification_subject () const {
292 return _notification_subject;
295 std::string notification_from () const {
296 return _notification_from;
299 std::string notification_to () const {
300 return _notification_to;
303 std::vector<std::string> notification_cc () const {
304 return _notification_cc;
307 std::string notification_bcc () const {
308 return _notification_bcc;
311 std::string notification_email () const {
312 return _notification_email;
315 std::shared_ptr<const dcp::CertificateChain> signer_chain () const {
316 return _signer_chain;
319 std::shared_ptr<const dcp::CertificateChain> decryption_chain () const {
320 return _decryption_chain;
323 bool check_for_updates () const {
324 return _check_for_updates;
327 bool check_for_test_updates () const {
328 return _check_for_test_updates;
331 int maximum_j2k_bandwidth () const {
332 return _maximum_j2k_bandwidth;
335 int log_types () const {
339 bool analyse_ebur128 () const {
340 return _analyse_ebur128;
343 bool automatic_audio_analysis () const {
344 return _automatic_audio_analysis;
347 #ifdef DCPOMATIC_WINDOWS
348 bool win32_console () const {
349 return _win32_console;
353 std::vector<boost::filesystem::path> history () const {
357 std::vector<boost::filesystem::path> player_history () const {
358 return _player_history;
361 std::shared_ptr<DKDMGroup> dkdms () const {
365 boost::filesystem::path cinemas_file () const {
366 return _cinemas_file;
369 boost::filesystem::path dkdm_recipients_file () const {
370 return _dkdm_recipients_file;
373 bool show_hints_before_make_dcp () const {
374 return _show_hints_before_make_dcp;
377 bool confirm_kdm_email () const {
378 return _confirm_kdm_email;
381 dcp::NameFormat kdm_container_name_format () const {
382 return _kdm_container_name_format;
385 dcp::NameFormat kdm_filename_format () const {
386 return _kdm_filename_format;
389 dcp::NameFormat dkdm_filename_format () const {
390 return _dkdm_filename_format;
393 dcp::NameFormat dcp_metadata_filename_format () const {
394 return _dcp_metadata_filename_format;
397 dcp::NameFormat dcp_asset_filename_format () const {
398 return _dcp_asset_filename_format;
401 bool jump_to_selected () const {
402 return _jump_to_selected;
405 /* This could be an enum class but we use the enum a lot to index _nagged
406 * so it means a lot of casts.
410 NAG_ENCRYPTED_METADATA,
411 NAG_ALTER_DECRYPTION_CHAIN,
412 NAG_BAD_SIGNER_CHAIN_UTF8,
413 NAG_IMPORT_DECRYPTION_CHAIN,
416 NAG_TOO_MANY_DROPPED_FRAMES,
417 NAG_BAD_SIGNER_CHAIN_VALIDITY,
421 bool nagged (Nag nag) const {
425 bool sound () const {
429 std::string cover_sheet () const {
433 boost::optional<std::string> sound_output () const {
434 return _sound_output;
437 boost::optional<boost::filesystem::path> last_player_load_directory () const {
438 return _last_player_load_directory;
447 boost::optional<KDMWriteType> last_kdm_write_type () const {
448 return _last_kdm_write_type;
456 boost::optional<DKDMWriteType> last_dkdm_write_type () const {
457 return _last_dkdm_write_type;
460 int frames_in_memory_multiplier () const {
461 return _frames_in_memory_multiplier;
464 boost::optional<int> decode_reduction () const {
465 return _decode_reduction;
468 bool default_notify () const {
469 return _default_notify;
478 bool notification (Notification n) const {
479 return _notification[n];
482 boost::optional<std::string> barco_username () const {
483 return _barco_username;
486 boost::optional<std::string> barco_password () const {
487 return _barco_password;
490 boost::optional<std::string> christie_username () const {
491 return _christie_username;
494 boost::optional<std::string> christie_password () const {
495 return _christie_password;
498 boost::optional<std::string> gdc_username () const {
499 return _gdc_username;
502 boost::optional<std::string> gdc_password () const {
503 return _gdc_password;
507 PLAYER_MODE_WINDOW, ///< one window containing image and controls
508 PLAYER_MODE_FULL, ///< just the image filling the screen
509 PLAYER_MODE_DUAL ///< image on one monitor and extended controls on the other
512 PlayerMode player_mode () const {
516 int image_display () const {
517 return _image_display;
525 VideoViewType video_view_type () const {
526 return _video_view_type;
529 bool respect_kdm_validity_periods () const {
530 return _respect_kdm_validity_periods;
533 boost::optional<boost::filesystem::path> player_debug_log_file () const {
534 return _player_debug_log_file;
537 boost::optional<boost::filesystem::path> player_content_directory () const {
538 return _player_content_directory;
541 boost::optional<boost::filesystem::path> player_playlist_directory () const {
542 return _player_playlist_directory;
545 boost::optional<boost::filesystem::path> player_kdm_directory () const {
546 return _player_kdm_directory;
549 AudioMapping audio_mapping (int output_channels);
551 std::vector<dcp::LanguageTag> custom_languages () const {
552 return _custom_languages;
555 boost::optional<boost::filesystem::path> add_files_path () const {
556 return _add_files_path;
559 double auto_crop_threshold () const {
560 return _auto_crop_threshold;
563 bool use_isdcf_name_by_default () const {
564 return _use_isdcf_name_by_default;
567 bool write_kdms_to_disk () const {
568 return _write_kdms_to_disk;
571 bool email_kdms () const {
577 void set_master_encoding_threads (int n) {
578 maybe_set (_master_encoding_threads, n);
581 void set_server_encoding_threads (int n) {
582 maybe_set (_server_encoding_threads, n);
585 void set_default_directory (boost::filesystem::path d) {
586 if (_default_directory && *_default_directory == d) {
589 _default_directory = d;
593 /** @param p New server port */
594 void set_server_port_base (int p) {
595 maybe_set (_server_port_base, p);
598 void set_only_servers_encode (bool o) {
599 maybe_set (_only_servers_encode, o);
602 void set_tms_protocol (FileTransferProtocol p) {
603 maybe_set (_tms_protocol, p);
606 /** @param i IP address of a TMS that we can copy DCPs to */
607 void set_tms_ip (std::string i) {
608 maybe_set (_tms_ip, i);
611 /** @param p Path on a TMS that we should changed DCPs to */
612 void set_tms_path (std::string p) {
613 maybe_set (_tms_path, p);
616 /** @param u User name to log into the TMS with */
617 void set_tms_user (std::string u) {
618 maybe_set (_tms_user, u);
621 /** @param p Password to log into the TMS with */
622 void set_tms_password (std::string p) {
623 maybe_set (_tms_password, p);
626 void add_cinema (std::shared_ptr<Cinema> c) {
627 _cinemas.push_back (c);
631 void remove_cinema (std::shared_ptr<Cinema> c) {
636 void add_dkdm_recipient (std::shared_ptr<DKDMRecipient> c) {
637 _dkdm_recipients.push_back (c);
638 changed (DKDM_RECIPIENTS);
641 void remove_dkdm_recipient (std::shared_ptr<DKDMRecipient> c) {
642 _dkdm_recipients.remove (c);
643 changed (DKDM_RECIPIENTS);
646 void set_allowed_dcp_frame_rates (std::list<int> const & r) {
647 maybe_set (_allowed_dcp_frame_rates, r);
650 void set_allow_any_dcp_frame_rate (bool a) {
651 maybe_set (_allow_any_dcp_frame_rate, a);
654 void set_allow_any_container (bool a) {
655 maybe_set (_allow_any_container, a);
658 void set_allow_96hhz_audio (bool a) {
659 maybe_set (_allow_96khz_audio, a);
662 void set_show_experimental_audio_processors (bool e) {
663 maybe_set (_show_experimental_audio_processors, e, SHOW_EXPERIMENTAL_AUDIO_PROCESSORS);
666 void set_language (std::string l) {
667 if (_language && _language.get() == l) {
674 void unset_language () {
679 _language = boost::none;
683 void set_default_still_length (int s) {
684 maybe_set (_default_still_length, s);
687 void set_default_container (Ratio const * c) {
688 maybe_set (_default_container, c);
691 void set_default_dcp_content_type (DCPContentType const * t) {
692 maybe_set (_default_dcp_content_type, t);
695 void set_default_dcp_audio_channels (int c) {
696 maybe_set (_default_dcp_audio_channels, c);
699 void set_dcp_issuer (std::string i) {
700 maybe_set (_dcp_issuer, i);
703 void set_dcp_creator (std::string c) {
704 maybe_set (_dcp_creator, c);
707 void set_dcp_company_name (std::string c) {
708 maybe_set (_dcp_company_name, c);
711 void set_dcp_product_name (std::string c) {
712 maybe_set (_dcp_product_name, c);
715 void set_dcp_product_version (std::string c) {
716 maybe_set (_dcp_product_version, c);
719 void set_dcp_j2k_comment (std::string c) {
720 maybe_set (_dcp_j2k_comment, c);
723 void set_default_j2k_bandwidth (int b) {
724 maybe_set (_default_j2k_bandwidth, b);
727 void set_default_audio_delay (int d) {
728 maybe_set (_default_audio_delay, d);
731 void set_default_interop (bool i) {
732 maybe_set (_default_interop, i);
735 void set_default_metadata (std::map<std::string, std::string> const& metadata) {
736 maybe_set (_default_metadata, metadata);
739 void set_upload_after_make_dcp (bool u) {
740 maybe_set (_upload_after_make_dcp, u);
743 void set_mail_server (std::string s) {
744 maybe_set (_mail_server, s);
747 void set_mail_port (int p) {
748 maybe_set (_mail_port, p);
751 void set_mail_protocol (EmailProtocol p) {
752 maybe_set (_mail_protocol, p);
755 void set_mail_user (std::string u) {
756 maybe_set (_mail_user, u);
759 void set_mail_password (std::string p) {
760 maybe_set (_mail_password, p);
763 void set_kdm_subject (std::string s) {
764 maybe_set (_kdm_subject, s);
767 void set_kdm_from (std::string f) {
768 maybe_set (_kdm_from, f);
771 void set_kdm_cc (std::vector<std::string> f) {
772 maybe_set (_kdm_cc, f);
775 void set_kdm_bcc (std::string f) {
776 maybe_set (_kdm_bcc, f);
779 void set_kdm_email (std::string e) {
780 maybe_set (_kdm_email, e);
783 void reset_kdm_email ();
785 void set_notification_subject (std::string s) {
786 maybe_set (_notification_subject, s);
789 void set_notification_from (std::string f) {
790 maybe_set (_notification_from, f);
793 void set_notification_to (std::string t) {
794 maybe_set (_notification_to, t);
797 void set_notification_cc (std::vector<std::string> f) {
798 maybe_set (_notification_cc, f);
801 void set_notification_bcc (std::string f) {
802 maybe_set (_notification_bcc, f);
805 void set_notification_email (std::string e) {
806 maybe_set (_notification_email, e);
809 void reset_notification_email ();
811 void set_signer_chain (std::shared_ptr<const dcp::CertificateChain> s) {
812 maybe_set (_signer_chain, s);
815 void set_decryption_chain (std::shared_ptr<const dcp::CertificateChain> c) {
816 maybe_set (_decryption_chain, c);
819 void set_check_for_updates (bool c) {
820 maybe_set (_check_for_updates, c);
822 set_check_for_test_updates (false);
826 void set_check_for_test_updates (bool c) {
827 maybe_set (_check_for_test_updates, c);
830 void set_maximum_j2k_bandwidth (int b) {
831 maybe_set (_maximum_j2k_bandwidth, b);
834 void set_log_types (int t) {
835 maybe_set (_log_types, t);
838 void set_analyse_ebur128 (bool a) {
839 maybe_set (_analyse_ebur128, a);
842 void set_automatic_audio_analysis (bool a) {
843 maybe_set (_automatic_audio_analysis, a);
846 #ifdef DCPOMATIC_WINDOWS
847 void set_win32_console (bool c) {
848 maybe_set (_win32_console, c);
852 void set_dkdms (std::shared_ptr<DKDMGroup> dkdms) {
857 void set_cinemas_file (boost::filesystem::path file);
859 void set_show_hints_before_make_dcp (bool s) {
860 maybe_set (_show_hints_before_make_dcp, s);
863 void set_confirm_kdm_email (bool s) {
864 maybe_set (_confirm_kdm_email, s);
867 void set_sound (bool s) {
868 maybe_set (_sound, s, SOUND);
871 void set_sound_output (std::string o) {
872 maybe_set (_sound_output, o, SOUND_OUTPUT);
875 void set_last_player_load_directory (boost::filesystem::path d) {
876 maybe_set (_last_player_load_directory, d);
879 void set_last_kdm_write_type (KDMWriteType t) {
880 maybe_set (_last_kdm_write_type, t);
883 void set_last_dkdm_write_type (DKDMWriteType t) {
884 maybe_set (_last_dkdm_write_type, t);
887 void unset_sound_output () {
888 if (!_sound_output) {
892 _sound_output = boost::none;
896 void set_kdm_container_name_format (dcp::NameFormat n) {
897 maybe_set (_kdm_container_name_format, n);
900 void set_kdm_filename_format (dcp::NameFormat n) {
901 maybe_set (_kdm_filename_format, n);
904 void set_dkdm_filename_format (dcp::NameFormat n) {
905 maybe_set (_dkdm_filename_format, n);
908 void set_dcp_metadata_filename_format (dcp::NameFormat n) {
909 maybe_set (_dcp_metadata_filename_format, n);
912 void set_dcp_asset_filename_format (dcp::NameFormat n) {
913 maybe_set (_dcp_asset_filename_format, n);
916 void set_frames_in_memory_multiplier (int m) {
917 maybe_set (_frames_in_memory_multiplier, m);
920 void set_decode_reduction (boost::optional<int> r) {
921 maybe_set (_decode_reduction, r);
924 void set_default_notify (bool n) {
925 maybe_set (_default_notify, n);
928 void clear_history () {
933 void clear_player_history () {
934 _player_history.clear ();
938 void add_to_history (boost::filesystem::path p);
939 void clean_history ();
940 void add_to_player_history (boost::filesystem::path p);
941 void clean_player_history ();
943 void set_jump_to_selected (bool j) {
944 maybe_set (_jump_to_selected, j);
947 void set_nagged (Nag nag, bool nagged) {
948 maybe_set (_nagged[nag], nagged);
951 void set_cover_sheet (std::string s) {
952 maybe_set (_cover_sheet, s);
955 void reset_cover_sheet ();
957 void set_notification (Notification n, bool v) {
958 maybe_set (_notification[n], v);
961 void set_barco_username (std::string u) {
962 maybe_set (_barco_username, u);
965 void unset_barco_username () {
966 maybe_set (_barco_username, boost::optional<std::string>());
969 void set_barco_password (std::string p) {
970 maybe_set (_barco_password, p);
973 void unset_barco_password () {
974 maybe_set (_barco_password, boost::optional<std::string>());
977 void set_christie_username (std::string u) {
978 maybe_set (_christie_username, u);
981 void unset_christie_username () {
982 maybe_set (_christie_username, boost::optional<std::string>());
985 void set_christie_password (std::string p) {
986 maybe_set (_christie_password, p);
989 void unset_christie_password () {
990 maybe_set (_christie_password, boost::optional<std::string>());
993 void set_gdc_username (std::string u) {
994 maybe_set (_gdc_username, u);
997 void unset_gdc_username () {
998 maybe_set (_gdc_username, boost::optional<std::string>());
1001 void set_gdc_password (std::string p) {
1002 maybe_set (_gdc_password, p);
1005 void unset_gdc_password () {
1006 maybe_set (_gdc_password, boost::optional<std::string>());
1009 void set_player_mode (PlayerMode m) {
1010 maybe_set (_player_mode, m);
1013 void set_image_display (int n) {
1014 maybe_set (_image_display, n);
1017 void set_video_view_type (VideoViewType v) {
1018 maybe_set (_video_view_type, v);
1021 void set_respect_kdm_validity_periods (bool r) {
1022 maybe_set (_respect_kdm_validity_periods, r);
1025 void set_player_debug_log_file (boost::filesystem::path p) {
1026 maybe_set (_player_debug_log_file, p, PLAYER_DEBUG_LOG);
1029 void unset_player_debug_log_file () {
1030 if (!_player_debug_log_file) {
1033 _player_debug_log_file = boost::none;
1034 changed (PLAYER_DEBUG_LOG);
1037 void set_player_content_directory (boost::filesystem::path p) {
1038 maybe_set (_player_content_directory, p, PLAYER_CONTENT_DIRECTORY);
1041 void unset_player_content_directory () {
1042 if (!_player_content_directory) {
1045 _player_content_directory = boost::none;
1046 changed (PLAYER_CONTENT_DIRECTORY);
1049 void set_player_playlist_directory (boost::filesystem::path p) {
1050 maybe_set (_player_playlist_directory, p, PLAYER_PLAYLIST_DIRECTORY);
1053 void unset_player_playlist_directory () {
1054 if (!_player_playlist_directory) {
1057 _player_playlist_directory = boost::none;
1058 changed (PLAYER_PLAYLIST_DIRECTORY);
1061 void set_player_kdm_directory (boost::filesystem::path p) {
1062 maybe_set (_player_kdm_directory, p);
1065 void unset_player_kdm_directory () {
1066 if (!_player_kdm_directory) {
1069 _player_kdm_directory = boost::none;
1073 void set_audio_mapping (AudioMapping m);
1074 void set_audio_mapping_to_default ();
1076 void add_custom_language (dcp::LanguageTag tag);
1078 void set_add_files_path (boost::filesystem::path p) {
1079 _add_files_path = p;
1083 void set_auto_crop_threshold (double threshold) {
1084 maybe_set (_auto_crop_threshold, threshold, AUTO_CROP_THRESHOLD);
1087 void set_use_isdcf_name_by_default (bool use) {
1088 maybe_set (_use_isdcf_name_by_default, use);
1091 void set_write_kdms_to_disk (bool write) {
1092 maybe_set (_write_kdms_to_disk, write);
1095 void set_email_kdms (bool email) {
1096 maybe_set (_email_kdms, email);
1099 void changed (Property p = OTHER);
1100 boost::signals2::signal<void (Property)> Changed;
1101 /** Emitted if read() failed on an existing Config file. There is nothing
1102 a listener can do about it: this is just for information.
1104 static boost::signals2::signal<void ()> FailedToLoad;
1105 /** Emitted if read() issued a warning which the user might want to know about */
1106 static boost::signals2::signal<void (std::string)> Warning;
1107 /** Emitted if there is a something wrong the contents of our config. Handler can call
1108 * true to ask Config to solve the problem (by discarding and recreating the bad thing)
1111 BAD_SIGNER_UTF8_STRINGS, ///< signer chain contains UTF-8 strings (not PRINTABLESTRING)
1112 BAD_SIGNER_INCONSISTENT, ///< signer chain is somehow inconsistent
1113 BAD_DECRYPTION_INCONSISTENT, ///< KDM decryption chain is somehow inconsistent
1114 BAD_SIGNER_VALIDITY_TOO_LONG, ///< signer certificate validity periods are >10 years
1117 static boost::signals2::signal<bool (BadReason)> Bad;
1119 void write () const;
1120 void write_config () const;
1121 void write_cinemas () const;
1122 void write_dkdm_recipients () const;
1123 void link (boost::filesystem::path new_file) const;
1124 void copy_and_link (boost::filesystem::path new_file) const;
1125 bool have_write_permission () const;
1127 void save_template (std::shared_ptr<const Film> film, std::string name) const;
1128 bool existing_template (std::string name) const;
1129 std::list<std::string> templates () const;
1130 boost::filesystem::path template_read_path (std::string name) const;
1131 boost::filesystem::path template_write_path (std::string name) const;
1132 void rename_template (std::string old_name, std::string new_name) const;
1133 void delete_template (std::string name) const;
1135 boost::optional<BadReason> check_certificates () const;
1137 static Config* instance ();
1138 static void drop ();
1139 static void restore_defaults ();
1140 static bool have_existing (std::string);
1141 static boost::filesystem::path config_read_file ();
1142 static boost::filesystem::path config_write_file ();
1147 void set_defaults ();
1148 void set_kdm_email_to_default ();
1149 void set_notification_email_to_default ();
1150 void set_cover_sheet_to_default ();
1151 void read_cinemas (cxml::Document const & f);
1152 void read_dkdm_recipients (cxml::Document const & f);
1153 std::shared_ptr<dcp::CertificateChain> create_certificate_chain ();
1154 boost::filesystem::path directory_or (boost::optional<boost::filesystem::path> dir, boost::filesystem::path a) const;
1155 void add_to_history_internal (std::vector<boost::filesystem::path>& h, boost::filesystem::path p);
1156 void clean_history_internal (std::vector<boost::filesystem::path>& h);
1160 void maybe_set (T& member, T new_value, Property prop = OTHER) {
1161 if (member == new_value) {
1169 void maybe_set (boost::optional<T>& member, T new_value, Property prop = OTHER) {
1170 if (member && member.get() == new_value) {
1177 /** number of threads which a master DoM should use for J2K encoding on the local machine */
1178 int _master_encoding_threads;
1179 /** number of threads which a server should use for J2K encoding on the local machine */
1180 int _server_encoding_threads;
1181 /** default directory to put new films in */
1182 boost::optional<boost::filesystem::path> _default_directory;
1183 /** base port number to use for J2K encoding servers;
1184 * this port and the two above it will be used.
1186 int _server_port_base;
1187 /** true to broadcast on the `any' address to look for servers */
1188 bool _use_any_servers;
1189 /** J2K encoding servers that should definitely be used */
1190 std::vector<std::string> _servers;
1191 bool _only_servers_encode;
1192 FileTransferProtocol _tms_protocol;
1193 /** The IP address of a TMS that we can copy DCPs to */
1194 std::string _tms_ip;
1195 /** The path on a TMS that we should write DCPs to */
1196 std::string _tms_path;
1197 /** User name to log into the TMS with */
1198 std::string _tms_user;
1199 /** Password to log into the TMS with */
1200 std::string _tms_password;
1201 /** The list of possible DCP frame rates that DCP-o-matic will use */
1202 std::list<int> _allowed_dcp_frame_rates;
1203 /** Allow any video frame rate for the DCP; if true, overrides _allowed_dcp_frame_rates */
1204 bool _allow_any_dcp_frame_rate;
1205 /** Allow any container ratio, not just the standard ones. GDC SX-2001 will not play Flat
1206 DCPs at 25fps but will play 16:9, so this is very useful for some users.
1207 https://www.dcpomatic.com/forum/viewtopic.php?f=2&t=1119&p=4468
1209 bool _allow_any_container;
1210 bool _allow_96khz_audio;
1211 /** Offer the upmixers in the audio processor settings */
1212 bool _show_experimental_audio_processors;
1213 boost::optional<std::string> _language;
1214 /** Default length of still image content (seconds) */
1215 int _default_still_length;
1216 Ratio const * _default_container;
1217 DCPContentType const * _default_dcp_content_type;
1218 int _default_dcp_audio_channels;
1219 std::string _dcp_issuer;
1220 std::string _dcp_creator;
1221 std::string _dcp_company_name;
1222 std::string _dcp_product_name;
1223 std::string _dcp_product_version;
1224 std::string _dcp_j2k_comment;
1225 int _default_j2k_bandwidth;
1226 int _default_audio_delay;
1227 bool _default_interop;
1228 std::map<std::string, std::string> _default_metadata;
1229 /** Default directory to offer to write KDMs to; if it's not set,
1230 the home directory will be offered.
1232 boost::optional<boost::filesystem::path> _default_kdm_directory;
1233 bool _upload_after_make_dcp;
1234 std::list<std::shared_ptr<Cinema>> _cinemas;
1235 std::list<std::shared_ptr<DKDMRecipient>> _dkdm_recipients;
1236 std::string _mail_server;
1238 EmailProtocol _mail_protocol;
1239 std::string _mail_user;
1240 std::string _mail_password;
1241 std::string _kdm_subject;
1242 std::string _kdm_from;
1243 std::vector<std::string> _kdm_cc;
1244 std::string _kdm_bcc;
1245 std::string _kdm_email;
1246 std::string _notification_subject;
1247 std::string _notification_from;
1248 std::string _notification_to;
1249 std::vector<std::string> _notification_cc;
1250 std::string _notification_bcc;
1251 std::string _notification_email;
1252 std::shared_ptr<const dcp::CertificateChain> _signer_chain;
1253 /** Chain used to decrypt KDMs; the leaf of this chain is the target
1254 * certificate for making KDMs given to DCP-o-matic.
1256 std::shared_ptr<const dcp::CertificateChain> _decryption_chain;
1257 /** true to check for updates on startup */
1258 bool _check_for_updates;
1259 bool _check_for_test_updates;
1260 /** maximum allowed J2K bandwidth in bits per second */
1261 int _maximum_j2k_bandwidth;
1263 bool _analyse_ebur128;
1264 bool _automatic_audio_analysis;
1265 #ifdef DCPOMATIC_WINDOWS
1266 bool _win32_console;
1268 std::vector<boost::filesystem::path> _history;
1269 std::vector<boost::filesystem::path> _player_history;
1270 std::shared_ptr<DKDMGroup> _dkdms;
1271 boost::filesystem::path _cinemas_file;
1272 boost::filesystem::path _dkdm_recipients_file;
1273 bool _show_hints_before_make_dcp;
1274 bool _confirm_kdm_email;
1275 dcp::NameFormat _kdm_filename_format;
1276 dcp::NameFormat _dkdm_filename_format;
1277 dcp::NameFormat _kdm_container_name_format;
1278 dcp::NameFormat _dcp_metadata_filename_format;
1279 dcp::NameFormat _dcp_asset_filename_format;
1280 bool _jump_to_selected;
1281 bool _nagged[NAG_COUNT];
1283 /** name of a specific sound output stream to use, or empty to use the default */
1284 boost::optional<std::string> _sound_output;
1285 std::string _cover_sheet;
1286 boost::optional<boost::filesystem::path> _last_player_load_directory;
1287 boost::optional<KDMWriteType> _last_kdm_write_type;
1288 boost::optional<DKDMWriteType> _last_dkdm_write_type;
1289 int _frames_in_memory_multiplier;
1290 boost::optional<int> _decode_reduction;
1291 bool _default_notify;
1292 bool _notification[NOTIFICATION_COUNT];
1293 boost::optional<std::string> _barco_username;
1294 boost::optional<std::string> _barco_password;
1295 boost::optional<std::string> _christie_username;
1296 boost::optional<std::string> _christie_password;
1297 boost::optional<std::string> _gdc_username;
1298 boost::optional<std::string> _gdc_password;
1299 PlayerMode _player_mode;
1301 VideoViewType _video_view_type;
1302 bool _respect_kdm_validity_periods;
1303 /** Log file containing debug information for the player */
1304 boost::optional<boost::filesystem::path> _player_debug_log_file;
1305 /** A directory containing DCPs whose contents are presented to the user
1306 in the dual-screen player mode. DCPs on the list can be loaded
1309 boost::optional<boost::filesystem::path> _player_content_directory;
1310 boost::optional<boost::filesystem::path> _player_playlist_directory;
1311 boost::optional<boost::filesystem::path> _player_kdm_directory;
1312 boost::optional<AudioMapping> _audio_mapping;
1313 std::vector<dcp::LanguageTag> _custom_languages;
1314 boost::optional<boost::filesystem::path> _add_files_path;
1315 double _auto_crop_threshold;
1316 bool _use_isdcf_name_by_default;
1317 bool _write_kdms_to_disk;
1320 static int const _current_version;
1322 /** Singleton instance, or 0 */
1323 static Config* _instance;