2 Copyright (C) 2001 Paul Davis
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25 #include "ardour/debug.h"
26 #include "ardour/session.h"
28 #ifndef NDEBUG // "-H"
29 #include "processor_box.h"
38 string ARDOUR_COMMAND_LINE::session_name = "";
39 string ARDOUR_COMMAND_LINE::backend_client_name = "ardour";
40 string ARDOUR_COMMAND_LINE::backend_session_uuid;
41 bool ARDOUR_COMMAND_LINE::show_key_actions = false;
42 bool ARDOUR_COMMAND_LINE::no_splash = false;
43 bool ARDOUR_COMMAND_LINE::just_version = false;
44 bool ARDOUR_COMMAND_LINE::use_vst = true;
45 bool ARDOUR_COMMAND_LINE::new_session = false;
46 char* ARDOUR_COMMAND_LINE::curvetest_file = 0;
47 bool ARDOUR_COMMAND_LINE::try_hw_optimization = true;
48 bool ARDOUR_COMMAND_LINE::no_connect_ports = false;
49 string ARDOUR_COMMAND_LINE::keybindings_path = ""; /* empty means use builtin default */
50 std::string ARDOUR_COMMAND_LINE::menus_file = "ardour.menus";
51 bool ARDOUR_COMMAND_LINE::finder_invoked_ardour = false;
52 string ARDOUR_COMMAND_LINE::immediate_save;
53 string ARDOUR_COMMAND_LINE::load_template;
54 bool ARDOUR_COMMAND_LINE::check_announcements = true;
56 using namespace ARDOUR_COMMAND_LINE;
59 print_help (const char *execname)
61 // help2man format, http://docopt.org/
62 // https://www.gnu.org/prep/standards/standards.html#g_t_002d_002dhelp
64 << _("Usage: ") << PROGRAM_NAME << _(" [ OPTIONS ] [ SESSION-NAME ]")
66 << _("Ardour is a multichannel hard disk recorder (HDR) and digital audio workstation (DAW).")
69 << _(" -a, --no-announcements Do not contact website for announcements\n")
70 << _(" -b, --bindings Print all possible keyboard binding names\n")
71 << _(" -B, --bypass-plugins Bypass all plugins in an existing session\n")
72 << _(" -c, --name <name> Use a specific backend client name, default is ardour\n")
74 << _(" -C, --curvetest filename Curve algorithm debugger\n")
76 << _(" -d, --disable-plugins Disable all plugins (safe mode)\n")
78 << _(" -D, --debug <options> Set debug flags. Use \"-D list\" to see available options\n")
80 << _(" -E, --save <file> Load the specified session, save it to <file> and then quit\n")
81 << _(" -h, --help Print this message\n")
82 << _(" -k, --keybindings <file> Name of key bindings to load\n")
83 << _(" -m, --menus file Use \"file\" to define menus\n")
84 << _(" -n, --no-splash Do not show splash screen\n")
85 << _(" -N, --new session-name Create a new session from the command line\n")
86 << _(" -O, --no-hw-optimizations Disable h/w specific optimizations\n")
87 << _(" -P, --no-connect-ports Do not connect any ports at startup\n")
88 << _(" -S, --sync Draw the GUI synchronously\n")
89 << _(" -T, --template <name> Draw the GUI synchronously\n")
90 << _(" -U, --uuid <uuid> Set (jack) backend UUID\n")
91 << _(" -v, --version Use session template\n")
92 #ifdef WINDOWS_VST_SUPPORT
93 << _(" -V, --novst Disable WindowsVST support\n")
96 << _("Report bugs to http://tracker.ardour.org\n")
97 << _("Website http://ardour.org\n")
104 ARDOUR_COMMAND_LINE::parse_opts (int argc, char *argv[])
106 const char *optstring = "abBc:C:dD:hHk:E:m:N:nOp:PST:U:vV";
107 const char *execname = strrchr (argv[0], '/');
115 const struct option longopts[] = {
116 { "version", 0, 0, 'v' },
117 { "help", 0, 0, 'h' },
118 { "no-announcements", 0, 0, 'a' },
119 { "bindings", 0, 0, 'b' },
120 { "bypass-plugins", 0, 0, 'B' },
121 { "disable-plugins", 0, 0, 'd' },
122 { "debug", 1, 0, 'D' },
123 { "no-splash", 0, 0, 'n' },
124 { "menus", 1, 0, 'm' },
125 { "name", 1, 0, 'c' },
126 { "novst", 0, 0, 'V' },
127 { "new", 1, 0, 'N' },
128 { "no-hw-optimizations", 0, 0, 'O' },
129 { "sync", 0, 0, 'S' },
130 { "curvetest", 1, 0, 'C' },
131 { "save", 1, 0, 'E' },
132 { "uuid", 1, 0, 'U' },
133 { "template", 1, 0, 'T' },
134 { "no-connect-ports", 0, 0, 'P' },
138 int option_index = 0;
142 c = getopt_long (argc, argv, optstring, longopts, &option_index);
157 print_help (execname);
162 ProcessorBox::show_all_processors = true;
166 check_announcements = false;
170 show_key_actions = true;
174 ARDOUR::Session::set_bypass_all_loaded_plugins (true);
178 ARDOUR::Session::set_disable_all_loaded_plugins (true);
182 if (PBD::parse_debug_options (optarg)) {
196 //undocumented OS X finder -psn_XXXXX argument
197 finder_invoked_ardour = true;
201 // ; just pass this through to gtk it will figure it out
204 load_template = optarg;
209 session_name = optarg;
213 try_hw_optimization = false;
217 no_connect_ports = true;
221 #ifdef WINDOWS_VST_SUPPORT
223 #endif /* WINDOWS_VST_SUPPORT */
227 backend_client_name = optarg;
231 curvetest_file = optarg;
235 keybindings_path = optarg;
239 immediate_save = optarg;
243 backend_session_uuid = optarg;
247 return print_help(execname);
253 cerr << "Illogical combination: you can either create a new session, or a load an existing session but not both!" << endl;
254 return print_help(execname);
256 session_name = argv[optind++];