Add recent files list to player.
[dcpomatic.git] / src / lib / config.h
1 /*
2     Copyright (C) 2012-2018 Carl Hetherington <cth@carlh.net>
3
4     This file is part of DCP-o-matic.
5
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.
10
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.
15
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/>.
18
19 */
20
21 /** @file src/config.h
22  *  @brief Class holding configuration.
23  */
24
25 #ifndef DCPOMATIC_CONFIG_H
26 #define DCPOMATIC_CONFIG_H
27
28 #include "isdcf_metadata.h"
29 #include "types.h"
30 #include <dcp/name_format.h>
31 #include <dcp/certificate_chain.h>
32 #include <dcp/encrypted_kdm.h>
33 #include <boost/shared_ptr.hpp>
34 #include <boost/signals2.hpp>
35 #include <boost/filesystem.hpp>
36 #include <vector>
37
38 class CinemaSoundProcessor;
39 class DCPContentType;
40 class Ratio;
41 class Cinema;
42 class Film;
43 class DKDMGroup;
44
45 /** @class Config
46  *  @brief A singleton class holding configuration.
47  */
48 class Config : public boost::noncopyable
49 {
50 public:
51         /** @return number of threads which a master DoM should use for J2K encoding on the local machine */
52         int master_encoding_threads () const {
53                 return _master_encoding_threads;
54         }
55
56         /** @return number of threads which a server should use for J2K encoding on the local machine */
57         int server_encoding_threads () const {
58                 return _server_encoding_threads;
59         }
60
61         boost::optional<boost::filesystem::path> default_directory () const {
62                 return _default_directory;
63         }
64
65         boost::optional<boost::filesystem::path> default_kdm_directory () const {
66                 return _default_kdm_directory;
67         }
68
69         boost::filesystem::path default_directory_or (boost::filesystem::path a) const;
70         boost::filesystem::path default_kdm_directory_or (boost::filesystem::path a) const;
71
72         enum Property {
73                 USE_ANY_SERVERS,
74                 SERVERS,
75                 CINEMAS,
76                 SOUND,
77                 SOUND_OUTPUT,
78                 OTHER
79         };
80
81         /** @return base port number to use for J2K encoding servers */
82         int server_port_base () const {
83                 return _server_port_base;
84         }
85
86         void set_use_any_servers (bool u) {
87                 _use_any_servers = u;
88                 changed (USE_ANY_SERVERS);
89         }
90
91         bool use_any_servers () const {
92                 return _use_any_servers;
93         }
94
95         /** @param s New list of servers */
96         void set_servers (std::vector<std::string> s) {
97                 _servers = s;
98                 changed (SERVERS);
99         }
100
101         /** @return Host names / IP addresses of J2K encoding servers that should definitely be used */
102         std::vector<std::string> servers () const {
103                 return _servers;
104         }
105
106         bool only_servers_encode () const {
107                 return _only_servers_encode;
108         }
109
110         Protocol tms_protocol () const {
111                 return _tms_protocol;
112         }
113
114         /** @return The IP address of a TMS that we can copy DCPs to */
115         std::string tms_ip () const {
116                 return _tms_ip;
117         }
118
119         /** @return The path on a TMS that we should changed DCPs to */
120         std::string tms_path () const {
121                 return _tms_path;
122         }
123
124         /** @return User name to log into the TMS with */
125         std::string tms_user () const {
126                 return _tms_user;
127         }
128
129         /** @return Password to log into the TMS with */
130         std::string tms_password () const {
131                 return _tms_password;
132         }
133
134         /** @return The cinema sound processor that we are using */
135         CinemaSoundProcessor const * cinema_sound_processor () const {
136                 return _cinema_sound_processor;
137         }
138
139         std::list<boost::shared_ptr<Cinema> > cinemas () const {
140                 return _cinemas;
141         }
142
143         std::list<int> allowed_dcp_frame_rates () const {
144                 return _allowed_dcp_frame_rates;
145         }
146
147         bool allow_any_dcp_frame_rate () const {
148                 return _allow_any_dcp_frame_rate;
149         }
150
151         ISDCFMetadata default_isdcf_metadata () const {
152                 return _default_isdcf_metadata;
153         }
154
155         boost::optional<std::string> language () const {
156                 return _language;
157         }
158
159         int default_still_length () const {
160                 return _default_still_length;
161         }
162
163         Ratio const * default_container () const {
164                 return _default_container;
165         }
166
167         Ratio const * default_scale_to () const {
168                 return _default_scale_to;
169         }
170
171         DCPContentType const * default_dcp_content_type () const {
172                 return _default_dcp_content_type;
173         }
174
175         int default_dcp_audio_channels () const {
176                 return _default_dcp_audio_channels;
177         }
178
179         std::string dcp_issuer () const {
180                 return _dcp_issuer;
181         }
182
183         std::string dcp_creator () const {
184                 return _dcp_creator;
185         }
186
187         int default_j2k_bandwidth () const {
188                 return _default_j2k_bandwidth;
189         }
190
191         int default_audio_delay () const {
192                 return _default_audio_delay;
193         }
194
195         bool default_interop () const {
196                 return _default_interop;
197         }
198
199         bool default_upload_after_make_dcp () {
200                 return _default_upload_after_make_dcp;
201         }
202
203         void set_default_kdm_directory (boost::filesystem::path d) {
204                 if (_default_kdm_directory && _default_kdm_directory.get() == d) {
205                         return;
206                 }
207                 _default_kdm_directory = d;
208                 changed ();
209         }
210
211         std::string mail_server () const {
212                 return _mail_server;
213         }
214
215         int mail_port () const {
216                 return _mail_port;
217         }
218
219         std::string mail_user () const {
220                 return _mail_user;
221         }
222
223         std::string mail_password () const {
224                 return _mail_password;
225         }
226
227         std::string kdm_subject () const {
228                 return _kdm_subject;
229         }
230
231         std::string kdm_from () const {
232                 return _kdm_from;
233         }
234
235         std::vector<std::string> kdm_cc () const {
236                 return _kdm_cc;
237         }
238
239         std::string kdm_bcc () const {
240                 return _kdm_bcc;
241         }
242
243         std::string kdm_email () const {
244                 return _kdm_email;
245         }
246
247         boost::shared_ptr<const dcp::CertificateChain> signer_chain () const {
248                 return _signer_chain;
249         }
250
251         boost::shared_ptr<const dcp::CertificateChain> decryption_chain () const {
252                 return _decryption_chain;
253         }
254
255         bool check_for_updates () const {
256                 return _check_for_updates;
257         }
258
259         bool check_for_test_updates () const {
260                 return _check_for_test_updates;
261         }
262
263         int maximum_j2k_bandwidth () const {
264                 return _maximum_j2k_bandwidth;
265         }
266
267         int log_types () const {
268                 return _log_types;
269         }
270
271         bool analyse_ebur128 () const {
272                 return _analyse_ebur128;
273         }
274
275         bool automatic_audio_analysis () const {
276                 return _automatic_audio_analysis;
277         }
278
279 #ifdef DCPOMATIC_WINDOWS
280         bool win32_console () const {
281                 return _win32_console;
282         }
283 #endif
284
285         std::vector<boost::filesystem::path> history () const {
286                 return _history;
287         }
288
289         std::vector<boost::filesystem::path> player_history () const {
290                 return _player_history;
291         }
292
293         boost::shared_ptr<DKDMGroup> dkdms () const {
294                 return _dkdms;
295         }
296
297         boost::filesystem::path cinemas_file () const {
298                 return _cinemas_file;
299         }
300
301         bool show_hints_before_make_dcp () const {
302                 return _show_hints_before_make_dcp;
303         }
304
305         bool confirm_kdm_email () const {
306                 return _confirm_kdm_email;
307         }
308
309         dcp::NameFormat kdm_container_name_format () const {
310                 return _kdm_container_name_format;
311         }
312
313         dcp::NameFormat kdm_filename_format () const {
314                 return _kdm_filename_format;
315         }
316
317         dcp::NameFormat dcp_metadata_filename_format () const {
318                 return _dcp_metadata_filename_format;
319         }
320
321         dcp::NameFormat dcp_asset_filename_format () const {
322                 return _dcp_asset_filename_format;
323         }
324
325         bool jump_to_selected () const {
326                 return _jump_to_selected;
327         }
328
329         enum Nag {
330                 NAG_DKDM_CONFIG,
331                 NAG_ENCRYPTED_METADATA,
332                 NAG_REMAKE_DECRYPTION_CHAIN,
333                 NAG_COUNT
334         };
335
336         bool nagged (Nag nag) const {
337                 return _nagged[nag];
338         }
339
340         bool sound () const {
341                 return _sound;
342         }
343
344         std::string cover_sheet () const {
345                 return _cover_sheet;
346         }
347
348         boost::optional<std::string> sound_output () const {
349                 return _sound_output;
350         }
351
352         boost::optional<boost::filesystem::path> last_player_load_directory () const {
353                 return _last_player_load_directory;
354         }
355
356         enum KDMWriteType {
357                 KDM_WRITE_FLAT,
358                 KDM_WRITE_FOLDER,
359                 KDM_WRITE_ZIP
360         };
361
362         boost::optional<KDMWriteType> last_kdm_write_type () const {
363                 return _last_kdm_write_type;
364         }
365
366         int frames_in_memory_multiplier () const {
367                 return _frames_in_memory_multiplier;
368         }
369
370         void set_master_encoding_threads (int n) {
371                 maybe_set (_master_encoding_threads, n);
372         }
373
374         void set_server_encoding_threads (int n) {
375                 maybe_set (_server_encoding_threads, n);
376         }
377
378         void set_default_directory (boost::filesystem::path d) {
379                 if (_default_directory && *_default_directory == d) {
380                         return;
381                 }
382                 _default_directory = d;
383                 changed ();
384         }
385
386         /** @param p New server port */
387         void set_server_port_base (int p) {
388                 maybe_set (_server_port_base, p);
389         }
390
391         void set_only_servers_encode (bool o) {
392                 maybe_set (_only_servers_encode, o);
393         }
394
395         void set_tms_protocol (Protocol p) {
396                 maybe_set (_tms_protocol, p);
397         }
398
399         /** @param i IP address of a TMS that we can copy DCPs to */
400         void set_tms_ip (std::string i) {
401                 maybe_set (_tms_ip, i);
402         }
403
404         /** @param p Path on a TMS that we should changed DCPs to */
405         void set_tms_path (std::string p) {
406                 maybe_set (_tms_path, p);
407         }
408
409         /** @param u User name to log into the TMS with */
410         void set_tms_user (std::string u) {
411                 maybe_set (_tms_user, u);
412         }
413
414         /** @param p Password to log into the TMS with */
415         void set_tms_password (std::string p) {
416                 maybe_set (_tms_password, p);
417         }
418
419         void add_cinema (boost::shared_ptr<Cinema> c) {
420                 _cinemas.push_back (c);
421                 changed (CINEMAS);
422         }
423
424         void remove_cinema (boost::shared_ptr<Cinema> c) {
425                 _cinemas.remove (c);
426                 changed (CINEMAS);
427         }
428
429         void set_allowed_dcp_frame_rates (std::list<int> const & r) {
430                 maybe_set (_allowed_dcp_frame_rates, r);
431         }
432
433         void set_allow_any_dcp_frame_rate (bool a) {
434                 maybe_set (_allow_any_dcp_frame_rate, a);
435         }
436
437         void set_default_isdcf_metadata (ISDCFMetadata d) {
438                 maybe_set (_default_isdcf_metadata, d);
439         }
440
441         void set_language (std::string l) {
442                 if (_language && _language.get() == l) {
443                         return;
444                 }
445                 _language = l;
446                 changed ();
447         }
448
449         void unset_language () {
450                 if (!_language) {
451                         return;
452                 }
453
454                 _language = boost::none;
455                 changed ();
456         }
457
458         void set_default_still_length (int s) {
459                 maybe_set (_default_still_length, s);
460         }
461
462         void set_default_container (Ratio const * c) {
463                 maybe_set (_default_container, c);
464         }
465
466         void set_default_scale_to (Ratio const * c) {
467                 maybe_set (_default_scale_to, c);
468         }
469
470         void set_default_dcp_content_type (DCPContentType const * t) {
471                 maybe_set (_default_dcp_content_type, t);
472         }
473
474         void set_default_dcp_audio_channels (int c) {
475                 maybe_set (_default_dcp_audio_channels, c);
476         }
477
478         void set_dcp_issuer (std::string i) {
479                 maybe_set (_dcp_issuer, i);
480         }
481
482         void set_dcp_creator (std::string c) {
483                 maybe_set (_dcp_creator, c);
484         }
485
486         void set_default_j2k_bandwidth (int b) {
487                 maybe_set (_default_j2k_bandwidth, b);
488         }
489
490         void set_default_audio_delay (int d) {
491                 maybe_set (_default_audio_delay, d);
492         }
493
494         void set_default_interop (bool i) {
495                 maybe_set (_default_interop, i);
496         }
497
498         void set_default_upload_after_make_dcp (bool u) {
499                 maybe_set (_default_upload_after_make_dcp, u);
500         }
501
502         void set_mail_server (std::string s) {
503                 maybe_set (_mail_server, s);
504         }
505
506         void set_mail_port (int p) {
507                 maybe_set (_mail_port, p);
508         }
509
510         void set_mail_user (std::string u) {
511                 maybe_set (_mail_user, u);
512         }
513
514         void set_mail_password (std::string p) {
515                 maybe_set (_mail_password, p);
516         }
517
518         void set_kdm_subject (std::string s) {
519                 maybe_set (_kdm_subject, s);
520         }
521
522         void set_kdm_from (std::string f) {
523                 maybe_set (_kdm_from, f);
524         }
525
526         void set_kdm_cc (std::vector<std::string> f) {
527                 maybe_set (_kdm_cc, f);
528         }
529
530         void set_kdm_bcc (std::string f) {
531                 maybe_set (_kdm_bcc, f);
532         }
533
534         void set_kdm_email (std::string e) {
535                 maybe_set (_kdm_email, e);
536         }
537
538         void reset_kdm_email ();
539
540         void set_signer_chain (boost::shared_ptr<const dcp::CertificateChain> s) {
541                 maybe_set (_signer_chain, s);
542         }
543
544         void set_decryption_chain (boost::shared_ptr<const dcp::CertificateChain> c) {
545                 maybe_set (_decryption_chain, c);
546         }
547
548         void set_check_for_updates (bool c) {
549                 maybe_set (_check_for_updates, c);
550                 if (!c) {
551                         set_check_for_test_updates (false);
552                 }
553         }
554
555         void set_check_for_test_updates (bool c) {
556                 maybe_set (_check_for_test_updates, c);
557         }
558
559         void set_maximum_j2k_bandwidth (int b) {
560                 maybe_set (_maximum_j2k_bandwidth, b);
561         }
562
563         void set_log_types (int t) {
564                 maybe_set (_log_types, t);
565         }
566
567         void set_analyse_ebur128 (bool a) {
568                 maybe_set (_analyse_ebur128, a);
569         }
570
571         void set_automatic_audio_analysis (bool a) {
572                 maybe_set (_automatic_audio_analysis, a);
573         }
574
575 #ifdef DCPOMATIC_WINDOWS
576         void set_win32_console (bool c) {
577                 maybe_set (_win32_console, c);
578         }
579 #endif
580
581         void set_dkdms (boost::shared_ptr<DKDMGroup> dkdms) {
582                 _dkdms = dkdms;
583                 changed ();
584         }
585
586         void set_cinemas_file (boost::filesystem::path file);
587
588         void set_show_hints_before_make_dcp (bool s) {
589                 maybe_set (_show_hints_before_make_dcp, s);
590         }
591
592         void set_confirm_kdm_email (bool s) {
593                 maybe_set (_confirm_kdm_email, s);
594         }
595
596         void set_sound (bool s) {
597                 maybe_set (_sound, s, SOUND);
598         }
599
600         void set_sound_output (std::string o) {
601                 maybe_set (_sound_output, o, SOUND_OUTPUT);
602         }
603
604         void set_last_player_load_directory (boost::filesystem::path d) {
605                 maybe_set (_last_player_load_directory, d);
606         }
607
608         void set_last_kdm_write_type (KDMWriteType t) {
609                 maybe_set (_last_kdm_write_type, t);
610         }
611
612         void unset_sound_output () {
613                 if (!_sound_output) {
614                         return;
615                 }
616
617                 _sound_output = boost::none;
618                 changed ();
619         }
620
621         void set_kdm_container_name_format (dcp::NameFormat n) {
622                 maybe_set (_kdm_container_name_format, n);
623         }
624
625         void set_kdm_filename_format (dcp::NameFormat n) {
626                 maybe_set (_kdm_filename_format, n);
627         }
628
629         void set_dcp_metadata_filename_format (dcp::NameFormat n) {
630                 maybe_set (_dcp_metadata_filename_format, n);
631         }
632
633         void set_dcp_asset_filename_format (dcp::NameFormat n) {
634                 maybe_set (_dcp_asset_filename_format, n);
635         }
636
637         void set_frames_in_memory_multiplier (int m) {
638                 maybe_set (_frames_in_memory_multiplier, m);
639         }
640
641         void clear_history () {
642                 _history.clear ();
643                 changed ();
644         }
645
646         void clear_player_history () {
647                 _player_history.clear ();
648                 changed ();
649         }
650
651         void add_to_history (boost::filesystem::path p);
652         void add_to_player_history (boost::filesystem::path p);
653
654         void set_jump_to_selected (bool j) {
655                 maybe_set (_jump_to_selected, j);
656         }
657
658         void set_nagged (Nag nag, bool nagged) {
659                 maybe_set (_nagged[nag], nagged);
660         }
661
662         void set_cover_sheet (std::string s) {
663                 maybe_set (_cover_sheet, s);
664         }
665
666         void reset_cover_sheet ();
667
668         void changed (Property p = OTHER);
669         boost::signals2::signal<void (Property)> Changed;
670         /** Emitted if read() failed on an existing Config file.  There is nothing
671             a listener can do about it: this is just for information.
672         */
673         static boost::signals2::signal<void ()> FailedToLoad;
674         /** Emitted if read() issued a warning which the user might want to know about */
675         static boost::signals2::signal<void (std::string)> Warning;
676
677         void write () const;
678         void write_config () const;
679         void write_cinemas () const;
680         void link (boost::filesystem::path new_file) const;
681         void copy_and_link (boost::filesystem::path new_file) const;
682
683         void save_template (boost::shared_ptr<const Film> film, std::string name) const;
684         bool existing_template (std::string name) const;
685         std::list<std::string> templates () const;
686         boost::filesystem::path template_path (std::string name) const;
687         void rename_template (std::string old_name, std::string new_name) const;
688         void delete_template (std::string name) const;
689
690         static Config* instance ();
691         static void drop ();
692         static void restore_defaults ();
693         static bool have_existing (std::string);
694         static boost::filesystem::path config_file ();
695
696         static boost::optional<boost::filesystem::path> test_path;
697
698 private:
699         Config ();
700         static boost::filesystem::path path (std::string file, bool create_directories = true);
701         void read ();
702         void set_defaults ();
703         void set_kdm_email_to_default ();
704         void set_cover_sheet_to_default ();
705         void read_cinemas (cxml::Document const & f);
706         boost::shared_ptr<dcp::CertificateChain> create_certificate_chain ();
707         boost::filesystem::path directory_or (boost::optional<boost::filesystem::path> dir, boost::filesystem::path a) const;
708         void add_to_history_internal (std::vector<boost::filesystem::path>& h, boost::filesystem::path p);
709
710         template <class T>
711         void maybe_set (T& member, T new_value, Property prop = OTHER) {
712                 if (member == new_value) {
713                         return;
714                 }
715                 member = new_value;
716                 changed (prop);
717         }
718
719         template <class T>
720         void maybe_set (boost::optional<T>& member, T new_value, Property prop = OTHER) {
721                 if (member && member.get() == new_value) {
722                         return;
723                 }
724                 member = new_value;
725                 changed (prop);
726         }
727
728         /** number of threads which a master DoM should use for J2K encoding on the local machine */
729         int _master_encoding_threads;
730         /** number of threads which a server should use for J2K encoding on the local machine */
731         int _server_encoding_threads;
732         /** default directory to put new films in */
733         boost::optional<boost::filesystem::path> _default_directory;
734         /** base port number to use for J2K encoding servers;
735          *  this port and the two above it will be used.
736          */
737         int _server_port_base;
738         /** true to broadcast on the `any' address to look for servers */
739         bool _use_any_servers;
740         /** J2K encoding servers that should definitely be used */
741         std::vector<std::string> _servers;
742         bool _only_servers_encode;
743         Protocol _tms_protocol;
744         /** The IP address of a TMS that we can copy DCPs to */
745         std::string _tms_ip;
746         /** The path on a TMS that we should write DCPs to */
747         std::string _tms_path;
748         /** User name to log into the TMS with */
749         std::string _tms_user;
750         /** Password to log into the TMS with */
751         std::string _tms_password;
752         /** Our cinema sound processor */
753         CinemaSoundProcessor const * _cinema_sound_processor;
754         std::list<int> _allowed_dcp_frame_rates;
755         /** Allow any video frame rate for the DCP; if true, overrides _allowed_dcp_frame_rates */
756         bool _allow_any_dcp_frame_rate;
757         /** Default ISDCF metadata for newly-created Films */
758         ISDCFMetadata _default_isdcf_metadata;
759         boost::optional<std::string> _language;
760         /** Default length of still image content (seconds) */
761         int _default_still_length;
762         Ratio const * _default_container;
763         Ratio const * _default_scale_to;
764         DCPContentType const * _default_dcp_content_type;
765         int _default_dcp_audio_channels;
766         std::string _dcp_issuer;
767         std::string _dcp_creator;
768         int _default_j2k_bandwidth;
769         int _default_audio_delay;
770         bool _default_interop;
771         /** Default directory to offer to write KDMs to; if it's not set,
772             the home directory will be offered.
773         */
774         boost::optional<boost::filesystem::path> _default_kdm_directory;
775         bool _default_upload_after_make_dcp;
776         std::list<boost::shared_ptr<Cinema> > _cinemas;
777         std::string _mail_server;
778         int _mail_port;
779         std::string _mail_user;
780         std::string _mail_password;
781         std::string _kdm_subject;
782         std::string _kdm_from;
783         std::vector<std::string> _kdm_cc;
784         std::string _kdm_bcc;
785         std::string _kdm_email;
786         boost::shared_ptr<const dcp::CertificateChain> _signer_chain;
787         /** Chain used to decrypt KDMs; the leaf of this chain is the target
788          *  certificate for making KDMs given to DCP-o-matic.
789          */
790         boost::shared_ptr<const dcp::CertificateChain> _decryption_chain;
791         /** true to check for updates on startup */
792         bool _check_for_updates;
793         bool _check_for_test_updates;
794         /** maximum allowed J2K bandwidth in bits per second */
795         int _maximum_j2k_bandwidth;
796         int _log_types;
797         bool _analyse_ebur128;
798         bool _automatic_audio_analysis;
799 #ifdef DCPOMATIC_WINDOWS
800         bool _win32_console;
801 #endif
802         std::vector<boost::filesystem::path> _history;
803         std::vector<boost::filesystem::path> _player_history;
804         boost::shared_ptr<DKDMGroup> _dkdms;
805         boost::filesystem::path _cinemas_file;
806         bool _show_hints_before_make_dcp;
807         bool _confirm_kdm_email;
808         dcp::NameFormat _kdm_filename_format;
809         dcp::NameFormat _kdm_container_name_format;
810         dcp::NameFormat _dcp_metadata_filename_format;
811         dcp::NameFormat _dcp_asset_filename_format;
812         bool _jump_to_selected;
813         bool _nagged[NAG_COUNT];
814         bool _sound;
815         /** name of a specific sound output stream to use, or empty to use the default */
816         boost::optional<std::string> _sound_output;
817         std::string _cover_sheet;
818         boost::optional<boost::filesystem::path> _last_player_load_directory;
819         boost::optional<KDMWriteType> _last_kdm_write_type;
820         int _frames_in_memory_multiplier;
821
822         /** Singleton instance, or 0 */
823         static Config* _instance;
824 };
825
826 #endif