libvlc.h 100 KB
Newer Older
1
2
3
/*****************************************************************************
 * libvlc.h: main libvlc header
 *****************************************************************************
4
 * Copyright (C) 1998-2006 the VideoLAN team
Carlo Calabrò's avatar
Carlo Calabrò committed
5
 * $Id$
6
7
8
 *
 * Authors: Vincent Seguin <seguin@via.ecp.fr>
 *          Samuel Hocevar <sam@zoy.org>
9
 *          Gildas Bazin <gbazin@videolan.org>
10
 *          Jean-Paul Saman <jpsaman #_at_# m2x.nl>
11
12
13
14
15
16
17
18
19
20
21
22
23
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
dionoea's avatar
dionoea committed
24
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
25
26
 *****************************************************************************/

27
#define Nothing here, this is just to prevent update-po from being stupid
28
#include "vlc_keys.h"
29

Jean-Paul Saman's avatar
Jean-Paul Saman committed
30
#if defined (WIN32) || defined (__APPLE__)
31
static char *ppsz_language[] =
32
{ "auto", "en", "en_GB", "ca", "cs", "da", "de", "es", "fr", "gl", "he", "hu",
33
34
  "it", "ja", "ka", "ko", "nl", "oc", "pt_BR", "ro", "ru", "sv", "tr",
  "zh_CN", "zh_TW" };
35

36
static char *ppsz_language_text[] =
37
{ N_("Auto"), N_("American English"), N_("British English"),
38
39
N_("Catalan"), N_("Czech"), N_("Danish"), N_("German"), N_("Spanish"),
N_("French"), N_("Galician"), N_("Hebrew"), N_("Hungarian"),N_("Italian"),
40
41
42
N_("Japanese"),N_("Georgian"), N_("Korean"), N_("Dutch"), N_("Occitan"),
N_("Brazilian Portuguese"), N_("Romanian"), N_("Russian"), N_("Swedish"),
N_("Turkish"), N_("Simplified Chinese"), N_("Chinese Traditional") };
Jean-Paul Saman's avatar
Jean-Paul Saman committed
43
#endif
44

45
46
47
static char *ppsz_snap_formats[] =
{ "png", "jpg" };

48
49
50
51
52
53
/*****************************************************************************
 * Configuration options for the main program. Each module will also separatly
 * define its own configuration options.
 * Look into configuration.h if you need to know more about the following
 * macros.
 *****************************************************************************/
54

55
56
57
58
59
/*****************************************************************************
 * Intf
 ****************************************************************************/

// DEPRECATED
60
#define INTF_CAT_LONGTEXT N_( \
61
    "These options allow you to configure the interfaces used by VLC. " \
gbazin's avatar
   
gbazin committed
62
    "You can select the main interface, additional " \
63
    "interface modules, and define various related options." )
64

65
#define INTF_TEXT N_("Interface module")
66
#define INTF_LONGTEXT N_( \
67
    "This is the main interface used by VLC. " \
68
69
70
    "The default behavior is to automatically select the best module " \
    "available.")

71
#define EXTRAINTF_TEXT N_("Extra interface modules")
72
#define EXTRAINTF_LONGTEXT N_( \
73
    "You can select \"additional interfaces\" for VLC. " \
Sam Hocevar's avatar
Sam Hocevar committed
74
    "They will be launched in the background in addition to the default " \
75
    "interface. Use a comma separated list of interface modules. (common " \
76
    "values are \"rc\" (remote control), \"http\", \"gestures\" ...)")
77

zorglub's avatar
zorglub committed
78
79
#define CONTROL_TEXT N_("Control interfaces")
#define CONTROL_LONGTEXT N_( \
80
    "You can select control interfaces for VLC.")
zorglub's avatar
zorglub committed
81

82
#define VERBOSE_TEXT N_("Verbosity (0,1,2)")
83
#define VERBOSE_LONGTEXT N_( \
84
    "This is the verbosity level (0=only errors and " \
85
    "standard messages, 1=warnings, 2=debug).")
86

87
#define QUIET_TEXT N_("Be quiet")
88
#define QUIET_LONGTEXT N_( \
89
    "Turn off all warning and information messages.")
90

zorglub's avatar
zorglub committed
91
#define OPEN_TEXT N_("Default stream")
92
#define OPEN_LONGTEXT N_( \
93
    "This stream will always be opened at VLC startup." )
94

95
#define LANGUAGE_TEXT N_("Language")
96
97
#define LANGUAGE_LONGTEXT N_( "You can manually select a language for the " \
    "interface. The system language is auto-detected if \"auto\" is " \
98
    "specified here." )
gbazin's avatar
   
gbazin committed
99

100
#define COLOR_TEXT N_("Color messages")
101
#define COLOR_LONGTEXT N_( \
102
103
    "This enables colorization of the messages sent to the console " \
    "Your terminal needs Linux color support for this to work.")
104

105
#define ADVANCED_TEXT N_("Show advanced options")
106
#define ADVANCED_LONGTEXT N_( \
107
108
    "When this is enabled, the preferences and/or interfaces will " \
    "show all available options, including those that most users should " \
zorglub's avatar
zorglub committed
109
    "never touch.")
110

111
112
#define SHOWINTF_TEXT N_("Show interface with mouse")
#define SHOWINTF_LONGTEXT N_( \
113
    "When this is enabled, the interface is shown when you move the mouse to "\
114
115
    "the edge of the screen in fullscreen mode." )

116
117
118
119
120
#define INTERACTION_TEXT N_("Interface interaction")
#define INTERACTION_LONGTEXT N_( \
    "When this is enabled, the interface will show a dialog box each time " \
    "some user input is required." )

