1 /*****************************************************************************
2 * cddax.c : CD digital audio input module for vlc using libcdio
3 *****************************************************************************
4 * Copyright (C) 2000, 2003, 2004 VideoLAN
7 * Authors: Rocky Bernstein <rocky@panix.com>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
22 *****************************************************************************/
24 /*****************************************************************************
26 *****************************************************************************/
31 /*****************************************************************************
33 *****************************************************************************/
35 /*****************************************************************************
37 *****************************************************************************/
39 #define DEBUG_LONGTEXT N_( \
40 "This integer when viewed in binary is a debugging mask\n" \
45 "all calls (0x10) 16\n" \
48 "libcdio (0x80) 128\n" \
49 "libcddb (0x100) 256\n" )
51 #define CACHING_LONGTEXT N_( \
52 "Allows you to modify the default caching value for CDDA streams. This " \
53 "value should be set in millisecond units." )
55 #define BLOCKS_PER_READ_LONGTEXT N_( \
56 "Allows you to specify how many CD blocks to get on a single CD read. " \
57 "Generally on newer/faster CD's, this increases throughput at the " \
58 "expense of a little more memory usage and initial delay. SCSI-MMC " \
59 "limitations generally don't allow for more than 25 blocks per access.")
61 #define CDDB_TITLE_FMT_LONGTEXT N_( \
62 "Format used in the GUI Playlist Title. Similar to the Unix date \n" \
63 "Format specifiers that start with a percent sign. Specifiers are: \n" \
64 " %a : The artist (for the album)\n" \
65 " %A : The album information\n" \
67 " %e : The extended data (for a track)\n" \
68 " %I : CDDB disk ID\n" \
70 " %M : The current MRL\n" \
71 " %m : The CD-DA Media Catalog Number (MCN)\n" \
72 " %n : The number of tracks on the CD\n" \
73 " %p : The artist/performer/composer in the track\n" \
74 " %T : The track number\n" \
75 " %s : Number of seconds in this track \n" \
77 " %Y : The year 19xx or 20xx\n" \
80 #define TITLE_FMT_LONGTEXT N_( \
81 "Format used in the GUI Playlist Title. Similar to the Unix date \n" \
82 "Format specifiers that start with a percent sign. Specifiers are: \n" \
83 " %M : The current MRL\n" \
84 " %m : The CD-DA Media Catalog Number (MCN)\n" \
85 " %n : The number of tracks on the CD\n" \
86 " %T : The track number\n" \
87 " %s : Number of seconds in this track \n" \
90 /*****************************************************************************
92 *****************************************************************************/
95 add_usage_hint( N_("cddax://[device-or-file][@[T]track]") );
96 set_description( _("Compact Disc Digital Audio (CD-DA) input") );
97 set_capability( "access2", 10 /* compare with priority of cdda */ );
98 set_callbacks( E_(CDDAOpen), E_(CDDAClose) );
99 add_shortcut( "cddax" );
100 add_shortcut( "cd" );
102 /* Configuration options */
103 add_integer ( MODULE_STRING "-debug", 0, E_(CDDADebugCB),
104 N_("If nonzero, this gives additional debug information."),
105 DEBUG_LONGTEXT, VLC_TRUE );
107 add_integer( MODULE_STRING "-caching",
108 DEFAULT_PTS_DELAY / MILLISECONDS_PER_SEC, NULL,
109 N_("Caching value in microseconds"),
110 CACHING_LONGTEXT, VLC_TRUE );
112 add_integer( MODULE_STRING "-blocks-per-read",
113 DEFAULT_BLOCKS_PER_READ, E_(CDDABlocksPerReadCB),
114 N_("Number of blocks per CD read"),
115 BLOCKS_PER_READ_LONGTEXT, VLC_TRUE );
117 add_string( MODULE_STRING "-author-format",
118 "%A - %a %C %I", NULL,
119 N_("Format to use in playlist \"author\" field"),
120 TITLE_FMT_LONGTEXT, VLC_TRUE );
122 add_string( MODULE_STRING "-title-format",
124 N_("Format to use in playlist \"title\" field when no CDDB"),
125 TITLE_FMT_LONGTEXT, VLC_TRUE );
128 add_string( MODULE_STRING "-cddb-title-format",
129 "Track %T. %t - %p", NULL,
130 N_("Format to use in playlist \"title\" field when using CDDB"),
131 CDDB_TITLE_FMT_LONGTEXT, VLC_TRUE );
133 add_bool( MODULE_STRING "-cddb-enabled", 1, E_(CDDBEnabledCB),
134 N_("Do CDDB lookups?"),
135 N_("If set, lookup CD-DA track information using the CDDB "
139 add_string( MODULE_STRING "-cddb-server", "freedb.freedb.org", NULL,
141 N_( "Contact this CDDB server look up CD-DA information"),
144 add_integer( MODULE_STRING "-cddb-port", 8880, NULL,
145 N_("CDDB server port"),
146 N_("CDDB server uses this port number to communicate on"),
149 add_string( MODULE_STRING "-cddb-email", "me@home", NULL,
150 N_("email address reported to CDDB server"),
151 N_("email address reported to CDDB server"),
154 add_bool( MODULE_STRING "-cddb-enable-cache", VLC_TRUE, NULL,
155 N_("Cache CDDB lookups?"),
156 N_("If set cache CDDB information about this CD"),
159 add_bool( MODULE_STRING "-cddb-httpd", VLC_FALSE, NULL,
160 N_("Contact CDDB via the HTTP protocol?"),
161 N_("If set, the CDDB server gets information via the CDDB HTTP "
165 add_integer( MODULE_STRING "-cddb-timeout", 10, NULL,
166 N_("CDDB server timeout"),
167 N_("Time (in seconds) to wait for a response from the "
171 add_string( MODULE_STRING "-cddb-cachedir", "~/.cddbslave", NULL,
172 N_("Directory to cache CDDB requests"),
173 N_("Directory to cache CDDB requests"),
176 add_bool( MODULE_STRING "-cdtext-prefer", VLC_TRUE, E_(CDTextPreferCB),
177 N_("Prefer CD-Text info to CDDB info?"),
178 N_("If set, CD-Text information will be preferred "
179 "to CDDB information when both are available"),
184 add_bool( MODULE_STRING "-cdtext-enabled", VLC_TRUE, E_(CDTextEnabledCB),
185 N_("Do CD-Text lookups?"),
186 N_("If set, get CD-Text information"),