1 /*****************************************************************************
2 * libvlc.h: main libvlc header
3 *****************************************************************************
4 * Copyright (C) 1998-2002 VideoLAN
7 * Authors: Vincent Seguin <seguin@via.ecp.fr>
8 * Samuel Hocevar <sam@zoy.org>
9 * Gildas Bazin <gbazin@netcourrier.com>
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, write to the Free Software
23 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
24 *****************************************************************************/
26 #define Nothing here, this is just to prevent update-po from being stupid
29 static char *ppsz_language[] =
30 { "auto", "en", "en_GB", "es", "de",
31 "fr", "hu", "it", "ja", "nl", "no",
32 "pl", "pt_BR", "ru", "sv" };
33 static char *ppsz_language_text[] =
34 { N_("Auto"), N_("American"), N_("British"), N_("Spanish"), N_("German"),
35 N_("French"), N_("Hungarian"), N_("Italian"), N_("Japanese"), N_("Dutch"),
36 N_("Norwegian"), N_("Polish"), N_("Brazilian"), N_("Russian"),
39 /*****************************************************************************
40 * Configuration options for the main program. Each module will also separatly
41 * define its own configuration options.
42 * Look into configuration.h if you need to know more about the following
44 *****************************************************************************/
46 #define INTF_CAT_LONGTEXT N_( \
47 "These options allow you to configure the interfaces used by VLC.\n" \
48 "You can select the main interface, additional " \
49 "interface modules, and define various related options." )
51 #define INTF_TEXT N_("Interface module")
52 #define INTF_LONGTEXT N_( \
53 "This option allows you to select the interface used by VLC.\n" \
54 "The default behavior is to automatically select the best module " \
57 #define EXTRAINTF_TEXT N_("Extra interface modules")
58 #define EXTRAINTF_LONGTEXT N_( \
59 "This option allows you to select additional interfaces used by VLC. " \
60 "They will be launched in the background in addition to the default " \
61 "interface. Use a comma separated list of interface modules. (common " \
62 "values are: logger,gestures,sap,rc,http,screensaver)")
64 #define VERBOSE_TEXT N_("Verbosity (0,1,2)")
65 #define VERBOSE_LONGTEXT N_( \
66 "This options sets the verbosity level (0=only errors and " \
67 "standard messages, 1=warnings, 2=debug).")
69 #define QUIET_TEXT N_("Be quiet")
70 #define QUIET_LONGTEXT N_( \
71 "This options turns off all warning and information messages.")
73 #define LANGUAGE_TEXT N_("Language")
74 #define LANGUAGE_LONGTEXT N_( "This option allows you to set the language " \
75 "of the interface. The system language is auto-detected if \"auto\" is " \
78 #define COLOR_TEXT N_("Color messages")
79 #define COLOR_LONGTEXT N_( \
80 "When this option is turned on, the messages sent to the console will " \
81 "be colorized. Your terminal needs Linux color support for this to work.")
83 #define ADVANCED_TEXT N_("Show advanced options")
84 #define ADVANCED_LONGTEXT N_( \
85 "When this option is turned on, the preferences and/or interfaces will " \
86 "show all the available options, including those that most users should " \
89 #define INTF_PATH_TEXT N_("Interface default search path")
90 #define INTF_PATH_LONGTEXT N_( \
91 "This option allows you to set the default path that the interface will " \
92 "open when looking for a file.")
94 #define PLUGIN_PATH_TEXT N_("Modules search path")
95 #define PLUGIN_PATH_LONGTEXT N_( \
96 "This option allows you to specify an additional path for VLC to look " \
99 #define AOUT_CAT_LONGTEXT N_( \
100 "These options allow you to modify the behaviour of the audio " \
101 "subsystem, and to add audio filters which can be used for " \
102 "postprocessing or visual effects (spectrum analyzer, ...).\n" \
103 "Enable these filters here, and configure them in the \"audio filters\" " \
106 #define AOUT_TEXT N_("Audio output module")
107 #define AOUT_LONGTEXT N_( \
108 "This option allows you to select the audio output method used by VLC. " \
109 "The default behavior is to automatically select the best method " \
112 #define AUDIO_TEXT N_("Enable audio")
113 #define AUDIO_LONGTEXT N_( \
114 "You can completely disable the audio output. In this case, the audio " \
115 "decoding stage will not take place, thus saving some processing power.")
117 #define MONO_TEXT N_("Force mono audio")
118 #define MONO_LONGTEXT N_("This will force a mono audio output.")
120 #define VOLUME_TEXT N_("Audio output volume")
121 #define VOLUME_LONGTEXT N_( \
122 "You can set the default audio output volume here, in a range from 0 to " \
125 #define VOLUME_SAVE_TEXT N_("Audio output saved volume")
126 #define VOLUME_SAVE_LONGTEXT N_( \
127 "This saves the audio output volume when you select mute.")
129 #define AOUT_RATE_TEXT N_("Audio output frequency (Hz)")
130 #define AOUT_RATE_LONGTEXT N_( \
131 "You can force the audio output frequency here. Common values are " \
132 "-1 (default), 48000, 44100, 32000, 22050, 16000, 11025, 8000.")
134 #if !defined( SYS_DARWIN )
135 #define AOUT_RESAMP_TEXT N_("High quality audio resampling")
136 #define AOUT_RESAMP_LONGTEXT N_( \
137 "This uses a high quality audio resampling algorithm. High quality "\
138 "audio resampling can be processor intensive so you can " \
139 "disable it and a cheaper resampling algorithm will be used instead.")
142 #define DESYNC_TEXT N_("Audio desynchronization compensation")
143 #define DESYNC_LONGTEXT N_( \
144 "This option allows you to delay the audio output. You must give a " \
145 "number of milliseconds. This can be handy if you notice a lag " \
146 "between the video and the audio.")
148 #define MULTICHA_TEXT N_("Preferred audio output channels mode")
149 #define MULTICHA_LONGTEXT N_( \
150 "This option allows you to set the audio output channels mode that will " \
151 "be used by default when possible (ie. if your hardware supports it as " \
152 "well as the audio stream being played).")
154 #define SPDIF_TEXT N_("Use the S/PDIF audio output when available")
155 #define SPDIF_LONGTEXT N_( \
156 "This option allows you to use the S/PDIF audio output by default when " \
157 "your hardware supports it as well as the audio stream being played.")
159 #define AUDIO_FILTER_TEXT N_("Audio filters")
160 #define AUDIO_FILTER_LONGTEXT N_( \
161 "This allows you to add audio postprocessing filters, to modify " \
162 "the sound, or audio visualization modules (spectrum analyzer, ...).")
164 #define AUDIO_CHANNEL_MIXER N_("Channel mixer")
165 #define AUDIO_CHANNEL_MIXER_LONGTEXT N_( \
166 "This allows you to choose a specific audio channel mixer. For " \
167 "instance, you can use the \"headphone\" mixer that gives 5.1 feeling " \
170 #define VOUT_CAT_LONGTEXT N_( \
171 "These options allow you to modify the behaviour of the video output " \
172 "subsytem. You can for example enable video filters (deinterlacing, " \
173 "image adjusting, ...). Enable these filters here and configure " \
174 "them in the \"video filters\" modules section. You can also set many " \
175 "miscellaneous video options." )
177 #define VOUT_TEXT N_("Video output module")
178 #define VOUT_LONGTEXT N_( \
179 "This option allows you to select the video output method used by VLC. " \
180 "The default behavior is to automatically select the best " \
183 #define VIDEO_TEXT N_("Enable video")
184 #define VIDEO_LONGTEXT N_( \
185 "You can completely disable the video output. In this case, the video " \
186 "decoding stage will not take place, thus saving some processing power.")
188 #define WIDTH_TEXT N_("Video width")
189 #define WIDTH_LONGTEXT N_( \
190 "You can enforce the video width here. By default (-1) VLC will " \
191 "adapt to the video characteristics.")
193 #define HEIGHT_TEXT N_("Video height")
194 #define HEIGHT_LONGTEXT N_( \
195 "You can enforce the video height here. By default (-1) VLC will " \
196 "adapt to the video characteristics.")
198 #define ALIGN_TEXT N_("Video alignment")
199 #define ALIGN_LONGTEXT N_( \
200 "You can enforce the video alignement in its window. By default (0) it " \
201 "will be centered (0=center, 1=left, 2=right, 4=top, 8=bottom, you can " \
202 "also use combinations of these values).")
203 static int pi_align_values[] = { 0, 1, 2, 4, 8, 5, 6, 9, 10 };
204 static char *ppsz_align_descriptions[] =
205 { N_("Center"), N_("Left"), N_("Right"), N_("Top"), N_("Bottom"),
206 N_("Top-Left"), N_("Top-Right"), N_("Bottom-Left"), N_("Bottom-Right") };
208 #define ZOOM_TEXT N_("Zoom video")
209 #define ZOOM_LONGTEXT N_( \
210 "You can zoom the video by the specified factor.")
212 #define GRAYSCALE_TEXT N_("Grayscale video output")
213 #define GRAYSCALE_LONGTEXT N_( \
214 "When enabled, the color information from the video won't be decoded " \
215 "(this can also allow you to save some processing power).")
217 #define FULLSCREEN_TEXT N_("Fullscreen video output")
218 #define FULLSCREEN_LONGTEXT N_( \
219 "If this option is enabled, VLC will always start a video in fullscreen " \
222 #define OVERLAY_TEXT N_("Overlay video output")
223 #define OVERLAY_LONGTEXT N_( \
224 "If enabled, VLC will try to take advantage of the overlay capabilities " \
225 "of your graphics card (hardware acceleration).")
227 #define VIDEO_ON_TOP_TEXT N_("Always on top")
228 #define VIDEO_ON_TOP_LONGTEXT N_("Always place the video window on top of " \
231 #define SPUMARGIN_TEXT N_("Force SPU position")
232 #define SPUMARGIN_LONGTEXT N_( \
233 "You can use this option to place the subtitles under the movie, " \
234 "instead of over the movie. Try several positions.")
236 #define OSD_TEXT N_("On Screen Display")
237 #define OSD_LONGTEXT N_( \
238 "VLC can display messages on the video. This is called OSD (On Screen " \
239 "Display). You can disable this feature here.")
241 #define FILTER_TEXT N_("Video filter module")
242 #define FILTER_LONGTEXT N_( \
243 "This will allow you to add a post-processing filter to enhance the " \
244 "picture quality, for instance deinterlacing, or to clone or distort " \
247 #define ASPECT_RATIO_TEXT N_("Source aspect ratio")
248 #define ASPECT_RATIO_LONGTEXT N_( \
249 "This will force the source aspect ratio. For instance, some DVDs claim " \
250 "to be 16:9 while they are actually 4:3. This can also be used as a " \
251 "hint for VLC when a movie does not have aspect ratio information. " \
252 "Accepted formats are x:y (4:3, 16:9, etc.) expressing the global image " \
253 "aspect, or a float value (1.25, 1.3333, etc.) expressing pixel " \
256 #define INPUT_CAT_LONGTEXT N_( \
257 "These options allow you to modify the behaviour of the input " \
258 "subsystem, such as the DVD or VCD device, the network interface " \
259 "settings or the subtitle channel.")
261 #define CR_AVERAGE_TEXT N_("Clock reference average counter")
262 #define CR_AVERAGE_LONGTEXT N_( \
263 "When using the PVR input (or a very irregular source), you should " \
264 "set this to 10000.")
266 #define SERVER_PORT_TEXT N_("Server port")
267 #define SERVER_PORT_LONGTEXT N_( \
268 "This is the port used for UDP streams. By default, we chose 1234.")
270 #define MTU_TEXT N_("MTU of the network interface")
271 #define MTU_LONGTEXT N_( \
272 "This is the typical size of UDP packets that we expect. On Ethernet " \
273 "it is usually 1500.")
275 #define IFACE_ADDR_TEXT N_("Network interface address")
276 #define IFACE_ADDR_LONGTEXT N_( \
277 "If you have several interfaces on your machine and use the " \
278 "multicast solution, you will probably have to indicate the IP address " \
279 "of your multicasting interface here.")
281 #define TTL_TEXT N_("Time to live")
282 #define TTL_LONGTEXT N_( \
283 "Indicate here the Time To Live of the multicast packets sent by " \
284 "the stream output.")
286 #define INPUT_PROGRAM_TEXT N_("Choose program (SID)")
287 #define INPUT_PROGRAM_LONGTEXT N_( \
288 "Choose the program to select by giving its Service ID.")
290 #define INPUT_AUDIO_TEXT N_("Choose audio")
291 #define INPUT_AUDIO_LONGTEXT N_( \
292 "Give the default type of audio you want to use in a DVD. " \
295 #define INPUT_CHAN_TEXT N_("Choose audio channel")
296 #define INPUT_CHAN_LONGTEXT N_( \
297 "Give the stream number of the audio channel you want to use in a DVD " \
300 #define INPUT_SUBT_TEXT N_("Choose subtitle track")
301 #define INPUT_SUBT_LONGTEXT N_( \
302 "Give the stream number of the subtitle channel you want to use " \
305 #define INPUT_REPEAT_TEXT N_("Number of time the same input will be repeated")
306 #define INPUT_REPEAT_LONGTEXT N_("Number of time the same input will be repeated")
308 #define START_TIME_TEXT N_("Input start time (second)")
309 #define START_TIME_LONGTEXT N_("Input start time (second)")
311 #define STOP_TIME_TEXT N_("Input stop time (second)")
312 #define STOP_TIME_LONGTEXT N_("Input stop time (second)")
314 #define SUB_AUTO_TEXT N_("Autodetect subtitle files")
315 #define SUB_AUTO_LONGTEXT \
316 N_("Automatically detect a subtitle file, if no subtitle filename is " \
319 #define SUB_FUZZY_TEXT N_("Subtitle autodection fuzziness")
320 #define SUB_FUZZY_LONGTEXT \
321 N_("This determines how fuzzy subtitle and movie filenaming matching " \
322 "will be. Options are:\n" \
323 "0 = no subtitles autodetected\n" \
324 "1 = any subtitle file\n" \
325 "2 = any subtitle file containing the movie name\n" \
326 "3 = subtitle file matching the movie name with additional chars\n" \
327 "4 = subtitle file matching the movie name exactly")
329 #define SUB_FILE_TEXT N_("Use subtitle file")
330 #define SUB_FILE_LONGTEXT \
331 N_("Load this subtitle file. To be used when autodetect cannot detect " \
332 "your subtitle file.")
334 #define DVD_DEV_TEXT N_("DVD device")
336 #define DVD_DEV_LONGTEXT N_( \
337 "This is the default DVD drive (or file) to use. Don't forget the colon " \
338 "after the drive letter (eg D:)")
340 #define DVD_DEV_LONGTEXT N_( \
341 "This is the default DVD device to use.")
344 #define VCD_DEV_TEXT N_("VCD device")
346 #define VCD_DEV_LONGTEXT N_( \
347 "This is the default VCD device to use. " \
348 "If you don't specify anything, we'll scan for a suitable CD-ROM device." )
350 #define VCD_DEV_LONGTEXT N_( \
351 "This is the default VCD device to use." )
354 #define CDAUDIO_DEV_TEXT N_("Audio CD device")
356 #define CDAUDIO_DEV_LONGTEXT N_( \
357 "This is the default Audio CD device to use. " \
358 "If you don't specify anything, we'll scan for a suitable CD-ROM device." )
360 #define CDAUDIO_DEV_LONGTEXT N_( \
361 "This is the default Audio CD device to use." )
364 #define IPV6_TEXT N_("Force IPv6")
365 #define IPV6_LONGTEXT N_( \
366 "If you check this box, IPv6 will be used by default for all UDP and " \
369 #define IPV4_TEXT N_("Force IPv4")
370 #define IPV4_LONGTEXT N_( \
371 "If you check this box, IPv4 will be used by default for all UDP and " \
374 #define META_TITLE_TEXT N_("Title metadata")
375 #define META_TITLE_LONGTEXT N_( \
376 "Allows you to specify a \"title\" metadata for an input.")
378 #define META_AUTHOR_TEXT N_("Author metadata")
379 #define META_AUTHOR_LONGTEXT N_( \
380 "Allows you to specify an \"author\" metadata for an input.")
382 #define META_ARTIST_TEXT N_("Artist metadata")
383 #define META_ARTIST_LONGTEXT N_( \
384 "Allows you to specify an \"artist\" metadata for an input.")
386 #define META_GENRE_TEXT N_("Genre metadata")
387 #define META_GENRE_LONGTEXT N_( \
388 "Allows you to specify a \"genre\" metadata for an input.")
390 #define META_CPYR_TEXT N_("Copyright metadata")
391 #define META_CPYR_LONGTEXT N_( \
392 "Allows you to specify a \"copyright\" metadata for an input.")
394 #define META_DESCR_TEXT N_("Description metadata")
395 #define META_DESCR_LONGTEXT N_( \
396 "Allows you to specify a \"description\" metadata for an input.")
398 #define META_DATE_TEXT N_("Date metadata")
399 #define META_DATE_LONGTEXT N_( \
400 "Allows you to specify a \"date\" metadata for an input.")
402 #define META_URL_TEXT N_("URL metadata")
403 #define META_URL_LONGTEXT N_( \
404 "Allows you to specify a \"url\" metadata for an input.")
406 #define CODEC_CAT_LONGTEXT N_( \
407 "This option can be used to alter the way VLC selects " \
408 "its codecs (decompression methods). Only advanced users should " \
409 "alter this option as it can break playback of all your streams." )
411 #define CODEC_TEXT N_("Preferred codecs list")
412 #define CODEC_LONGTEXT N_( \
413 "This allows you to select a list of codecs that VLC will use in " \
414 "priority. For instance, 'dummy,a52' will try the dummy and a52 codecs " \
415 "before trying the other ones.")
417 #define ENCODER_TEXT N_("Preferred encoders list")
418 #define ENCODER_LONGTEXT N_( \
419 "This allows you to select a list of encoders that VLC will use in " \
422 #define SOUT_CAT_LONGTEXT N_( \
423 "These options allow you to set default global options for the " \
424 "stream output subsystem." )
426 #define SOUT_TEXT N_("Choose a stream output")
427 #define SOUT_LONGTEXT N_( \
428 "Empty if no stream output.")
430 #define SOUT_ALL_TEXT N_("Enable streaming of all ES")
431 #define SOUT_ALL_LONGTEXT N_( \
432 "This allows you to stream all ES (video, audio and subtitles)")
434 #define SOUT_DISPLAY_TEXT N_("Display while streaming")
435 #define SOUT_DISPLAY_LONGTEXT N_( \
436 "This allows you to play the stream while streaming it.")
438 #define SOUT_VIDEO_TEXT N_("Enable video stream output")
439 #define SOUT_VIDEO_LONGTEXT N_( \
440 "This allows you to choose if the video stream should be redirected to " \
441 "the stream output facility when this last one is enabled.")
443 #define SOUT_AUDIO_TEXT N_("Enable audio stream output")
444 #define SOUT_AUDIO_LONGTEXT N_( \
445 "This allows you to choose if the video stream should be redirected to " \
446 "the stream output facility when this last one is enabled.")
448 #define SOUT_KEEP_TEXT N_("Keep sout open" )
449 #define SOUT_KEEP_LONGTEXT N_( \
450 "This allows you to keep an unique sout instance across " \
451 "multiple playlist item (automatically insert gather stream_out " \
452 "if not specified)" )
454 #define PACKETIZER_TEXT N_("Preferred packetizer list")
455 #define PACKETIZER_LONGTEXT N_( \
456 "This allows you to select the order in which VLC will choose its " \
459 #define MUX_TEXT N_("Mux module")
460 #define MUX_LONGTEXT N_( \
461 "This is a legacy entry to let you configure mux modules")
463 #define ACCESS_OUTPUT_TEXT N_("Access output module")
464 #define ACCESS_OUTPUT_LONGTEXT N_( \
465 "This is a legacy entry to let you configure access output modules")
467 #define CPU_CAT_LONGTEXT N_( \
468 "These options allow you to enable special CPU optimizations.\n" \
469 "You should always leave all these enabled." )
471 #define MMX_TEXT N_("Enable CPU MMX support")
472 #define MMX_LONGTEXT N_( \
473 "If your processor supports the MMX instructions set, VLC can take " \
474 "advantage of them.")
476 #define THREE_DN_TEXT N_("Enable CPU 3D Now! support")
477 #define THREE_DN_LONGTEXT N_( \
478 "If your processor supports the 3D Now! instructions set, VLC can take " \
479 "advantage of them.")
481 #define MMXEXT_TEXT N_("Enable CPU MMX EXT support")
482 #define MMXEXT_LONGTEXT N_( \
483 "If your processor supports the MMX EXT instructions set, VLC can take " \
484 "advantage of them.")
486 #define SSE_TEXT N_("Enable CPU SSE support")
487 #define SSE_LONGTEXT N_( \
488 "If your processor supports the SSE instructions set, VLC can take " \
489 "advantage of them.")
491 #define SSE2_TEXT N_("Enable CPU SSE2 support")
492 #define SSE2_LONGTEXT N_( \
493 "If your processor supports the SSE2 instructions set, VLC can take " \
494 "advantage of them.")
496 #define ALTIVEC_TEXT N_("Enable CPU AltiVec support")
497 #define ALTIVEC_LONGTEXT N_( \
498 "If your processor supports the AltiVec instructions set, VLC can take " \
499 "advantage of them.")
501 #define PLAYLIST_CAT_LONGTEXT N_( \
502 "These options define the behavior of the playlist. Some " \
503 "of them can be overriden in the playlist dialog box." )
505 #define RANDOM_TEXT N_("Play files randomly forever")
506 #define RANDOM_LONGTEXT N_( \
507 "When selected, VLC will randomly play files in the playlist until " \
510 #define LOOP_TEXT N_("Loop playlist on end")
511 #define LOOP_LONGTEXT N_( \
512 "If you want VLC to keep playing the playlist indefinitely then enable " \
515 #define REPEAT_TEXT N_("Repeat the current item")
516 #define REPEAT_LONGTEXT N_( \
517 "When this is active, VLC will keep playing the current playlist item " \
518 "over and over again.")
520 #define MISC_CAT_LONGTEXT N_( \
521 "These options allow you to select default modules. Leave these " \
522 "alone unless you really know what you are doing." )
524 #define MEMCPY_TEXT N_("Memory copy module")
525 #define MEMCPY_LONGTEXT N_( \
526 "You can select which memory copy module you want to use. By default " \
527 "VLC will select the fastest one supported by your hardware.")
529 #define ACCESS_TEXT N_("Access module")
530 #define ACCESS_LONGTEXT N_( \
531 "This is a legacy entry to let you configure access modules.")
533 #define DEMUX_TEXT N_("Demux module")
534 #define DEMUX_LONGTEXT N_( \
535 "This is a legacy entry to let you configure demux modules.")
537 #define RT_PRIORITY_TEXT N_("Allow real-time priority")
538 #define RT_PRIORITY_LONGTEXT N_( \
539 "Running VLC in real-time priority will allow for much more precise " \
540 "scheduling and yield better, especially when streaming content. " \
541 "It can however lock up your whole machine, or make it very very " \
542 "slow. You should only activate this if you know what you're " \
545 #define RT_OFFSET_TEXT N_("Adjust VLC priority")
546 #define RT_OFFSET_LONGTEXT N_( \
547 "This option adds an offset (positive or negative) to VLC default " \
548 "priorities. You can use it to tune VLC priority against other " \
549 "programs, or against other VLC instances.")
551 #define MINIMIZE_THREADS_TXT N_("Minimize number of threads")
552 #define MINIMIZE_THREADS_LONGTXT N_( \
553 "This option minimizes the number of threads needed to run VLC")
555 #define ONEINSTANCE_TEXT N_("Allow only one running instance")
556 #define ONEINSTANCE_LONGTEXT N_( \
557 "Allowing only one running instance of VLC can sometimes be useful, " \
558 "for instance if you associated VLC with some media types and you " \
559 "don't want a new instance of VLC to be opened each time you " \
560 "double-click on a file in the explorer. This option will allow you " \
561 "to play the file with the already running instance or enqueue it.")
563 #define HPRIORITY_TEXT N_("Increase the priority of the process")
564 #define HPRIORITY_LONGTEXT N_( \
565 "Increasing the priority of the process will very likely improve your " \
566 "playing experience as it allows VLC not to be disturbed by other " \
567 "applications that could otherwise take too much processor time.\n" \
568 "However be advised that in certain circumstances (bugs) VLC could take " \
569 "all the processor time and render the whole system unresponsive which " \
570 "might require a reboot of your machine.")
572 #define FAST_MUTEX_TEXT N_("Fast mutex on NT/2K/XP (developers only)")
573 #define FAST_MUTEX_LONGTEXT N_( \
574 "On Windows NT/2K/XP we use a slow mutex implementation but which " \
575 "allows us to correctely implement condition variables. " \
576 "You can also use the faster Win9x implementation but you might " \
577 "experience problems with it.")
579 #define WIN9X_CV_TEXT N_("Condition variables implementation for Win9x " \
581 #define WIN9X_CV_LONGTEXT N_( \
582 "On Windows 9x/Me you can use a fast but incorrect condition variables " \
583 "implementation (more precisely there is a possibility for a race " \
584 "condition to happen). " \
585 "However it is possible to use slower alternatives which are more " \
587 "Currently you can choose between implementation 0 (which is the " \
588 "fastest but slightly incorrect), 1 (default) and 2.")
590 #define HOTKEY_CAT_LONGTEXT N_( "These settings are the global VLC key " \
591 "bindings, known as \"hotkeys\"." )
593 #define FULLSCREEN_KEY_TEXT N_("Fullscreen")
594 #define FULLSCREEN_KEY_LONGTEXT N_("Select the hotkey to use to swap fullscreen state.")
595 #define PLAY_PAUSE_KEY_TEXT N_("Play/Pause")
596 #define PLAY_PAUSE_KEY_LONGTEXT N_("Select the hotkey to use to swap paused state.")
597 #define PAUSE_KEY_TEXT N_("Pause only")
598 #define PAUSE_KEY_LONGTEXT N_("Select the hotkey to use to pause.")
599 #define PLAY_KEY_TEXT N_("Play only")
600 #define PLAY_KEY_LONGTEXT N_("Select the hotkey to use to play.")
601 #define FASTER_KEY_TEXT N_("Faster")
602 #define FASTER_KEY_LONGTEXT N_("Select the hotkey to use for fast forward playback.")
603 #define SLOWER_KEY_TEXT N_("Slower")
604 #define SLOWER_KEY_LONGTEXT N_("Select the hotkey to use for slow motion playback.")
605 #define NEXT_KEY_TEXT N_("Next")
606 #define NEXT_KEY_LONGTEXT N_("Select the hotkey to use to skip to the next item in the playlist.")
607 #define PREV_KEY_TEXT N_("Previous")
608 #define PREV_KEY_LONGTEXT N_("Select the hotkey to use to skip to the previous item in the playlist.")
609 #define STOP_KEY_TEXT N_("Stop")
610 #define STOP_KEY_LONGTEXT N_("Select the hotkey to stop the playback.")
611 #define POSITION_KEY_TEXT N_("Position")
612 #define POSITION_KEY_LONGTEXT N_("Select the hotkey to display the position.")
614 #define JB10SEC_KEY_TEXT N_("Jump 10 seconds backwards")
615 #define JB10SEC_KEY_LONGTEXT N_("Select the hotkey to jump 10 seconds backwards.")
617 #define JB1MIN_KEY_TEXT N_("Jump 1 minute backwards")
618 #define JB1MIN_KEY_LONGTEXT N_("Select the hotkey to jump 1 minute backwards.")
619 #define JB5MIN_KEY_TEXT N_("Jump 5 minutes backwards")
620 #define JB5MIN_KEY_LONGTEXT N_("Select the hotkey to jump 5 minutes backwards.")
621 #define JF10SEC_KEY_TEXT N_("Jump 10 seconds forward")
622 #define JF10SEC_KEY_LONGTEXT N_("Select the hotkey to jump 10 seconds forward.")
624 #define JF1MIN_KEY_TEXT N_("Jump 1 minute forward")
625 #define JF1MIN_KEY_LONGTEXT N_("Select the hotkey to jump 1 minute forward.")
627 #define JF5MIN_KEY_TEXT N_("Jump 5 minutes forward")
628 #define JF5MIN_KEY_LONGTEXT N_("Select the hotkey to jump 5 minutes forward.")
630 #define QUIT_KEY_TEXT N_("Quit")
631 #define QUIT_KEY_LONGTEXT N_("Select the hotkey to quit the application.")
632 #define NAV_UP_KEY_TEXT N_("Navigate up")
633 #define NAV_UP_KEY_LONGTEXT N_("Select the key to move the selector up in DVD menus.")
634 #define NAV_DOWN_KEY_TEXT N_("Navigate down")
635 #define NAV_DOWN_KEY_LONGTEXT N_("Select the key to move the selector down in DVD menus.")
636 #define NAV_LEFT_KEY_TEXT N_("Navigate left")
637 #define NAV_LEFT_KEY_LONGTEXT N_("Select the key to move the selector left in DVD menus.")
638 #define NAV_RIGHT_KEY_TEXT N_("Navigate right")
639 #define NAV_RIGHT_KEY_LONGTEXT N_("Select the key to move the selector right in dvd menus.")
640 #define NAV_ACTIVATE_KEY_TEXT N_("Activate")
641 #define NAV_ACTIVATE_KEY_LONGTEXT N_("Select the key to activate selected item in DVD menus.")
642 #define VOL_UP_KEY_TEXT N_("Volume up")
643 #define VOL_UP_KEY_LONGTEXT N_("Select the key to increase audio volume.")
644 #define VOL_DOWN_KEY_TEXT N_("Volume down")
645 #define VOL_DOWN_KEY_LONGTEXT N_("Select the key to decrease audio volume.")
646 #define VOL_MUTE_KEY_TEXT N_("Mute")
647 #define VOL_MUTE_KEY_LONGTEXT N_("Select the key to turn off audio volume.")
648 #define PLAY_BOOKMARK1_KEY_TEXT N_("Play playlist bookmark 1")
649 #define PLAY_BOOKMARK2_KEY_TEXT N_("Play playlist bookmark 2")
650 #define PLAY_BOOKMARK3_KEY_TEXT N_("Play playlist bookmark 3")
651 #define PLAY_BOOKMARK4_KEY_TEXT N_("Play playlist bookmark 4")
652 #define PLAY_BOOKMARK5_KEY_TEXT N_("Play playlist bookmark 5")
653 #define PLAY_BOOKMARK6_KEY_TEXT N_("Play playlist bookmark 6")
654 #define PLAY_BOOKMARK7_KEY_TEXT N_("Play playlist bookmark 7")
655 #define PLAY_BOOKMARK8_KEY_TEXT N_("Play playlist bookmark 8")
656 #define PLAY_BOOKMARK9_KEY_TEXT N_("Play playlist bookmark 9")
657 #define PLAY_BOOKMARK10_KEY_TEXT N_("Play playlist bookmark 10")
658 #define PLAY_BOOKMARK_KEY_LONGTEXT N_("Select the key to play this bookmark.")
659 #define SET_BOOKMARK1_KEY_TEXT N_("Set playlist bookmark 1")
660 #define SET_BOOKMARK2_KEY_TEXT N_("Set playlist bookmark 2")
661 #define SET_BOOKMARK3_KEY_TEXT N_("Set playlist bookmark 3")
662 #define SET_BOOKMARK4_KEY_TEXT N_("Set playlist bookmark 4")
663 #define SET_BOOKMARK5_KEY_TEXT N_("Set playlist bookmark 5")
664 #define SET_BOOKMARK6_KEY_TEXT N_("Set playlist bookmark 6")
665 #define SET_BOOKMARK7_KEY_TEXT N_("Set playlist bookmark 7")
666 #define SET_BOOKMARK8_KEY_TEXT N_("Set playlist bookmark 8")
667 #define SET_BOOKMARK9_KEY_TEXT N_("Set playlist bookmark 9")
668 #define SET_BOOKMARK10_KEY_TEXT N_("Set playlist bookmark 10")
669 #define SET_BOOKMARK_KEY_LONGTEXT N_("Select the key to set this playlist bookmark.")
671 #define PLAYLIST_USAGE N_("\nPlaylist items:" \
672 "\n *.mpg, *.vob plain MPEG-1/2 files" \
673 "\n [dvd://][device][@raw_device][@[title][,[chapter][,angle]]]" \
675 "\n [vcd://][device][@{S|T|E|P}[number]]" \
677 "\n [cdda://][device][@[T][track-number]]" \
678 "\n Audio CD device" \
679 "\n udpstream:[[<source address>]@[<bind address>][:<bind port>]]" \
680 "\n UDP stream sent by a streaming server" \
681 "\n vlc:pause pause execution of " \
683 "\n vlc:quit quit VLC" \
688 * Quick usage guide for the configuration options:
690 * add_category_hint( N_(text), N_(longtext), b_advanced_option );
691 * add_subcategory_hint( N_(text), N_(longtext), b_advanced_option );
692 * add_usage_hint( N_(text), b_advanced_option );
693 * add_string( option_name, value, p_callback, N_(text), N_(longtext),
695 * add_file( option_name, psz_value, p_callback, N_(text), N_(longtext) );
696 * add_module( option_name, psz_value, i_capability, p_callback,
697 * N_(text), N_(longtext) );
698 * add_integer( option_name, i_value, p_callback, N_(text), N_(longtext),
700 * add_bool( option_name, b_value, p_callback, N_(text), N_(longtext),
705 /* Interface options */
706 add_category_hint( N_("Interface"), INTF_CAT_LONGTEXT , VLC_FALSE );
707 add_module( "intf", "interface", NULL, NULL, INTF_TEXT,
708 INTF_LONGTEXT, VLC_TRUE );
710 add_string( "extraintf", NULL, NULL, EXTRAINTF_TEXT,
711 EXTRAINTF_LONGTEXT, VLC_FALSE );
712 add_integer( "verbose", 0, NULL, VERBOSE_TEXT, VERBOSE_LONGTEXT,
715 add_bool( "quiet", 0, NULL, QUIET_TEXT, QUIET_LONGTEXT, VLC_TRUE );
717 add_string( "language", "auto", NULL, LANGUAGE_TEXT, LANGUAGE_LONGTEXT,
719 change_string_list( ppsz_language, ppsz_language_text, 0 );
720 add_bool( "color", 0, NULL, COLOR_TEXT, COLOR_LONGTEXT, VLC_TRUE );
721 add_bool( "advanced", 0, NULL, ADVANCED_TEXT,
722 ADVANCED_LONGTEXT, VLC_FALSE );
723 add_directory( "search-path", NULL, NULL, INTF_PATH_TEXT,
724 INTF_PATH_LONGTEXT, VLC_TRUE );
725 add_directory( "plugin-path", NULL, NULL,
726 PLUGIN_PATH_TEXT, PLUGIN_PATH_LONGTEXT, VLC_TRUE );
729 add_category_hint( N_("Audio"), AOUT_CAT_LONGTEXT , VLC_FALSE );
730 add_module( "aout", "audio output", NULL, NULL, AOUT_TEXT, AOUT_LONGTEXT,
733 add_bool( "audio", 1, NULL, AUDIO_TEXT, AUDIO_LONGTEXT, VLC_FALSE );
734 add_integer_with_range( "volume", AOUT_VOLUME_DEFAULT, AOUT_VOLUME_MIN,
735 AOUT_VOLUME_MAX, NULL, VOLUME_TEXT,
736 VOLUME_LONGTEXT, VLC_FALSE );
737 add_integer_with_range( "saved-volume", AOUT_VOLUME_DEFAULT,
738 AOUT_VOLUME_MIN, AOUT_VOLUME_MAX, NULL,
739 VOLUME_SAVE_TEXT, VOLUME_SAVE_LONGTEXT, VLC_TRUE );
740 add_integer( "aout-rate", -1, NULL, AOUT_RATE_TEXT, AOUT_RATE_LONGTEXT, VLC_TRUE );
741 #if !defined( SYS_DARWIN )
742 add_bool( "hq-resampling", 1, NULL, AOUT_RESAMP_TEXT, AOUT_RESAMP_LONGTEXT, VLC_TRUE );
744 add_bool( "spdif", 0, NULL, SPDIF_TEXT, SPDIF_LONGTEXT, VLC_FALSE );
745 add_integer( "audio-desync", 0, NULL, DESYNC_TEXT, DESYNC_LONGTEXT, VLC_TRUE );
746 add_string("audio-filter",0,NULL,AUDIO_FILTER_TEXT,
747 AUDIO_FILTER_LONGTEXT,VLC_FALSE);
748 add_module( "audio-channel-mixer", "audio filter", NULL, NULL,
749 AUDIO_CHANNEL_MIXER, AUDIO_CHANNEL_MIXER_LONGTEXT,
753 add_category_hint( N_("Video"), VOUT_CAT_LONGTEXT , VLC_FALSE );
754 add_module( "vout", "video output", NULL, NULL, VOUT_TEXT, VOUT_LONGTEXT,
757 add_bool( "video", 1, NULL, VIDEO_TEXT, VIDEO_LONGTEXT, VLC_TRUE );
758 add_integer( "width", -1, NULL, WIDTH_TEXT, WIDTH_LONGTEXT, VLC_TRUE );
759 add_integer( "height", -1, NULL, HEIGHT_TEXT, HEIGHT_LONGTEXT, VLC_TRUE );
760 add_integer( "align", 0, NULL, ALIGN_TEXT, ALIGN_LONGTEXT, VLC_TRUE );
761 change_integer_list( pi_align_values, ppsz_align_descriptions, 0 );
762 add_float( "zoom", 1, NULL, ZOOM_TEXT, ZOOM_LONGTEXT, VLC_TRUE );
763 add_bool( "grayscale", 0, NULL, GRAYSCALE_TEXT, GRAYSCALE_LONGTEXT, VLC_TRUE );
764 add_bool( "fullscreen", 0, NULL, FULLSCREEN_TEXT,
765 FULLSCREEN_LONGTEXT, VLC_FALSE );
767 add_bool( "overlay", 1, NULL, OVERLAY_TEXT, OVERLAY_LONGTEXT, VLC_TRUE );
770 add_bool( "video-on-top", 0, NULL, VIDEO_ON_TOP_TEXT, VIDEO_ON_TOP_LONGTEXT, VLC_FALSE );
771 add_integer( "spumargin", -1, NULL, SPUMARGIN_TEXT,
772 SPUMARGIN_LONGTEXT, VLC_TRUE );
773 add_bool( "osd", 1, NULL, OSD_TEXT, OSD_LONGTEXT, VLC_FALSE );
774 add_module( "filter", "video filter", NULL, NULL,
775 FILTER_TEXT, FILTER_LONGTEXT, VLC_FALSE );
776 add_string( "aspect-ratio", "", NULL,
777 ASPECT_RATIO_TEXT, ASPECT_RATIO_LONGTEXT, VLC_TRUE );
779 add_string( "pixel-ratio", "1", NULL, PIXEL_RATIO_TEXT, PIXEL_RATIO_TEXT );
783 add_category_hint( N_("Input"), INPUT_CAT_LONGTEXT , VLC_FALSE );
784 add_integer( "cr-average", 40, NULL, CR_AVERAGE_TEXT,
785 CR_AVERAGE_LONGTEXT, VLC_FALSE );
786 add_integer( "server-port", 1234, NULL,
787 SERVER_PORT_TEXT, SERVER_PORT_LONGTEXT, VLC_FALSE );
788 add_integer( "mtu", 1500, NULL, MTU_TEXT, MTU_LONGTEXT, VLC_TRUE );
789 add_string( "iface-addr", "", NULL, IFACE_ADDR_TEXT, IFACE_ADDR_LONGTEXT, VLC_TRUE );
791 add_integer( "program", 0, NULL,
792 INPUT_PROGRAM_TEXT, INPUT_PROGRAM_LONGTEXT, VLC_TRUE );
793 add_integer( "audio-type", -1, NULL,
794 INPUT_AUDIO_TEXT, INPUT_AUDIO_LONGTEXT, VLC_TRUE );
795 add_integer( "audio-channel", -1, NULL,
796 INPUT_CHAN_TEXT, INPUT_CHAN_LONGTEXT, VLC_FALSE );
797 add_integer( "spu-channel", -1, NULL,
798 INPUT_SUBT_TEXT, INPUT_SUBT_LONGTEXT, VLC_FALSE );
799 add_bool( "sub-autodetect-file", VLC_TRUE, NULL,
800 SUB_AUTO_TEXT, SUB_AUTO_LONGTEXT, VLC_FALSE );
801 add_integer( "sub-autodetect-fuzzy", 3, NULL,
802 SUB_FUZZY_TEXT, SUB_FUZZY_LONGTEXT, VLC_TRUE );
803 add_file( "sub-file", NULL, NULL,
804 SUB_FILE_TEXT, SUB_FILE_LONGTEXT, VLC_TRUE );
805 add_integer( "input-repeat", 0, NULL,
806 INPUT_REPEAT_TEXT, INPUT_REPEAT_LONGTEXT, VLC_TRUE );
807 add_integer( "start-time", 0, NULL,
808 START_TIME_TEXT, START_TIME_LONGTEXT, VLC_TRUE );
809 add_integer( "stop-time", 0, NULL,
810 STOP_TIME_TEXT, STOP_TIME_LONGTEXT, VLC_TRUE );
812 add_file( "dvd", DVD_DEVICE, NULL, DVD_DEV_TEXT, DVD_DEV_LONGTEXT,
814 add_file( "vcd", VCD_DEVICE, NULL, VCD_DEV_TEXT, VCD_DEV_LONGTEXT,
816 add_file( "cd-audio", CDAUDIO_DEVICE, NULL, CDAUDIO_DEV_TEXT,
817 CDAUDIO_DEV_LONGTEXT, VLC_FALSE );
819 add_bool( "ipv6", 0, NULL, IPV6_TEXT, IPV6_LONGTEXT, VLC_FALSE );
821 add_bool( "ipv4", 0, NULL, IPV4_TEXT, IPV4_LONGTEXT, VLC_FALSE );
824 add_string( "meta-title", NULL, NULL, META_TITLE_TEXT,
825 META_TITLE_LONGTEXT, VLC_TRUE );
826 add_string( "meta-author", NULL, NULL, META_AUTHOR_TEXT,
827 META_AUTHOR_LONGTEXT, VLC_TRUE );
828 add_string( "meta-artist", NULL, NULL, META_ARTIST_TEXT,
829 META_ARTIST_LONGTEXT, VLC_TRUE );
830 add_string( "meta-genre", NULL, NULL, META_GENRE_TEXT,
831 META_GENRE_LONGTEXT, VLC_TRUE );
832 add_string( "meta-copyright", NULL, NULL, META_CPYR_TEXT,
833 META_CPYR_LONGTEXT, VLC_TRUE );
834 add_string( "meta-description", NULL, NULL, META_DESCR_TEXT,
835 META_DESCR_LONGTEXT, VLC_TRUE );
836 add_string( "meta-date", NULL, NULL, META_DATE_TEXT,
837 META_DATE_LONGTEXT, VLC_TRUE );
838 add_string( "meta-url", NULL, NULL, META_URL_TEXT,
839 META_URL_LONGTEXT, VLC_TRUE );
841 /* Decoder options */
842 add_category_hint( N_("Decoders"), CODEC_CAT_LONGTEXT , VLC_TRUE );
843 add_module( "codec", "decoder", NULL, NULL, CODEC_TEXT, CODEC_LONGTEXT, VLC_TRUE );
844 add_module( "encoder", "encoder", NULL, NULL, ENCODER_TEXT, ENCODER_LONGTEXT, VLC_TRUE );
847 /* Stream output options */
848 add_category_hint( N_("Stream output"), SOUT_CAT_LONGTEXT , VLC_TRUE );
849 add_string( "sout", NULL, NULL, SOUT_TEXT, SOUT_LONGTEXT, VLC_TRUE );
850 add_bool( "sout-display", VLC_FALSE, NULL, SOUT_DISPLAY_TEXT,
851 SOUT_DISPLAY_LONGTEXT, VLC_TRUE );
852 add_bool( "sout-keep", VLC_FALSE, NULL, SOUT_KEEP_TEXT,
853 SOUT_KEEP_LONGTEXT, VLC_TRUE );
854 add_bool( "sout-all", 0, NULL, SOUT_ALL_TEXT,
855 SOUT_ALL_LONGTEXT, VLC_TRUE );
856 add_bool( "sout-audio", 1, NULL, SOUT_AUDIO_TEXT,
857 SOUT_AUDIO_LONGTEXT, VLC_TRUE );
858 add_bool( "sout-video", 1, NULL, SOUT_VIDEO_TEXT,
859 SOUT_VIDEO_LONGTEXT, VLC_TRUE );
861 add_module( "packetizer", "packetizer", NULL, NULL,
862 PACKETIZER_TEXT, PACKETIZER_LONGTEXT, VLC_TRUE );
863 add_module( "mux", "sout mux", NULL, NULL, MUX_TEXT,
864 MUX_LONGTEXT, VLC_TRUE );
865 add_module( "access_output", "sout access", NULL, NULL,
866 ACCESS_OUTPUT_TEXT, ACCESS_OUTPUT_LONGTEXT, VLC_TRUE );
867 add_integer( "ttl", 1, NULL, TTL_TEXT, TTL_LONGTEXT, VLC_TRUE );
871 add_category_hint( N_("CPU"), CPU_CAT_LONGTEXT, VLC_TRUE );
872 #if defined( __i386__ )
873 add_bool( "mmx", 1, NULL, MMX_TEXT, MMX_LONGTEXT, VLC_TRUE );
874 add_bool( "3dn", 1, NULL, THREE_DN_TEXT, THREE_DN_LONGTEXT, VLC_TRUE );
875 add_bool( "mmxext", 1, NULL, MMXEXT_TEXT, MMXEXT_LONGTEXT, VLC_TRUE );
876 add_bool( "sse", 1, NULL, SSE_TEXT, SSE_LONGTEXT, VLC_TRUE );
877 add_bool( "sse2", 1, NULL, SSE2_TEXT, SSE2_LONGTEXT, VLC_TRUE );
879 #if defined( __powerpc__ ) || defined( SYS_DARWIN )
880 add_bool( "altivec", 1, NULL, ALTIVEC_TEXT, ALTIVEC_LONGTEXT, VLC_TRUE );
883 /* Playlist options */
884 add_category_hint( N_("Playlist"), PLAYLIST_CAT_LONGTEXT , VLC_FALSE );
885 add_bool( "random", 0, NULL, RANDOM_TEXT, RANDOM_LONGTEXT, VLC_FALSE );
887 add_bool( "loop", 0, NULL, LOOP_TEXT, LOOP_LONGTEXT, VLC_FALSE );
889 add_bool( "repeat", 0, NULL, REPEAT_TEXT, REPEAT_LONGTEXT, VLC_TRUE );
893 add_category_hint( N_("Miscellaneous"), MISC_CAT_LONGTEXT, VLC_TRUE );
894 add_module( "memcpy", "memcpy", NULL, NULL, MEMCPY_TEXT, MEMCPY_LONGTEXT, VLC_TRUE );
895 add_module( "access", "access", NULL, NULL, ACCESS_TEXT, ACCESS_LONGTEXT, VLC_TRUE );
896 add_module( "demux", "demux", NULL, NULL, DEMUX_TEXT, DEMUX_LONGTEXT, VLC_TRUE );
898 add_bool( "minimize-threads", 0, NULL, MINIMIZE_THREADS_TXT, MINIMIZE_THREADS_LONGTXT, VLC_TRUE );
900 #if !defined(SYS_DARWIN) && !defined(SYS_BEOS) && defined(PTHREAD_COND_T_IN_PTHREAD_H)
901 add_bool( "rt-priority", 0, NULL, RT_PRIORITY_TEXT, RT_PRIORITY_LONGTEXT, VLC_TRUE );
904 #if !defined(SYS_BEOS) && defined(PTHREAD_COND_T_IN_PTHREAD_H)
905 add_integer( "rt-offset", 0, NULL, RT_OFFSET_TEXT, RT_OFFSET_LONGTEXT, VLC_TRUE );
909 add_bool( "one-instance", 0, NULL, ONEINSTANCE_TEXT, ONEINSTANCE_LONGTEXT, VLC_TRUE );
910 add_bool( "high-priority", 1, NULL, HPRIORITY_TEXT, HPRIORITY_LONGTEXT, VLC_TRUE );
911 add_bool( "fast-mutex", 0, NULL, FAST_MUTEX_TEXT, FAST_MUTEX_LONGTEXT, VLC_TRUE );
912 add_integer( "win9x-cv-method", 1, NULL, WIN9X_CV_TEXT, WIN9X_CV_LONGTEXT, VLC_TRUE );
916 add_category_hint( N_("Hot keys"), HOTKEY_CAT_LONGTEXT , VLC_FALSE );
917 #if defined(SYS_DARWIN)
918 add_key( "key-fullscreen", KEY_MODIFIER_COMMAND|'f', NULL, FULLSCREEN_KEY_TEXT, FULLSCREEN_KEY_LONGTEXT, VLC_FALSE );
919 add_key( "key-play-pause", KEY_MODIFIER_COMMAND|'p', NULL, PLAY_PAUSE_KEY_TEXT, PLAY_PAUSE_KEY_LONGTEXT, VLC_FALSE );
920 add_key( "key-pause", 0, NULL, PAUSE_KEY_TEXT, PAUSE_KEY_LONGTEXT, VLC_TRUE );
921 add_key( "key-play", 0, NULL, PLAY_KEY_TEXT, PLAY_KEY_LONGTEXT, VLC_TRUE );
922 add_key( "key-faster", KEY_MODIFIER_COMMAND|'=', NULL, FASTER_KEY_TEXT, FASTER_KEY_LONGTEXT, VLC_FALSE );
923 add_key( "key-slower", KEY_MODIFIER_COMMAND|'-', NULL, SLOWER_KEY_TEXT, SLOWER_KEY_LONGTEXT, VLC_FALSE );
924 add_key( "key-next", KEY_MODIFIER_COMMAND|KEY_RIGHT, NULL, NEXT_KEY_TEXT, NEXT_KEY_LONGTEXT, VLC_FALSE );
925 add_key( "key-prev", KEY_MODIFIER_COMMAND|KEY_LEFT, NULL, PREV_KEY_TEXT, PREV_KEY_LONGTEXT, VLC_FALSE );
926 add_key( "key-stop", KEY_MODIFIER_COMMAND|'.', NULL, STOP_KEY_TEXT, STOP_KEY_LONGTEXT, VLC_FALSE );
927 add_key( "key-position", 't', NULL, POSITION_KEY_TEXT, POSITION_KEY_LONGTEXT, VLC_FALSE );
928 add_key( "key-jump-10sec", KEY_MODIFIER_COMMAND|KEY_MODIFIER_ALT|KEY_LEFT, NULL, JB10SEC_KEY_TEXT, JB10SEC_KEY_LONGTEXT, VLC_FALSE );
929 add_key( "key-jump+10sec", KEY_MODIFIER_COMMAND|KEY_MODIFIER_ALT|KEY_RIGHT, NULL, JF10SEC_KEY_TEXT, JF10SEC_KEY_LONGTEXT, VLC_FALSE );
930 add_key( "key-jump-1min", KEY_MODIFIER_COMMAND|KEY_MODIFIER_SHIFT|KEY_LEFT, NULL, JB1MIN_KEY_TEXT, JB1MIN_KEY_LONGTEXT, VLC_FALSE );
931 add_key( "key-jump+1min", KEY_MODIFIER_COMMAND|KEY_MODIFIER_SHIFT|KEY_RIGHT, NULL, JF1MIN_KEY_TEXT, JF1MIN_KEY_LONGTEXT, VLC_FALSE );
932 add_key( "key-jump-5min", KEY_MODIFIER_COMMAND|KEY_MODIFIER_SHIFT|KEY_MODIFIER_ALT|KEY_LEFT, NULL, JB5MIN_KEY_TEXT, JB5MIN_KEY_LONGTEXT, VLC_FALSE );
933 add_key( "key-jump+5min", KEY_MODIFIER_COMMAND|KEY_MODIFIER_SHIFT|KEY_MODIFIER_ALT|KEY_RIGHT, NULL, JF5MIN_KEY_TEXT, JF5MIN_KEY_LONGTEXT, VLC_FALSE );
934 add_key( "key-nav-activate", KEY_ENTER, NULL, NAV_ACTIVATE_KEY_TEXT, NAV_ACTIVATE_KEY_LONGTEXT, VLC_FALSE );
935 add_key( "key-nav-up", KEY_UP, NULL, NAV_UP_KEY_TEXT, NAV_UP_KEY_LONGTEXT, VLC_FALSE );
936 add_key( "key-nav-down", KEY_DOWN, NULL, NAV_DOWN_KEY_TEXT, NAV_DOWN_KEY_LONGTEXT, VLC_FALSE );
937 add_key( "key-nav-left", KEY_LEFT, NULL, NAV_LEFT_KEY_TEXT, NAV_LEFT_KEY_LONGTEXT, VLC_FALSE );
938 add_key( "key-nav-right", KEY_RIGHT, NULL, NAV_RIGHT_KEY_TEXT, NAV_RIGHT_KEY_LONGTEXT, VLC_FALSE );
939 add_key( "key-quit", KEY_MODIFIER_COMMAND|'q', NULL, QUIT_KEY_TEXT, QUIT_KEY_LONGTEXT, VLC_FALSE );
940 add_key( "key-vol-up", KEY_MODIFIER_COMMAND|KEY_UP, NULL, VOL_UP_KEY_TEXT, VOL_UP_KEY_LONGTEXT, VLC_FALSE );
941 add_key( "key-vol-down", KEY_MODIFIER_COMMAND|KEY_DOWN, NULL, VOL_DOWN_KEY_TEXT, VOL_DOWN_KEY_LONGTEXT, VLC_FALSE );
942 add_key( "key-vol-mute", KEY_MODIFIER_COMMAND|KEY_MODIFIER_SHIFT|'m', NULL, VOL_MUTE_KEY_TEXT, VOL_MUTE_KEY_LONGTEXT, VLC_FALSE );
943 add_key( "key-set-bookmark1", KEY_MODIFIER_COMMAND|KEY_F1, NULL, SET_BOOKMARK1_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
944 add_key( "key-set-bookmark2", KEY_MODIFIER_COMMAND|KEY_F2, NULL, SET_BOOKMARK2_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
945 add_key( "key-set-bookmark3", KEY_MODIFIER_COMMAND|KEY_F3, NULL, SET_BOOKMARK3_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
946 add_key( "key-set-bookmark4", KEY_MODIFIER_COMMAND|KEY_F4, NULL, SET_BOOKMARK4_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
947 add_key( "key-set-bookmark5", KEY_MODIFIER_COMMAND|KEY_F5, NULL, SET_BOOKMARK5_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
948 add_key( "key-set-bookmark6", KEY_MODIFIER_COMMAND|KEY_F6, NULL, SET_BOOKMARK6_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
949 add_key( "key-set-bookmark7", KEY_MODIFIER_COMMAND|KEY_F7, NULL, SET_BOOKMARK7_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
950 add_key( "key-set-bookmark8", KEY_MODIFIER_COMMAND|KEY_F8, NULL, SET_BOOKMARK8_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
951 add_key( "key-set-bookmark9", KEY_UNSET, NULL, SET_BOOKMARK9_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
952 add_key( "key-set-bookmark10", KEY_UNSET, NULL, SET_BOOKMARK10_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
953 add_key( "key-play-bookmark1", KEY_F1, NULL, PLAY_BOOKMARK1_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
954 add_key( "key-play-bookmark2", KEY_F2, NULL, PLAY_BOOKMARK2_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
955 add_key( "key-play-bookmark3", KEY_F3, NULL, PLAY_BOOKMARK3_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
956 add_key( "key-play-bookmark4", KEY_F4, NULL, PLAY_BOOKMARK4_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
957 add_key( "key-play-bookmark5", KEY_F5, NULL, PLAY_BOOKMARK5_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
958 add_key( "key-play-bookmark6", KEY_F6, NULL, PLAY_BOOKMARK6_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
959 add_key( "key-play-bookmark7", KEY_F7, NULL, PLAY_BOOKMARK7_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
960 add_key( "key-play-bookmark8", KEY_F8, NULL, PLAY_BOOKMARK8_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
961 add_key( "key-play-bookmark9", KEY_UNSET, NULL, PLAY_BOOKMARK9_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
962 add_key( "key-play-bookmark10", KEY_UNSET, NULL, PLAY_BOOKMARK10_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
964 add_key( "key-fullscreen", 'f', NULL, FULLSCREEN_KEY_TEXT, FULLSCREEN_KEY_LONGTEXT, VLC_FALSE );
965 add_key( "key-play-pause", KEY_SPACE, NULL, PLAY_PAUSE_KEY_TEXT, PLAY_PAUSE_KEY_LONGTEXT, VLC_FALSE );
966 add_key( "key-pause", 0, NULL, PAUSE_KEY_TEXT, PAUSE_KEY_LONGTEXT, VLC_TRUE );
967 add_key( "key-play", 0, NULL, PLAY_KEY_TEXT, PLAY_KEY_LONGTEXT, VLC_TRUE );
968 add_key( "key-faster", '+', NULL, FASTER_KEY_TEXT, FASTER_KEY_LONGTEXT, VLC_FALSE );
969 add_key( "key-slower", '-', NULL, SLOWER_KEY_TEXT, SLOWER_KEY_LONGTEXT, VLC_FALSE );
970 add_key( "key-next", 'n', NULL, NEXT_KEY_TEXT, NEXT_KEY_LONGTEXT, VLC_FALSE );
971 add_key( "key-prev", 'p', NULL, PREV_KEY_TEXT, PREV_KEY_LONGTEXT, VLC_FALSE );
972 add_key( "key-stop", 's', NULL, STOP_KEY_TEXT, STOP_KEY_LONGTEXT, VLC_FALSE );
973 add_key( "key-position", 't', NULL, POSITION_KEY_TEXT, POSITION_KEY_LONGTEXT, VLC_FALSE );
974 add_key( "key-jump-10sec", KEY_MODIFIER_ALT|KEY_LEFT, NULL, JB10SEC_KEY_TEXT, JB10SEC_KEY_LONGTEXT, VLC_FALSE );
975 add_key( "key-jump+10sec", KEY_MODIFIER_ALT|KEY_RIGHT, NULL, JF10SEC_KEY_TEXT, JF10SEC_KEY_LONGTEXT, VLC_FALSE );
976 add_key( "key-jump-1min", KEY_MODIFIER_CTRL|KEY_LEFT, NULL, JB1MIN_KEY_TEXT, JB1MIN_KEY_LONGTEXT, VLC_FALSE );
977 add_key( "key-jump+1min", KEY_MODIFIER_CTRL|KEY_RIGHT, NULL, JF1MIN_KEY_TEXT, JF1MIN_KEY_LONGTEXT, VLC_FALSE );
978 add_key( "key-jump-5min", KEY_MODIFIER_CTRL|KEY_MODIFIER_ALT|KEY_LEFT, NULL, JB5MIN_KEY_TEXT, JB5MIN_KEY_LONGTEXT, VLC_FALSE );
979 add_key( "key-jump+5min", KEY_MODIFIER_CTRL|KEY_MODIFIER_ALT|KEY_RIGHT, NULL, JF5MIN_KEY_TEXT, JF5MIN_KEY_LONGTEXT, VLC_FALSE );
980 add_key( "key-nav-activate", KEY_ENTER, NULL, NAV_ACTIVATE_KEY_TEXT, NAV_ACTIVATE_KEY_LONGTEXT, VLC_FALSE );
981 add_key( "key-nav-up", KEY_UP, NULL, NAV_UP_KEY_TEXT, NAV_UP_KEY_LONGTEXT, VLC_FALSE );
982 add_key( "key-nav-down", KEY_DOWN, NULL, NAV_DOWN_KEY_TEXT, NAV_DOWN_KEY_LONGTEXT, VLC_FALSE );
983 add_key( "key-nav-left", KEY_LEFT, NULL, NAV_LEFT_KEY_TEXT, NAV_LEFT_KEY_LONGTEXT, VLC_FALSE );
984 add_key( "key-nav-right", KEY_RIGHT, NULL, NAV_RIGHT_KEY_TEXT, NAV_RIGHT_KEY_LONGTEXT, VLC_FALSE );
985 add_key( "key-quit", KEY_MODIFIER_CTRL|'q', NULL, QUIT_KEY_TEXT, QUIT_KEY_LONGTEXT, VLC_FALSE );
986 add_key( "key-vol-up", 'a', NULL, VOL_UP_KEY_TEXT, VOL_UP_KEY_LONGTEXT, VLC_FALSE );
987 add_key( "key-vol-down", 'z', NULL, VOL_DOWN_KEY_TEXT, VOL_DOWN_KEY_LONGTEXT, VLC_FALSE );
988 add_key( "key-vol-mute", 'm', NULL, VOL_MUTE_KEY_TEXT, VOL_MUTE_KEY_LONGTEXT, VLC_FALSE );
989 add_key( "key-set-bookmark1", KEY_MODIFIER_CTRL|KEY_F1, NULL, SET_BOOKMARK1_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
990 add_key( "key-set-bookmark2", KEY_MODIFIER_CTRL|KEY_F2, NULL, SET_BOOKMARK2_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
991 add_key( "key-set-bookmark3", KEY_MODIFIER_CTRL|KEY_F3, NULL, SET_BOOKMARK3_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
992 add_key( "key-set-bookmark4", KEY_MODIFIER_CTRL|KEY_F4, NULL, SET_BOOKMARK4_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
993 add_key( "key-set-bookmark5", KEY_MODIFIER_CTRL|KEY_F5, NULL, SET_BOOKMARK5_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
994 add_key( "key-set-bookmark6", KEY_MODIFIER_CTRL|KEY_F6, NULL, SET_BOOKMARK6_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
995 add_key( "key-set-bookmark7", KEY_MODIFIER_CTRL|KEY_F7, NULL, SET_BOOKMARK7_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
996 add_key( "key-set-bookmark8", KEY_MODIFIER_CTRL|KEY_F8, NULL, SET_BOOKMARK8_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
997 add_key( "key-set-bookmark9", KEY_MODIFIER_CTRL|KEY_F9, NULL, SET_BOOKMARK9_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
998 add_key( "key-set-bookmark10", KEY_MODIFIER_CTRL|KEY_F10, NULL, SET_BOOKMARK10_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
999 add_key( "key-play-bookmark1", KEY_F1, NULL, PLAY_BOOKMARK1_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
1000 add_key( "key-play-bookmark2", KEY_F2, NULL, PLAY_BOOKMARK2_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
1001 add_key( "key-play-bookmark3", KEY_F3, NULL, PLAY_BOOKMARK3_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
1002 add_key( "key-play-bookmark4", KEY_F4, NULL, PLAY_BOOKMARK4_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
1003 add_key( "key-play-bookmark5", KEY_F5, NULL, PLAY_BOOKMARK5_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
1004 add_key( "key-play-bookmark6", KEY_F6, NULL, PLAY_BOOKMARK6_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
1005 add_key( "key-play-bookmark7", KEY_F7, NULL, PLAY_BOOKMARK7_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
1006 add_key( "key-play-bookmark8", KEY_F8, NULL, PLAY_BOOKMARK8_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
1007 add_key( "key-play-bookmark9", KEY_F9, NULL, PLAY_BOOKMARK9_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
1008 add_key( "key-play-bookmark10", KEY_F10, NULL, PLAY_BOOKMARK10_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
1011 /* Usage (mainly useful for cmd line stuff) */
1012 add_usage_hint( PLAYLIST_USAGE );
1014 set_description( N_("main program") );
1015 set_capability( "main", 100 );
1018 static module_config_t p_help_config[] =
1020 { CONFIG_ITEM_BOOL, NULL, "help", 'h',
1021 N_("print help (can be combined with --advanced)") },
1022 { CONFIG_ITEM_BOOL, NULL, "longhelp", 'H',
1023 N_("print detailed help (can be combined with --advanced)") },
1024 { CONFIG_ITEM_BOOL, NULL, "list", 'l',
1025 N_("print a list of available modules") },
1026 { CONFIG_ITEM_STRING, NULL, "module", 'p',
1027 N_("print help on module (can be combined with --advanced)") },
1028 { CONFIG_ITEM_BOOL, NULL, "save-config", '\0',
1029 N_("save the current command line options in the config") },
1030 { CONFIG_ITEM_BOOL, NULL, "reset-config", '\0',
1031 N_("reset the current config to the default values") },
1032 { CONFIG_ITEM_STRING, NULL, "config", '\0',
1033 N_("use alternate config file") },
1034 { CONFIG_ITEM_BOOL, NULL, "version", '\0',
1035 N_("print version information") },
1036 { CONFIG_HINT_END, NULL, NULL, '\0', NULL }
1039 /*****************************************************************************
1040 * End configuration.
1041 *****************************************************************************/
1043 /*****************************************************************************
1044 * Initializer for the vlc_t structure storing the action / key associations
1045 *****************************************************************************/
1046 static struct hotkey p_hotkeys[] =
1048 { "key-quit", ACTIONID_QUIT, 0 },
1049 { "key-play-pause", ACTIONID_PLAY_PAUSE, 0 },
1050 { "key-play", ACTIONID_PLAY, 0 },
1051 { "key-pause", ACTIONID_PAUSE, 0 },
1052 { "key-stop", ACTIONID_STOP, 0 },
1053 { "key-position", ACTIONID_POSITION, 0 },
1054 { "key-jump-10sec", ACTIONID_JUMP_BACKWARD_10SEC, 0 },
1055 { "key-jump+10sec", ACTIONID_JUMP_FORWARD_10SEC, 0 },
1056 { "key-jump-1min", ACTIONID_JUMP_BACKWARD_1MIN, 0 },
1057 { "key-jump+1min", ACTIONID_JUMP_FORWARD_1MIN, 0 },
1058 { "key-jump-5min", ACTIONID_JUMP_BACKWARD_5MIN, 0 },
1059 { "key-jump+5min", ACTIONID_JUMP_FORWARD_5MIN, 0 },
1060 { "key-prev", ACTIONID_PREV, 0 },
1061 { "key-next", ACTIONID_NEXT, 0 },
1062 { "key-faster", ACTIONID_FASTER, 0 },
1063 { "key-slower", ACTIONID_SLOWER, 0 },
1064 { "key-fullscreen", ACTIONID_FULLSCREEN, 0 },
1065 { "key-vol-up", ACTIONID_VOL_UP, 0 },
1066 { "key-vol-down", ACTIONID_VOL_DOWN, 0 },
1067 { "key-vol-mute", ACTIONID_VOL_MUTE, 0 },
1068 { "key-nav-activate", ACTIONID_NAV_ACTIVATE, 0 },
1069 { "key-nav-up", ACTIONID_NAV_UP, 0 },
1070 { "key-nav-down", ACTIONID_NAV_DOWN, 0 },
1071 { "key-nav-left", ACTIONID_NAV_LEFT, 0 },
1072 { "key-nav-right", ACTIONID_NAV_RIGHT, 0 },
1073 { "key-set-bookmark1", ACTIONID_SET_BOOKMARK1, 0},
1074 { "key-set-bookmark2", ACTIONID_SET_BOOKMARK2, 0},
1075 { "key-set-bookmark3", ACTIONID_SET_BOOKMARK3, 0},
1076 { "key-set-bookmark4", ACTIONID_SET_BOOKMARK4, 0},
1077 { "key-set-bookmark5", ACTIONID_SET_BOOKMARK5, 0},
1078 { "key-set-bookmark6", ACTIONID_SET_BOOKMARK6, 0},
1079 { "key-set-bookmark7", ACTIONID_SET_BOOKMARK7, 0},
1080 { "key-set-bookmark8", ACTIONID_SET_BOOKMARK8, 0},
1081 { "key-set-bookmark9", ACTIONID_SET_BOOKMARK9, 0},
1082 { "key-set-bookmark10", ACTIONID_SET_BOOKMARK10, 0},
1083 { "key-play-bookmark1", ACTIONID_PLAY_BOOKMARK1, 0},
1084 { "key-play-bookmark2", ACTIONID_PLAY_BOOKMARK2, 0},
1085 { "key-play-bookmark3", ACTIONID_PLAY_BOOKMARK3, 0},
1086 { "key-play-bookmark4", ACTIONID_PLAY_BOOKMARK4, 0},
1087 { "key-play-bookmark5", ACTIONID_PLAY_BOOKMARK5, 0},
1088 { "key-play-bookmark6", ACTIONID_PLAY_BOOKMARK6, 0},
1089 { "key-play-bookmark7", ACTIONID_PLAY_BOOKMARK7, 0},
1090 { "key-play-bookmark8", ACTIONID_PLAY_BOOKMARK8, 0},
1091 { "key-play-bookmark9", ACTIONID_PLAY_BOOKMARK9, 0},
1092 { "key-play-bookmark10", ACTIONID_PLAY_BOOKMARK10, 0},