121
122
123
124
125
126

/*****************************************************************************
 * Audio
 ****************************************************************************/

// DEPRECATED
127
#define AOUT_CAT_LONGTEXT N_( \
128
    "These options allow you to modify the behavior of the audio " \
zorglub's avatar
zorglub committed
129
    "subsystem, and to add audio filters which can be used for " \
130
    "post processing or visual effects (spectrum analyzer, etc.). " \
zorglub's avatar
zorglub committed
131
132
    "Enable these filters here, and configure them in the \"audio filters\" " \
    "modules section.")
133

134
#define AOUT_TEXT N_("Audio output module")
135
#define AOUT_LONGTEXT N_( \
136
    "This is the audio output method used by VLC. " \
137
138
    "The default behavior is to automatically select the best method " \
    "available.")
139

140
#define AUDIO_TEXT N_("Enable audio")
141
#define AUDIO_LONGTEXT N_( \
142
    "You can completely disable the audio output. The audio " \
zorglub's avatar
zorglub committed
143
    "decoding stage will not take place, thus saving some processing power.")
144

145
#define MONO_TEXT N_("Force mono audio")
zorglub's avatar
zorglub committed
146
#define MONO_LONGTEXT N_("This will force a mono audio output.")
147

zorglub's avatar
zorglub committed
148
#define VOLUME_TEXT N_("Default audio volume")
149
150
151
152
#define VOLUME_LONGTEXT N_( \
    "You can set the default audio output volume here, in a range from 0 to " \
    "1024.")

153
#define VOLUME_SAVE_TEXT N_("Audio output saved volume")
154
#define VOLUME_SAVE_LONGTEXT N_( \
155
156
    "This saves the audio output volume when you use the mute function. " \
    "You should not change this option manually.")
157

158
159
160
161
162
#define VOLUME_STEP_TEXT N_("Audio output volume step")
#define VOLUME_STEP_LONGTEXT N_( \
    "The step size of the volume is adjustable using this option, " \
    "in a range from 0 to 1024." )

163
#define AOUT_RATE_TEXT N_("Audio output frequency (Hz)")
164
#define AOUT_RATE_LONGTEXT N_( \
165
    "You can force the audio output frequency here. Common values are " \
gbazin's avatar
   
gbazin committed
166
    "-1 (default), 48000, 44100, 32000, 22050, 16000, 11025, 8000.")
167

168
#if !defined( __APPLE__ )
gbazin's avatar
   
gbazin committed
169
170
#define AOUT_RESAMP_TEXT N_("High quality audio resampling")
#define AOUT_RESAMP_LONGTEXT N_( \
zorglub's avatar
zorglub committed
171
172
    "This uses a high quality audio resampling algorithm. High quality "\
    "audio resampling can be processor intensive so you can " \
gbazin's avatar
   
gbazin committed
173
174
175
    "disable it and a cheaper resampling algorithm will be used instead.")
#endif

zorglub's avatar
zorglub committed
176
#define DESYNC_TEXT N_("Audio desynchronization compensation")
177
#define DESYNC_LONGTEXT N_( \
178
179
    "This delays the audio output. The delay must be given in milliseconds." \
    "This can be handy if you notice a lag between the video and the audio.")
180

181
#define MULTICHA_TEXT N_("Audio output channels mode")
gbazin's avatar
   
gbazin committed
182
#define MULTICHA_LONGTEXT N_( \
183
    "This sets the audio output channels mode that will " \
gbazin's avatar
   
gbazin committed
184
    "be used by default when possible (ie. if your hardware supports it as " \
zorglub's avatar
zorglub committed
185
    "well as the audio stream being played).")
gbazin's avatar
   
gbazin committed
186

187
#define SPDIF_TEXT N_("Use S/PDIF when available")
gbazin's avatar
   
gbazin committed
188
#define SPDIF_LONGTEXT N_( \
189
    "S/PDIF can be used by default when " \
gbazin's avatar
   
gbazin committed
190
191
    "your hardware supports it as well as the audio stream being played.")

192
193
#define FORCE_DOLBY_TEXT N_("Force detection of Dolby Surround")
#define FORCE_DOLBY_LONGTEXT N_( \
194
    "Use this when you know your stream is (or is not) encoded with Dolby "\
195
    "Surround but fails to be detected as such. Even if the stream is "\
196
197
198
199
    "not actually encoded with Dolby Surround, turning on this option might "\
    "enhance your experience, especially when combined with the Headphone "\
    "Channel Mixer." )
static int pi_force_dolby_values[] = { 0, 1, 2 };
200
201
202
static char *ppsz_force_dolby_descriptions[] = { N_("Auto"), N_("On"), N_("Off") };


zorglub's avatar
zorglub committed
203
204
#define AUDIO_FILTER_TEXT N_("Audio filters")
#define AUDIO_FILTER_LONGTEXT N_( \
205
206
    "This adds audio post processing filters, to modify " \
    "the sound rendering." )
zorglub's avatar
zorglub committed
207
208
209

#define AUDIO_VISUAL_TEXT N_("Audio visualizations ")
#define AUDIO_VISUAL_LONGTEXT N_( \
210
211
212
213
214
    "This adds visualization modules (spectrum analyzer, etc.).")

/*****************************************************************************
 * Video
 ****************************************************************************/
zorglub's avatar
zorglub committed
215

216
// DEPRECATED
217
#define VOUT_CAT_LONGTEXT N_( \
218
219
    "These options allow you to modify the behavior of the video output " \
    "subsystem. You can for example enable video filters (deinterlacing, " \
220
    "image adjusting, etc.). Enable these filters here and configure " \
221
    "them in the \"video filters\" modules section. You can also set many " \
