]> git.sesse.net Git - vlc/blob - modules/access/cdda/cdda.c
Add CD-DA CDDB support via libcddb.
[vlc] / modules / access / cdda / cdda.c
1 /*****************************************************************************
2  * cddax.c : CD digital audio input module for vlc using libcdio
3  *****************************************************************************
4  * Copyright (C) 2000,2003 VideoLAN
5  * $Id: cdda.c,v 1.3 2003/11/30 18:14:20 rocky Exp $
6  *
7  * Authors: Rocky Bernstein <rocky@panix.com> 
8  *          Laurent Aimar <fenrir@via.ecp.fr>
9  *          Gildas Bazin <gbazin@netcourrier.com>
10  *
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.
15  *
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.
20  *
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  *****************************************************************************/
25
26 /*****************************************************************************
27  * Preamble
28  *****************************************************************************/
29
30 #include <vlc/vlc.h>
31
32
33 /*****************************************************************************
34  * prototypes
35  *****************************************************************************/
36 int  E_(Open)         ( vlc_object_t * );
37 void E_(Close)        ( vlc_object_t * );
38
39 int  E_(OpenIntf)     ( vlc_object_t * );
40 void E_(CloseIntf)    ( vlc_object_t * );
41 int  E_(DemuxOpen)    ( vlc_object_t * p_this);
42 void E_(DemuxClose)   ( vlc_object_t * p_this);
43
44 int  E_(DebugCallback)       ( vlc_object_t *p_this, const char *psz_name,
45                                vlc_value_t oldval, vlc_value_t val, 
46                                void *p_data );
47
48 /*****************************************************************************
49  * Module descriptor
50  *****************************************************************************/
51
52 /*****************************************************************************
53  * Option help text
54  *****************************************************************************/
55
56 #define DEBUG_LONGTEXT N_( \
57     "This integer when viewed in binary is a debugging mask\n" \
58     "meta info        1\n" \
59     "events           2\n" \
60     "MRL              4\n" \
61     "external call    8\n" \
62     "all calls (10)  16\n" \
63     "LSN       (20)  32\n" \
64     "seek      (40)  64\n" \
65     "libcdio   (80) 128\n" \
66     "libcddb  (100) 256\n" )
67
68 #define DEV_LONGTEXT N_( \
69     "Specify the name of the CD-ROM device that will be used by default. " \
70     "If you don't specify anything, we'll scan for a suitable CD-ROM device.")
71
72 #define CACHING_LONGTEXT N_( \
73     "Allows you to modify the default caching value for cdda streams. This " \
74     "value should be set in millisecond units." )
75
76 /*****************************************************************************
77  * Module descriptor
78  *****************************************************************************/
79
80 vlc_module_begin();
81     add_usage_hint( N_("cddax://[device-or-file][@[T]num]") );
82     set_description( _("Compact Disc Digital Audio (CD-DA) input") );
83     set_capability( "access", 75 /* slightly higher than cdda */ );
84     set_callbacks( E_(Open), E_(Close) );
85     add_shortcut( "cdda" );
86     add_shortcut( "cddax" );
87
88     /* Configuration options */
89     add_category_hint( N_("CDX"), NULL, VLC_TRUE );
90
91     add_integer ( MODULE_STRING "-debug", 0, E_(DebugCallback), 
92                   N_("set debug mask for additional debugging."),
93                   DEBUG_LONGTEXT, VLC_TRUE );
94
95     add_integer( MODULE_STRING "-caching", 
96                  DEFAULT_PTS_DELAY / 1000, NULL, 
97                  N_("Caching value in ms"), 
98                  CACHING_LONGTEXT, VLC_TRUE );
99
100     add_string( MODULE_STRING "-device", "", NULL, 
101                 N_("CD-ROM device name"),
102                 DEV_LONGTEXT, VLC_FALSE );
103
104 #ifdef HAVE_LIBCDDB
105     add_bool( MODULE_STRING "-cddb-enabled", 1, NULL,
106               N_("Do CDDB lookups?"),
107               N_("If set, lookup CD-DA track information using the CDDB "
108                  "protocol"),
109               VLC_FALSE );
110
111     add_string( MODULE_STRING "-cddb-server", "freedb.freedb.org", NULL, 
112                 N_("CDDB server"), 
113                 N_( "Contact this CDDB server look up CD-DA information"),
114                  VLC_TRUE );
115
116     add_integer( MODULE_STRING "-cddb-port", 8880, NULL, 
117                  N_("CDDB server port"), 
118                  N_("CDDB server uses this port number to communicate on"), 
119                  VLC_TRUE );
120
121     add_string( MODULE_STRING "-cddb-email", "me@home", NULL, 
122                 N_("email address reported to CDDB server"), 
123                 N_("email address reported to CDDB server"), 
124                  VLC_TRUE );
125
126     add_bool( MODULE_STRING "-cddb-enable-cache", 1, NULL,
127               N_("Cache CDDB lookups?"),
128               N_("If set cache CDDB information about this CD"),
129               VLC_FALSE );
130
131     add_bool( MODULE_STRING "-cddb-httpd", 0, NULL,
132               N_("Contact CDDB via the HTTP protocol?"),
133               N_("If set, the CDDB server get information via the CDDB HTTP "
134                  "protocol"),
135               VLC_TRUE );
136
137     add_integer( MODULE_STRING "-cddb-timeout", 10, NULL, 
138                  N_("CDDB server timeout"), 
139                  N_("Time (in seconds) to wait for a response from the "
140                     "CDDB server"), 
141                  VLC_FALSE );
142
143     add_string( MODULE_STRING "-cddb-cachedir", "~/.cddbslave", NULL, 
144                 N_("Directory to cache CDDB requests"), 
145                 N_("Directory to cache CDDB requests"), 
146                  VLC_TRUE );
147
148 #endif
149
150     add_submodule();
151         set_description( _("CD Audio demux") );
152         set_capability( "demux", 0 );
153         set_callbacks( E_(DemuxOpen), E_(DemuxClose) );
154         add_shortcut( "cdda" );
155
156     add_submodule();
157         set_capability( "interface", 0 );
158         set_callbacks( E_(OpenIntf), E_(CloseIntf) );
159
160 vlc_module_end();