zorglub's avatar
zorglub committed
222
    "miscellaneous video options." )
zorglub's avatar
zorglub committed
223

224
#define VOUT_TEXT N_("Video output module")
225
#define VOUT_LONGTEXT N_( \
226
227
    "This is the the video output method used by VLC. " \
    "The default behavior is to automatically select the best method available.")
228

229
#define VIDEO_TEXT N_("Enable video")
230
#define VIDEO_LONGTEXT N_( \
231
    "You can completely disable the video output. The video " \
zorglub's avatar
zorglub committed
232
    "decoding stage will not take place, thus saving some processing power.")
233

234
#define WIDTH_TEXT N_("Video width")
235
#define WIDTH_LONGTEXT N_( \
236
    "You can enforce the video width. By default (-1) VLC will " \
237
238
    "adapt to the video characteristics.")

239
#define HEIGHT_TEXT N_("Video height")
240
#define HEIGHT_LONGTEXT N_( \
241
    "You can enforce the video height. By default (-1) VLC will " \
242
243
    "adapt to the video characteristics.")

244
#define VIDEOX_TEXT N_("Video X coordinate")
gbazin's avatar
gbazin committed
245
246
#define VIDEOX_LONGTEXT N_( \
    "You can enforce the position of the top left corner of the video window "\
247
    "(X coordinate).")
gbazin's avatar
gbazin committed
248

249
#define VIDEOY_TEXT N_("Video Y coordinate")
gbazin's avatar
gbazin committed
250
251
#define VIDEOY_LONGTEXT N_( \
    "You can enforce the position of the top left corner of the video window "\
252
    "(Y coordinate).")
gbazin's avatar
gbazin committed
253

254
255
#define VIDEO_TITLE_TEXT N_("Video title")
#define VIDEO_TITLE_LONGTEXT N_( \
256
257
    "Custom title for the video window (in case the video is not embedded in "\
    "the interface).")
258

gbazin's avatar
   
gbazin committed
259
260
#define ALIGN_TEXT N_("Video alignment")
#define ALIGN_LONGTEXT N_( \
261
    "Enforce the alignment of the video in its window. By default (0) it " \
gbazin's avatar
   
gbazin committed
262
    "will be centered (0=center, 1=left, 2=right, 4=top, 8=bottom, you can " \
263
    "also use combinations of these values, like 6=4+2 meaning top-right).")
sigmunau's avatar
sigmunau committed
264
static int pi_align_values[] = { 0, 1, 2, 4, 8, 5, 6, 9, 10 };
gbazin's avatar
gbazin committed
265
266
267
static char *ppsz_align_descriptions[] =
{ N_("Center"), N_("Left"), N_("Right"), N_("Top"), N_("Bottom"),
  N_("Top-Left"), N_("Top-Right"), N_("Bottom-Left"), N_("Bottom-Right") };
gbazin's avatar
   
gbazin committed
268

269
#define ZOOM_TEXT N_("Zoom video")
270
271
272
#define ZOOM_LONGTEXT N_( \
    "You can zoom the video by the specified factor.")

273
#define GRAYSCALE_TEXT N_("Grayscale video output")
274
#define GRAYSCALE_LONGTEXT N_( \
275
276
    "Output video in grayscale. As the color information aren't decoded, " \
    "this can save some processing power." )
277

278
#define FULLSCREEN_TEXT N_("Fullscreen video output")
279
#define FULLSCREEN_LONGTEXT N_( \
280
    "Start video in fullscreen mode" )
281

282
#define OVERLAY_TEXT N_("Overlay video output")
283
#define OVERLAY_LONGTEXT N_( \
284
285
    "Overlay is the hardware acceleration capability of your video card " \
    "(ability to render video directly). VLC will try to use it by default." )
286

gbazin's avatar
   
gbazin committed
287
#define VIDEO_ON_TOP_TEXT N_("Always on top")
288
289
#define VIDEO_ON_TOP_LONGTEXT N_( \
    "Always place the video window on top of other windows." )
gbazin's avatar
   
gbazin committed
290

291
292
293
#define SS_TEXT N_("Disable screensaver")
#define SS_LONGTEXT N_("Disable the screensaver during video playback." )

294
295
#define VIDEO_DECO_TEXT N_("Window decorations")
#define VIDEO_DECO_LONGTEXT N_( \
296
297
    "VLC can avoid creating window caption, frames, etc... around the video" \
    ", giving a \"minimal\" window.")
298

299
300
#define VOUT_FILTER_TEXT N_("Video output filter module")
#define VOUT_FILTER_LONGTEXT N_( \
301
    "This adds post-processing filters to enhance the " \
302
303
304
    "picture quality, for instance deinterlacing, or to clone or distort " \
    "the video window.")

305
306
307
308
309
310
#define VIDEO_FILTER_TEXT N_("Video filter module")
#define VIDEO_FILTER_LONGTEXT N_( \
    "This adds post-processing filters to enhance the " \
    "picture quality, for instance deinterlacing, or distort" \
    "the video.")

311
#define SNAP_PATH_TEXT N_("Video snapshot directory (or filename)")
312
#define SNAP_PATH_LONGTEXT N_( \
313
    "Directory where the video snapshots will be stored.")
314

315
316
317
318
#define SNAP_PREFIX_TEXT N_("Video snapshot file prefix")
#define SNAP_PREFIX_LONGTEXT N_( \
    "Video snapshot file prefix" )

319
320
#define SNAP_FORMAT_TEXT N_("Video snapshot format")
#define SNAP_FORMAT_LONGTEXT N_( \
321
    "Image format which will be used to store the video snapshots" )
322

323
324
#define SNAP_PREVIEW_TEXT N_("Display video snapshot preview")
#define SNAP_PREVIEW_LONGTEXT N_( \
325
    "Display the snapshot preview in the screen's top-left corner.")
326

327
328
329
330
#define SNAP_SEQUENTIAL_TEXT N_("Use sequential numbers instead of timestamps")
#define SNAP_SEQUENTIAL_LONGTEXT N_( \
    "Use sequential numbers instead of timestamps for snapshot numbering")

331
332
#define CROP_TEXT N_("Video cropping")
#define CROP_LONGTEXT N_( \
333
    "This forces the cropping of the source video. " \
334
335
336
    "Accepted formats are x:y (4:3, 16:9, etc.) expressing the global image " \
    "aspect.")

337
#define ASPECT_RATIO_TEXT N_("Source aspect ratio")
338
#define ASPECT_RATIO_LONGTEXT N_( \
339
    "This forces the source aspect ratio. For instance, some DVDs claim " \
340
341
342
343
344
345
    "to be 16:9 while they are actually 4:3. This can also be used as a " \
    "hint for VLC when a movie does not have aspect ratio information. " \
    "Accepted formats are x:y (4:3, 16:9, etc.) expressing the global image " \
    "aspect, or a float value (1.25, 1.3333, etc.) expressing pixel " \
    "squareness.")

346
347
348
349
350
351
352
353
354
355
#define CUSTOM_CROP_RATIOS_TEXT N_("Custom crop ratios list")
#define CUSTOM_CROP_RATIOS_LONGTEXT N_( \
    "Comma seperated list of crop ratios which will be added in the " \
    "interface's crop ratios list.")

#define CUSTOM_ASPECT_RATIOS_TEXT N_("Custom aspect ratios list")
#define CUSTOM_ASPECT_RATIOS_LONGTEXT N_( \
    "Comma seperated list of aspect ratios which will be added in the " \
    "interface's aspect ratio list.")

356
357
#define HDTV_FIX_TEXT N_("Fix HDTV height")
#define HDTV_FIX_LONGTEXT N_( \
358
359
360
361
    "This allows proper handling of HDTV-1080 video format " \
    "even if broken encoder incorrectly sets height to 1088 lines. " \
    "You should only disable this option if your video has a " \
    "non-standard format requiring all 1088 lines.")
362

363
#define MASPECT_RATIO_TEXT N_("Monitor pixel aspect ratio")
364
#define MASPECT_RATIO_LONGTEXT N_( \
365
    "This forces the monitor aspect ratio. Most monitors have square " \
366
367
    "pixels (1:1). If you have a 16:9 screen, you might need to change this " \
    "to 4:3 in order to keep proportions.")
368

zorglub's avatar
zorglub committed
369
/// \bug [String] Remove "this option"
370
371
#define SKIP_FRAMES_TEXT N_("Skip frames")
#define SKIP_FRAMES_LONGTEXT N_( \
zorglub's avatar
zorglub committed
372
373
    "This option enables framedropping on MPEG2 stream. Framedropping " \
    "occurs when your computer is not powerful enough" )
374

375
376
377
378
379
#define DROP_LATE_FRAMES_TEXT N_("Drop late frames")
#define DROP_LATE_FRAMES_LONGTEXT N_( \
    "This drops frames that are late (arrive to the video output after " \
    "their intended display date)." )

380
381
#define QUIET_SYNCHRO_TEXT N_("Quiet synchro")
#define QUIET_SYNCHRO_LONGTEXT N_( \
382
383
    "This avoids flooding the message log with debug output from the " \
    "video output synchronization mechanism.")
384

385
386
387
388
389
/*****************************************************************************
 * Input
 ****************************************************************************/

// Deprecated
Sam Hocevar's avatar
Sam Hocevar committed
390
#define INPUT_CAT_LONGTEXT N_( \
391
    "These options allow you to modify the behavior of the input " \
zorglub's avatar
zorglub committed
392
    "subsystem, such as the DVD or VCD device, the network interface " \
Sam Hocevar's avatar
Sam Hocevar committed
393
    "settings or the subtitle channel.")
394

395
396
397
398
#define FRANCE_LONGTEXT N_( \
    "If you live in France, it is not allowed to workaround any Digital " \
    "Restrictions Management measure." )

399
400
401
402
403
#define CR_AVERAGE_TEXT N_("Clock reference average counter")
#define CR_AVERAGE_LONGTEXT N_( \
    "When using the PVR input (or a very irregular source), you should " \
    "set this to 10000.")

404
405
#define CLOCK_SYNCHRO_TEXT N_("Clock synchronisation")
#define CLOCK_SYNCHRO_LONGTEXT N_( \
406
407
408
    "It is possible to disable the input clock synchronisation for " \
    "real-time sources. Use this if you experience jerky playback of " \
    "network streams.")
409

410
411
412
#define NETSYNC_TEXT N_("Network synchronisation" )
#define NETSYNC_LONGTEXT N_( "This allows you to remotely " \
        "synchronise clocks for server and client. The detailed settings " \
413
        "are available in Advanced / Network Sync." )
414

415
416
417
418
static int pi_clock_values[] = { -1, 0, 1 };
static char *ppsz_clock_descriptions[] =
{ N_("Default"), N_("Disable"), N_("Enable") };

419
#define SERVER_PORT_TEXT N_("UDP port")
420
#define SERVER_PORT_LONGTEXT N_( \
421
    "This is the default port used for UDP streams. Default is 1234." )
422

Sam Hocevar's avatar
Sam Hocevar committed
423
#define MTU_TEXT N_("MTU of the network interface")
Christophe Massiot's avatar
Christophe Massiot committed
424
#define MTU_LONGTEXT N_( \
Marian Durkovic's avatar
Marian Durkovic committed
425
    "This is the maximum packet size that can be transmitted " \
426
    "over the network interface. On Ethernet it is usually 1500 bytes.")
Christophe Massiot's avatar
Christophe Massiot committed
427

428
#define TTL_TEXT N_("Hop limit (TTL)")
429
#define TTL_LONGTEXT N_( \
430
431
432
    "This is the hop limit (also known as \"Time-To-Live\" or TTL) of " \
    "the multicast packets sent by the stream output (0 = use operating "\
    "system built-in default).")
433

434
#define MIFACE_TEXT N_("IPv6 multicast output interface")
435
#define MIFACE_LONGTEXT N_( \
436
    "Default IPv6 multicast interface. This overrides the routing table.")
437

438
439
#define MIFACE_ADDR_TEXT N_("IPv4 multicast output interface address")
#define MIFACE_ADDR_LONGTEXT N_( \
440
441
    "IPv4 adress for the default multicast interface. This overrides " \
    "the routing table.")
442

443
#define INPUT_PROGRAM_TEXT N_("Program")
444
#define INPUT_PROGRAM_LONGTEXT N_( \
445
    "Choose the program to select by giving its Service ID. " \
446
    "Only use this option if you want to read a multi-program stream " \
447
    "(like DVB streams for example)." )
448

449
#define INPUT_PROGRAMS_TEXT N_("Programs")
450
#define INPUT_PROGRAMS_LONGTEXT N_( \
hartman's avatar
hartman committed
451
    "Choose the programs to select by giving a comma-separated list of " \
452
    "Service IDs (SIDs). " \
453
    "Only use this option if you want to read a multi-program stream " \
454
    "(like DVB streams for example)." )
455

456
/// \todo Document how to find it
zorglub's avatar
zorglub committed
457
#define INPUT_AUDIOTRACK_TEXT N_("Audio track")
458
#define INPUT_AUDIOTRACK_LONGTEXT N_( \
459
    "Stream number of the audio track to use " \
460
    "(from 0 to n).")
461

zorglub's avatar
zorglub committed
462
#define INPUT_SUBTRACK_TEXT N_("Subtitles track")
463
#define INPUT_SUBTRACK_LONGTEXT N_( \
464
    "Stream number of the subtitle track to use " \
465
    "(from 0 to n).")
466

zorglub's avatar
zorglub committed
467
#define INPUT_AUDIOTRACK_LANG_TEXT N_("Audio language")
468
#define INPUT_AUDIOTRACK_LANG_LONGTEXT N_( \
469
470
    "Language of the audio track you want to use " \
    "(comma separated, two or three letter country code).")
471

zorglub's avatar
zorglub committed
472
#define INPUT_SUBTRACK_LANG_TEXT N_("Subtitle language")
473
#define INPUT_SUBTRACK_LANG_LONGTEXT N_( \
474
475
    "Language of the subtitle track you want to use " \
    "(comma separated, two or tree letter country code).")
476

477
/// \todo Document how to find it
478
479
#define INPUT_AUDIOTRACK_ID_TEXT N_("Audio track ID")
#define INPUT_AUDIOTRACK_ID_LONGTEXT N_( \
480
    "Stream ID of the audio track to use.")
481
482
483

#define INPUT_SUBTRACK_ID_TEXT N_("Subtitles track ID")
#define INPUT_SUBTRACK_ID_LONGTEXT N_( \
484
    "Stream ID of the subtitle track to use.")
485

486
#define INPUT_REPEAT_TEXT N_("Input repetitions")
487
488
#define INPUT_REPEAT_LONGTEXT N_( \
    "Number of time the same input will be repeated")
489

490
#define START_TIME_TEXT N_("Start time")
491
492
#define START_TIME_LONGTEXT N_( \
    "The stream will start at this position (in seconds)." )
493

494
#define STOP_TIME_TEXT N_("Stop time")
495
496
#define STOP_TIME_LONGTEXT N_( \
    "The stream will stop at this position (in seconds)." )
497

498
#define INPUT_LIST_TEXT N_("Input list")
499
500
501
#define INPUT_LIST_LONGTEXT N_( \
    "You can give a comma-separated list " \
    "of inputs that will be concatenated together after the normal one.")
502

503
#define INPUT_SLAVE_TEXT N_("Input slave (experimental)")
504
505
#define INPUT_SLAVE_LONGTEXT N_( \
    "This allows you to play from several inputs at " \
Rémi Denis-Courmont's avatar
Rémi Denis-Courmont committed
506
    "the same time. This feature is experimental, not all formats " \
507
    "are supported. Use a '#' separated list of inputs.")
508

gbazin's avatar
gbazin committed
509
#define BOOKMARKS_TEXT N_("Bookmarks list for a stream")
510
511
#define BOOKMARKS_LONGTEXT N_( \
    "You can manually give a list of bookmarks for a stream in " \
gbazin's avatar
gbazin committed
512
    "the form \"{name=bookmark-name,time=optional-time-offset," \
513
    "bytes=optional-byte-offset},{...}\"")
gbazin's avatar
gbazin committed
514

515
// DEPRECATED
516
517
#define SUB_CAT_LONGTEXT N_( \
    "These options allow you to modify the behavior of the subpictures " \
518
    "subsystem. You can for example enable subpictures filters (logo, etc.). " \
519
520
521
522
    "Enable these filters here and configure them in the " \
    "\"subpictures filters\" modules section. You can also set many " \
    "miscellaneous subpictures options." )

hartman's avatar
hartman committed
523
524
#define SUB_MARGIN_TEXT N_("Force subtitle position")
#define SUB_MARGIN_LONGTEXT N_( \
525
526
527
    "You can use this option to place the subtitles under the movie, " \
    "instead of over the movie. Try several positions.")

528
529
530
531
#define SPU_TEXT N_("Enable sub-pictures")
#define SPU_LONGTEXT N_( \
    "You can completely disable the sub-picture processing.")

532
533
534
#define OSD_TEXT N_("On Screen Display")
#define OSD_LONGTEXT N_( \
    "VLC can display messages on the video. This is called OSD (On Screen " \
535
    "Display).")
536

537
538
539
540
#define TEXTRENDERER_TEXT N_("Text rendering module")
#define TEXTRENDERER_LONGTEXT N_( \
    "VLC normally uses Freetype for rendering, but this allows you to use svg for instance.")

zorglub's avatar
zorglub committed
541
/// \bug typo arbitraty
542
543
#define SUB_FILTER_TEXT N_("Subpictures filter module")
#define SUB_FILTER_LONGTEXT N_( \
544
    "This adds so-called \"subpicture filters\". These filters overlay " \
545
    "some images or text over the video (like a logo, arbitraty text...)." )
546

547
#define SUB_AUTO_TEXT N_("Autodetect subtitle files")
548
549
#define SUB_AUTO_LONGTEXT N_( \
    "Automatically detect a subtitle file, if no subtitle filename is " \
550
    "specified (based on the filename of the movie).")
551

hartman's avatar
hartman committed
552
#define SUB_FUZZY_TEXT N_("Subtitle autodetection fuzziness")
553
554
#define SUB_FUZZY_LONGTEXT N_( \
    "This determines how fuzzy subtitle and movie filename matching " \
555
556
557
558
559
    "will be. Options are:\n" \
    "0 = no subtitles autodetected\n" \
    "1 = any subtitle file\n" \
    "2 = any subtitle file containing the movie name\n" \
    "3 = subtitle file matching the movie name with additional chars\n" \
Carlo Calabrò's avatar
Carlo Calabrò committed
560
    "4 = subtitle file matching the movie name exactly")
561

562
#define SUB_PATH_TEXT N_("Subtitle autodetection paths")
563
564
#define SUB_PATH_LONGTEXT N_( \
    "Look for a subtitle file in those paths too, if your subtitle " \
565
566
    "file was not found in the current directory.")

567
#define SUB_FILE_TEXT N_("Use subtitle file")
568
569
#define SUB_FILE_LONGTEXT N_( \
    "Load this subtitle file. To be used when autodetect cannot detect " \
Carlo Calabrò's avatar
Carlo Calabrò committed
570
    "your subtitle file.")
571
572

#define DVD_DEV_TEXT N_("DVD device")
gbazin's avatar
   
gbazin committed
573
574
575
#ifdef WIN32
#define DVD_DEV_LONGTEXT N_( \
    "This is the default DVD drive (or file) to use. Don't forget the colon " \
576
    "after the drive letter (eg. D:)")
gbazin's avatar
   
gbazin committed
577
#else
578
579
#define DVD_DEV_LONGTEXT N_( \
    "This is the default DVD device to use.")
gbazin's avatar
   
gbazin committed
580
#endif
581
582

#define VCD_DEV_TEXT N_("VCD device")
583
#ifdef HAVE_VCDX
584
#define VCD_DEV_LONGTEXT N_( \
585
586
587
588
589
590
    "This is the default VCD device to use. " \
    "If you don't specify anything, we'll scan for a suitable CD-ROM device." )
#else
#define VCD_DEV_LONGTEXT N_( \
    "This is the default VCD device to use." )
#endif
591

Sam Hocevar's avatar
Sam Hocevar committed
592
#define CDAUDIO_DEV_TEXT N_("Audio CD device")
593
#ifdef HAVE_CDDAX
yoann's avatar
yoann committed
594
#define CDAUDIO_DEV_LONGTEXT N_( \
Sam Hocevar's avatar
Sam Hocevar committed
595
    "This is the default Audio CD device to use. " \
596
597
598
    "If you don't specify anything, we'll scan for a suitable CD-ROM device." )
#else
#define CDAUDIO_DEV_LONGTEXT N_( \
Sam Hocevar's avatar
Sam Hocevar committed
599
    "This is the default Audio CD device to use." )
600
601
#endif

602
#define IPV6_TEXT N_("Force IPv6")
603
#define IPV6_LONGTEXT N_( \
604
    "IPv6 will be used by default for all connections.")
605

606
#define IPV4_TEXT N_("Force IPv4")
607
#define IPV4_LONGTEXT N_( \
608
    "IPv4 will be used by default for all connections.")
609

610
#define TIMEOUT_TEXT N_("TCP connection timeout")
611
#define TIMEOUT_LONGTEXT N_( \
612
    "Default TCP connection timeout (in milliseconds). " )
613

614
615
#define SOCKS_SERVER_TEXT N_("SOCKS server")
#define SOCKS_SERVER_LONGTEXT N_( \
616
617
    "SOCKS proxy server to use. This must be of the form " \
    "address:port. It will be used for all TCP connections" )
618
619

#define SOCKS_USER_TEXT N_("SOCKS user name")
620
621
#define SOCKS_USER_LONGTEXT N_( \
    "User name to be used for connection to the SOCKS proxy." )
622
623

#define SOCKS_PASS_TEXT N_("SOCKS password")
624
625
#define SOCKS_PASS_LONGTEXT N_( \
    "Password to be used for connection to the SOCKS proxy." )
626

gbazin's avatar
gbazin committed
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
#define META_TITLE_TEXT N_("Title metadata")
#define META_TITLE_LONGTEXT N_( \
     "Allows you to specify a \"title\" metadata for an input.")

#define META_AUTHOR_TEXT N_("Author metadata")
#define META_AUTHOR_LONGTEXT N_( \
     "Allows you to specify an \"author\" metadata for an input.")

#define META_ARTIST_TEXT N_("Artist metadata")
#define META_ARTIST_LONGTEXT N_( \
     "Allows you to specify an \"artist\" metadata for an input.")

#define META_GENRE_TEXT N_("Genre metadata")
#define META_GENRE_LONGTEXT N_( \
     "Allows you to specify a \"genre\" metadata for an input.")

#define META_CPYR_TEXT N_("Copyright metadata")
#define META_CPYR_LONGTEXT N_( \
     "Allows you to specify a \"copyright\" metadata for an input.")

#define META_DESCR_TEXT N_("Description metadata")
#define META_DESCR_LONGTEXT N_( \
     "Allows you to specify a \"description\" metadata for an input.")

#define META_DATE_TEXT N_("Date metadata")
#define META_DATE_LONGTEXT N_( \
     "Allows you to specify a \"date\" metadata for an input.")

#define META_URL_TEXT N_("URL metadata")
#define META_URL_LONGTEXT N_( \
     "Allows you to specify a \"url\" metadata for an input.")

659
// DEPRECATED
660
#define CODEC_CAT_LONGTEXT N_( \
gbazin's avatar
   
gbazin committed
661
662
    "This option can be used to alter the way VLC selects " \
    "its codecs (decompression methods). Only advanced users should " \
663
664
    "alter this option as it can break playback of all your streams." )

665
#define CODEC_TEXT N_("Preferred decoders list")
666
#define CODEC_LONGTEXT N_( \
667
    "List of codecs that VLC will use in " \
gbazin's avatar
   
gbazin committed
668
    "priority. For instance, 'dummy,a52' will try the dummy and a52 codecs " \
669
670
    "before trying the other ones. Only advanced users should " \
    "alter this option as it can break playback of all your streams." )
671

zorglub's avatar
zorglub committed
672
#define ENCODER_TEXT N_("Preferred encoders list")
gbazin's avatar
   
gbazin committed
673
674
#define ENCODER_LONGTEXT N_( \
    "This allows you to select a list of encoders that VLC will use in " \
675
    "priority.")
676

677
678
679
680
681
/*****************************************************************************
 * Sout
 ****************************************************************************/

// DEPRECATED
682
#define SOUT_CAT_LONGTEXT N_( \
gbazin's avatar
   
gbazin committed
683
    "These options allow you to set default global options for the " \
684
685
    "stream output subsystem." )

zorglub's avatar
zorglub committed
686
#define SOUT_TEXT N_("Default stream output chain")
687
#define SOUT_LONGTEXT N_( \
zorglub's avatar
zorglub committed
688
689
690
    "You can enter here a default stream output chain. Refer to "\
    "the documentation to learn how to build such chains." \
    "Warning: this chain will be enabled for all streams." )
gbazin's avatar
   
gbazin committed
691

692
693
#define SOUT_ALL_TEXT N_("Enable streaming of all ES")
#define SOUT_ALL_LONGTEXT N_( \
694
    "Stream all elementary streams (video, audio and subtitles)")
695

696
#define SOUT_DISPLAY_TEXT N_("Display while streaming")
697
#define SOUT_DISPLAY_LONGTEXT N_( \
698
    "Play locally the stream while streaming it.")
699

700
#define SOUT_VIDEO_TEXT N_("Enable video stream output")
gbazin's avatar
   
gbazin committed
701
#define SOUT_VIDEO_LONGTEXT N_( \
702
    "Choose whether the video stream should be redirected to " \
gbazin's avatar
   
gbazin committed
703
704
    "the stream output facility when this last one is enabled.")

705
#define SOUT_AUDIO_TEXT N_("Enable audio stream output")
gbazin's avatar
   
gbazin committed
706
#define SOUT_AUDIO_LONGTEXT N_( \
707
    "Choose whether the audio stream should be redirected to " \
gbazin's avatar
   
gbazin committed
708
709
    "the stream output facility when this last one is enabled.")

710
711
#define SOUT_SPU_TEXT N_("Enable SPU stream output")
#define SOUT_SPU_LONGTEXT N_( \
712
    "Choose whether the SPU streams should be redirected to " \
713
714
    "the stream output facility when this last one is enabled.")

715
#define SOUT_KEEP_TEXT N_("Keep stream output open" )
716
#define SOUT_KEEP_LONGTEXT N_( \
717
718
    "This allows you to keep an unique stream output instance across " \
    "multiple playlist item (automatically insert the gather stream output " \
719
    "if not specified)" )
720

zorglub's avatar
zorglub committed
721
#define PACKETIZER_TEXT N_("Preferred packetizer list")
722
#define PACKETIZER_LONGTEXT N_( \
723
    "This allows you to select the order in which VLC will choose its " \
724
    "packetizers."  )
gbazin's avatar
   
gbazin committed
725

726
#define MUX_TEXT N_("Mux module")
727
728
#define MUX_LONGTEXT N_( \
    "This is a legacy entry to let you configure mux modules")
gbazin's avatar
   
gbazin committed
729

730
#define ACCESS_OUTPUT_TEXT N_("Access output module")
731
732
733
#define ACCESS_OUTPUT_LONGTEXT N_( \
    "This is a legacy entry to let you configure access output modules")

zorglub's avatar
zorglub committed
734
#define ANN_SAPCTRL_TEXT N_("Control SAP flow")
735
736
#define ANN_SAPCTRL_LONGTEXT N_( \
    "If this option is enabled, the flow on " \
zorglub's avatar
zorglub committed
737
    "the SAP multicast address will be controlled. This is needed if you " \
738
    "want to make announcements on the MBone." )
zorglub's avatar
zorglub committed
739
740

#define ANN_SAPINTV_TEXT N_("SAP announcement interval")
741
742
#define ANN_SAPINTV_LONGTEXT N_( \
    "When the SAP flow control is disabled, " \
743
744
    "this lets you set the fixed interval between SAP announcements." )

zorglub's avatar
zorglub committed
745

746
747
748
749
750
/*****************************************************************************
 * Advanced
 ****************************************************************************/

// DEPRECATED
751
#define CPU_CAT_LONGTEXT N_( \
752
    "These options allow you to enable special CPU optimizations. " \
gbazin's avatar
   
gbazin committed
753
    "You should always leave all these enabled." )
754

755
756
757
758
759
#define FPU_TEXT N_("Enable FPU support")
#define FPU_LONGTEXT N_( \
    "If your processor has a floating point calculation unit, VLC can take " \
    "advantage of it.")

760
#define MMX_TEXT N_("Enable CPU MMX support")
761
#define MMX_LONGTEXT N_( \
762
    "If your processor supports the MMX instructions set, VLC can take " \
763
764
    "advantage of them.")

765
#define THREE_DN_TEXT N_("Enable CPU 3D Now! support")
766
#define THREE_DN_LONGTEXT N_( \
767
    "If your processor supports the 3D Now! instructions set, VLC can take " \
768
769
    "advantage of them.")

770
#define MMXEXT_TEXT N_("Enable CPU MMX EXT support")
771
#define MMXEXT_LONGTEXT N_( \
772
    "If your processor supports the MMX EXT instructions set, VLC can take " \
773
774
    "advantage of them.")

775
#define SSE_TEXT N_("Enable CPU SSE support")
776
#define SSE_LONGTEXT N_( \
777
    "If your processor supports the SSE instructions set, VLC can take " \
778
    "advantage of them.")
779

sigmunau's avatar
sigmunau committed
780
781
782
783
784
#define SSE2_TEXT N_("Enable CPU SSE2 support")
#define SSE2_LONGTEXT N_( \
    "If your processor supports the SSE2 instructions set, VLC can take " \
    "advantage of them.")

785
#define ALTIVEC_TEXT N_("Enable CPU AltiVec support")
786
#define ALTIVEC_LONGTEXT N_( \
787
    "If your processor supports the AltiVec instructions set, VLC can take " \
788
789
    "advantage of them.")

790
// DEPRECATED
791
#define MISC_CAT_LONGTEXT N_( \
gbazin's avatar
   
gbazin committed
792
    "These options allow you to select default modules. Leave these " \
793
794
    "alone unless you really know what you are doing." )

795
#define MEMCPY_TEXT N_("Memory copy module")
796
#define MEMCPY_LONGTEXT N_( \
797
798
    "You can select which memory copy module you want to use. By default " \
    "VLC will select the fastest one supported by your hardware.")
799

800
#define ACCESS_TEXT N_("Access module")
801
#define ACCESS_LONGTEXT N_( \
zorglub's avatar
zorglub committed
802
803
804
    "This allows you to force an access module. You can use it if " \
    "the correct access is not automatically detected. You should not "\
    "set this as a global option unless you really know what you are doing." )
805

806
807
#define ACCESS_FILTER_TEXT N_("Access filter module")
#define ACCESS_FILTER_LONGTEXT N_( \
808
809
    "Access filters are used to modify the stream that is being read. " \
    "This is used for instance for timeshifting.")
810

811
#define DEMUX_TEXT N_("Demux module")
812
#define DEMUX_LONGTEXT N_( \
813
814
815
816
    "Demultiplexers are used to separate the \"elementary\" streams " \
    "(like audio and video streams). You can use it if " \
    "the correct demuxer is not automatically detected. You should not "\
    "set this as a global option unless you really know what you are doing." )
817

zorglub's avatar
zorglub committed
818
#define RT_PRIORITY_TEXT N_("Allow real-time priority")
819
820
821
822
823
824
825
#define RT_PRIORITY_LONGTEXT N_( \
    "Running VLC in real-time priority will allow for much more precise " \
    "scheduling and yield better, especially when streaming content. " \
    "It can however lock up your whole machine, or make it very very " \
    "slow. You should only activate this if you know what you're " \
    "doing.")

826
827
#define RT_OFFSET_TEXT N_("Adjust VLC priority")
#define RT_OFFSET_LONGTEXT N_( \
Carlo Calabrò's avatar
Carlo Calabrò committed
828
    "This option adds an offset (positive or negative) to VLC default " \
829
830
831
    "priorities. You can use it to tune VLC priority against other " \
    "programs, or against other VLC instances.")

832
833
#define MINIMIZE_THREADS_TEXT N_("Minimize number of threads")
#define MINIMIZE_THREADS_LONGTEXT N_( \
834
     "This option minimizes the number of threads needed to run VLC.")
835

836
837
#define PLUGIN_PATH_TEXT N_("Modules search path")
#define PLUGIN_PATH_LONGTEXT N_( \
838
    "Additional path for VLC to look for its modules.")
839

dionoea's avatar
dionoea committed
840
841
#define VLM_CONF_TEXT N_("VLM configuration file")
#define VLM_CONF_LONGTEXT N_( \
842
    "Read a VLM configuration file as soon as VLM is started." )
dionoea's avatar
dionoea committed
843

844
845
#define PLUGINS_CACHE_TEXT N_("Use a plugins cache")
#define PLUGINS_CACHE_LONGTEXT N_( \