]> git.sesse.net Git - vlc/blobdiff - src/libvlc.c
- Updated French translation (still a lot of work to do...)
[vlc] / src / libvlc.c
index 3d52bdf29f9666dc3fa4becabf2f189ed2eb18eb..ef9d88f4b2e49e032d83ee216521f68ad7acda27 100644 (file)
@@ -2,7 +2,7 @@
  * libvlc.c: main libvlc source
  *****************************************************************************
  * Copyright (C) 1998-2002 VideoLAN
- * $Id: libvlc.c,v 1.37 2002/10/08 18:10:09 sam Exp $
+ * $Id: libvlc.c,v 1.102 2003/11/23 18:31:55 alexis Exp $
  *
  * Authors: Vincent Seguin <seguin@via.ecp.fr>
  *          Samuel Hocevar <sam@zoy.org>
 /*****************************************************************************
  * Preamble
  *****************************************************************************/
-#include <errno.h>                                                 /* ENOMEM */
+#include <vlc/vlc.h>
+
+#ifdef HAVE_ERRNO_H
+#   include <errno.h>                                              /* ENOMEM */
+#endif
 #include <stdio.h>                                              /* sprintf() */
 #include <string.h>                                            /* strerror() */
 #include <stdlib.h>                                                /* free() */
 
-#include <vlc/vlc.h>
-
 #ifndef WIN32
 #   include <netinet/in.h>                            /* BSD: struct in_addr */
 #endif
 
 #ifdef HAVE_UNISTD_H
 #   include <unistd.h>
-#elif defined( _MSC_VER ) && defined( _WIN32 )
+#elif defined( WIN32 ) && !defined( UNDER_CE )
 #   include <io.h>
 #endif
 
 #ifdef WIN32                       /* optind, getopt(), included in unistd.h */
-#   include "extras/GNUgetopt/getopt.h"
+#   include "extras/getopt.h"
 #endif
 
 #ifdef HAVE_LOCALE_H
 #include "vlc_cpu.h"                                        /* CPU detection */
 #include "os_specific.h"
 
-#include "netutils.h"                                 /* network_ChannelJoin */
+#include "vlc_error.h"
 
 #include "stream_control.h"
 #include "input_ext-intf.h"
 
 #include "vlc_playlist.h"
-#include "interface.h"
+#include "vlc_interface.h"
 
 #include "audio_output.h"
 
-#include "video.h"
+#include "vlc_video.h"
 #include "video_output.h"
 
 #include "libvlc.h"
 /*****************************************************************************
  * The evil global variable. We handle it with care, don't worry.
  *****************************************************************************/
-static libvlc_t libvlc;
-
-//#define GLOBAL_VLC NULL
-#define GLOBAL_VLC ((vlc_t*)libvlc.pp_children[1])
+static libvlc_t   libvlc;
+static libvlc_t * p_libvlc;
+static vlc_t *    p_static_vlc;
 
 /*****************************************************************************
  * Local prototypes
  *****************************************************************************/
+static void SetLanguage   ( char const * );
 static int  GetFilenames  ( vlc_t *, int, char *[] );
-static void Usage         ( vlc_t *, const char *psz_module_name );
+static void Usage         ( vlc_t *, char const *psz_module_name );
 static void ListModules   ( vlc_t * );
 static void Version       ( void );
 
 #ifdef WIN32
 static void ShowConsole   ( void );
 #endif
+static int  ConsoleWidth  ( void );
+
 
 /*****************************************************************************
- * vlc_create: allocate a vlc_t structure, and initialize libvlc if needed.
+ * vlc_current_object: return the current object.
  *****************************************************************************
- * This function allocates a vlc_t structure and returns NULL in case of
- * failure. Also, the thread system is initialized.
+ * If i_object is non-zero, return the corresponding object. Otherwise,
+ * return the statically allocated p_vlc object.
  *****************************************************************************/
-vlc_error_t vlc_create( void )
+vlc_t * vlc_current_object( int i_object )
 {
-    vlc_t * p_vlc;
-    vlc_bool_t b_failed = VLC_FALSE;
-
-    /* This call should be thread-safe, but an additional check will be
-     * necessary afterwards to check that only one p_vlc is created. */
-    p_vlc = vlc_create_r();
-
-    if( p_vlc == NULL )
+    if( i_object )
     {
-        return VLC_EGENERIC;
+         return vlc_object_get( p_libvlc, i_object );
     }
 
-    /* We have created an object, which ensures us that p_global_lock has
-     * been properly initialized. We can now atomically check that we are
-     * the only p_vlc object. */
-#if 0
-    vlc_mutex_lock( libvlc.p_global_lock );
-    if( libvlc.i_children != 1 ) /* FIXME !!! FIXME */
-    {
-        b_failed = VLC_TRUE;
-    }
-    vlc_mutex_unlock( libvlc.p_global_lock );
-#endif
+    return p_static_vlc;
+}
 
-    /* There can be only one */
-    if( b_failed )
-    {
-        vlc_destroy_r( p_vlc );
-        return VLC_EGENERIC;
-    }
+/*****************************************************************************
+ * VLC_Version: return the libvlc version.
+ *****************************************************************************
+ * This function returns full version string (numeric version and codename).
+ *****************************************************************************/
+char const * VLC_Version( void )
+{
+    return VERSION_MESSAGE;
+}
 
-    return VLC_SUCCESS;
+/*****************************************************************************
+ * VLC_Error: strerror() equivalent
+ *****************************************************************************
+ * This function returns full version string (numeric version and codename).
+ *****************************************************************************/
+char const * VLC_Error( int i_err )
+{
+    return vlc_error( i_err );
 }
 
-vlc_t * vlc_create_r( void )
+/*****************************************************************************
+ * VLC_Create: allocate a vlc_t structure, and initialize libvlc if needed.
+ *****************************************************************************
+ * This function allocates a vlc_t structure and returns a negative value
+ * in case of failure. Also, the thread system is initialized.
+ *****************************************************************************/
+int VLC_Create( void )
 {
     int i_ret;
     vlc_t * p_vlc = NULL;
-    vlc_mutex_t * p_libvlc_lock;
+    vlc_value_t lockval;
+
+    /* &libvlc never changes, so we can safely call this multiple times. */
+    p_libvlc = &libvlc;
 
     /* vlc_threads_init *must* be the first internal call! No other call is
      * allowed before the thread system has been initialized. */
-    i_ret = vlc_threads_init( &libvlc );
-    if( i_ret )
+    i_ret = vlc_threads_init( p_libvlc );
+    if( i_ret < 0 )
     {
-        return NULL;
+        return i_ret;
     }
 
     /* Now that the thread system is initialized, we don't have much, but
-     * at least we have vlc_mutex_need */
-    p_libvlc_lock = vlc_mutex_need( &libvlc, "libvlc" );
-    vlc_mutex_lock( p_libvlc_lock );
+     * at least we have var_Create */
+    var_Create( p_libvlc, "libvlc", VLC_VAR_MUTEX );
+    var_Get( p_libvlc, "libvlc", &lockval );
+    vlc_mutex_lock( lockval.p_address );
     if( !libvlc.b_ready )
     {
         char *psz_env;
@@ -167,54 +175,54 @@ vlc_t * vlc_create_r( void )
         psz_env = getenv( "VLC_VERBOSE" );
         libvlc.i_verbose = psz_env ? atoi( psz_env ) : -1;
 
-#ifdef HAVE_ISATTY
+#if defined( HAVE_ISATTY ) && !defined( WIN32 )
         libvlc.b_color = isatty( 2 ); /* 2 is for stderr */
 #else
         libvlc.b_color = VLC_FALSE;
 #endif
 
         /* Initialize message queue */
-        msg_Create( &libvlc );
+        msg_Create( p_libvlc );
 
         /* Announce who we are */
-        msg_Dbg( &libvlc, COPYRIGHT_MESSAGE );
-        msg_Dbg( &libvlc, "libvlc was configured with %s", CONFIGURE_LINE );
+        msg_Dbg( p_libvlc, COPYRIGHT_MESSAGE );
+        msg_Dbg( p_libvlc, "libvlc was configured with %s", CONFIGURE_LINE );
 
-        /* Initialize the module bank and load the configuration of the
-         * main module. We need to do this at this stage to be able to display
-         * a short help if required by the user. (short help == main module
-         * options) */
-        module_InitBank( &libvlc );
-        module_LoadMain( &libvlc );
+        /* The module bank will be initialized later */
+        libvlc.p_module_bank = NULL;
 
         libvlc.b_ready = VLC_TRUE;
     }
-    vlc_mutex_unlock( p_libvlc_lock );
-    vlc_mutex_unneed( &libvlc, "libvlc" );
+    vlc_mutex_unlock( lockval.p_address );
+    var_Destroy( p_libvlc, "libvlc" );
 
     /* Allocate a vlc object */
-    p_vlc = vlc_object_create( &libvlc, VLC_OBJECT_VLC );
+    p_vlc = vlc_object_create( p_libvlc, VLC_OBJECT_VLC );
     if( p_vlc == NULL )
     {
-        return NULL;
+        return VLC_EGENERIC;
     }
+    vlc_thread_set_priority( p_vlc, VLC_THREAD_PRIORITY_LOW );
 
     p_vlc->psz_object_name = "root";
 
     /* Initialize mutexes */
     vlc_mutex_init( p_vlc, &p_vlc->config_lock );
+#ifdef SYS_DARWIN
+    vlc_mutex_init( p_vlc, &p_vlc->quicktime_lock );
+#endif
 
     /* Store our newly allocated structure in the global list */
-    vlc_object_attach( p_vlc, &libvlc );
+    vlc_object_attach( p_vlc, p_libvlc );
 
-    /* Update the handle status */
-    p_vlc->i_status = VLC_STATUS_CREATED;
+    /* Store data for the non-reentrant API */
+    p_static_vlc = p_vlc;
 
-    return p_vlc;
+    return p_vlc->i_object_id;
 }
 
 /*****************************************************************************
- * vlc_init: initialize a vlc_t structure.
+ * VLC_Init: initialize a vlc_t structure.
  *****************************************************************************
  * This function initializes a previously allocated vlc_t structure:
  *  - CPU detection
@@ -222,46 +230,24 @@ vlc_t * vlc_create_r( void )
  *  - message queue, module bank and playlist initialization
  *  - configuration and commandline parsing
  *****************************************************************************/
-vlc_error_t vlc_init( int i_argc, char *ppsz_argv[] )
-{
-    return vlc_init_r( GLOBAL_VLC, i_argc, ppsz_argv );
-}
-
-vlc_error_t vlc_init_r( vlc_t *p_vlc, int i_argc, char *ppsz_argv[] )
+int VLC_Init( int i_object, int i_argc, char *ppsz_argv[] )
 {
     char         p_capabilities[200];
     char *       p_tmp;
-    vlc_bool_t   b_exit;
+    char *       psz_modules;
+    char *       psz_parser;
+    char *       psz_language;
+    vlc_bool_t   b_exit = VLC_FALSE;
+    vlc_t *      p_vlc = vlc_current_object( i_object );
     module_t    *p_help_module;
     playlist_t  *p_playlist;
+    vlc_value_t  lockval;
 
-    /* Check that the handle is valid */
-    if( !p_vlc || p_vlc->i_status != VLC_STATUS_CREATED )
-    {
-        fprintf( stderr, "error: invalid status (!CREATED)\n" );
-        return VLC_ESTATUS;
-    }
-
-    /* Support for gettext */
-#if defined( ENABLE_NLS ) && defined ( HAVE_GETTEXT )
-#   if defined( HAVE_LOCALE_H ) && defined( HAVE_LC_MESSAGES )
-    if( !setlocale( LC_MESSAGES, "" ) )
-    {
-        fprintf( stderr, "warning: unsupported locale settings\n" );
-    }
-
-    setlocale( LC_CTYPE, "" );
-#   endif
-
-    if( !bindtextdomain( PACKAGE, LOCALEDIR ) )
+    if( !p_vlc )
     {
-        fprintf( stderr, "warning: no domain %s in directory %s\n",
-                 PACKAGE, LOCALEDIR );
+        return VLC_ENOOBJ;
     }
 
-    textdomain( PACKAGE );
-#endif
-
     /*
      * System specific initialization code
      */
@@ -282,11 +268,35 @@ vlc_error_t vlc_init_r( vlc_t *p_vlc, int i_argc, char *ppsz_argv[] )
         p_vlc->psz_object_name = "vlc";
     }
 
+    /*
+     * Support for gettext
+     */
+    SetLanguage( "" );
+
+    /* Translate "C" to the language code: "fr", "en_GB", "nl", "ru"... */
+    msg_Dbg( p_vlc, "translation test: code is \"%s\"", _("C") );
+
+    /* Initialize the module bank and load the configuration of the
+     * main module. We need to do this at this stage to be able to display
+     * a short help if required by the user. (short help == main module
+     * options) */
+    var_Create( p_libvlc, "libvlc", VLC_VAR_MUTEX );
+    var_Get( p_libvlc, "libvlc", &lockval );
+    vlc_mutex_lock( lockval.p_address );
+    if( libvlc.p_module_bank == NULL )
+    {
+        module_InitBank( p_libvlc );
+        module_LoadMain( p_libvlc );
+    }
+    vlc_mutex_unlock( lockval.p_address );
+    var_Destroy( p_libvlc, "libvlc" );
+
     /* Hack: insert the help module here */
     p_help_module = vlc_object_create( p_vlc, VLC_OBJECT_MODULE );
     if( p_help_module == NULL )
     {
-        //module_EndBank( p_vlc );
+        /*module_EndBank( p_vlc );*/
+        if( i_object ) vlc_object_release( p_vlc );
         return VLC_EGENERIC;
     }
     p_help_module->psz_object_name = "help";
@@ -299,16 +309,15 @@ vlc_error_t vlc_init_r( vlc_t *p_vlc, int i_argc, char *ppsz_argv[] )
         vlc_object_detach( p_help_module );
         config_Free( p_help_module );
         vlc_object_destroy( p_help_module );
-        //module_EndBank( p_vlc );
+        /*module_EndBank( p_vlc );*/
+        if( i_object ) vlc_object_release( p_vlc );
         return VLC_EGENERIC;
     }
 
-    b_exit = VLC_FALSE;
-
     /* Check for short help option */
     if( config_GetInt( p_vlc, "help" ) )
     {
-        fprintf( stderr, _("Usage: %s [options] [items]...\n\n"),
+        fprintf( stdout, _("Usage: %s [options] [items]...\n\n"),
                          p_vlc->psz_object_name );
         Usage( p_vlc, "main" );
         Usage( p_vlc, "help" );
@@ -321,6 +330,10 @@ vlc_error_t vlc_init_r( vlc_t *p_vlc, int i_argc, char *ppsz_argv[] )
         b_exit = VLC_TRUE;
     }
 
+    /* Set the config file stuff */
+    p_vlc->psz_homedir = config_GetHomeDir();
+    p_vlc->psz_configfile = config_GetPsz( p_vlc, "config" );
+
     /* Hack: remove the help module here */
     vlc_object_detach( p_help_module );
     /* End hack */
@@ -329,18 +342,55 @@ vlc_error_t vlc_init_r( vlc_t *p_vlc, int i_argc, char *ppsz_argv[] )
     {
         config_Free( p_help_module );
         vlc_object_destroy( p_help_module );
-        //module_EndBank( p_vlc );
+        /*module_EndBank( p_vlc );*/
+        if( i_object ) vlc_object_release( p_vlc );
         return VLC_EEXIT;
     }
 
+    /* Check for translation config option */
+#if defined( ENABLE_NLS ) \
+     && ( defined( HAVE_GETTEXT ) || defined( HAVE_INCLUDED_GETTEXT ) )
+
+    /* This ain't really nice to have to reload the config here but it seems
+     * the only way to do it. */
+    config_LoadConfigFile( p_vlc, "main" );
+    config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_TRUE );
+
+    /* Check if the user specified a custom language */
+    psz_language = config_GetPsz( p_vlc, "language" );
+    if( psz_language && *psz_language && strcmp( psz_language, "auto" ) )
+    {
+        /* Reset the default domain */
+        SetLanguage( psz_language );
+
+        /* Translate "C" to the language code: "fr", "en_GB", "nl", "ru"... */
+        msg_Dbg( p_vlc, "translation test: code is \"%s\"", _("C") );
+
+        textdomain( PACKAGE );
+
+#if defined( SYS_BEOS ) || defined ( SYS_DARWIN ) || \
+    ( defined( WIN32 ) && !defined( HAVE_INCLUDED_GETTEXT ) )
+        /* BeOS only support UTF8 strings */
+        /* Mac OS X prefers UTF8 */
+        bind_textdomain_codeset( PACKAGE, "UTF-8" );
+#endif
+
+        module_EndBank( p_vlc );
+        module_InitBank( p_libvlc );
+        module_LoadMain( p_libvlc );
+        config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_TRUE );
+    }
+    if( psz_language ) free( psz_language );
+#endif
+
     /*
      * Load the builtins and plugins into the module_bank.
      * We have to do it before config_Load*() because this also gets the
      * list of configuration options exported by each module and loads their
      * default values.
      */
-    module_LoadBuiltins( &libvlc );
-    module_LoadPlugins( &libvlc );
+    module_LoadBuiltins( p_libvlc );
+    module_LoadPlugins( p_libvlc );
     msg_Dbg( p_vlc, "module bank initialized, found %i modules",
                     libvlc.p_module_bank->i_children );
 
@@ -368,24 +418,46 @@ vlc_error_t vlc_init_r( vlc_t *p_vlc, int i_argc, char *ppsz_argv[] )
         b_exit = VLC_TRUE;
     }
 
+    /* Check for config file options */
+    if( config_GetInt( p_vlc, "reset-config" ) )
+    {
+        vlc_object_detach( p_help_module );
+        config_ResetAll( p_vlc );
+        config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_TRUE );
+        config_SaveConfigFile( p_vlc, NULL );
+        vlc_object_attach( p_help_module, libvlc.p_module_bank );
+    }
+    if( config_GetInt( p_vlc, "save-config" ) )
+    {
+        vlc_object_detach( p_help_module );
+        config_LoadConfigFile( p_vlc, NULL );
+        config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_TRUE );
+        config_SaveConfigFile( p_vlc, NULL );
+        vlc_object_attach( p_help_module, libvlc.p_module_bank );
+    }
+
     /* Hack: remove the help module here */
     vlc_object_detach( p_help_module );
-    config_Free( p_help_module );
-    vlc_object_destroy( p_help_module );
     /* End hack */
 
     if( b_exit )
     {
-        //module_EndBank( p_vlc );
+        config_Free( p_help_module );
+        vlc_object_destroy( p_help_module );
+        /*module_EndBank( p_vlc );*/
+        if( i_object ) vlc_object_release( p_vlc );
         return VLC_EEXIT;
     }
 
     /*
      * Override default configuration with config file settings
      */
-    p_vlc->psz_homedir = config_GetHomeDir();
     config_LoadConfigFile( p_vlc, NULL );
 
+    /* Hack: insert the help module here */
+    vlc_object_attach( p_help_module, libvlc.p_module_bank );
+    /* End hack */
+
     /*
      * Override configuration with command line settings
      */
@@ -398,14 +470,24 @@ vlc_error_t vlc_init_r( vlc_t *p_vlc, int i_argc, char *ppsz_argv[] )
                  "that they are valid.\nPress the RETURN key to continue..." );
         getchar();
 #endif
-        //module_EndBank( p_vlc );
+        vlc_object_detach( p_help_module );
+        config_Free( p_help_module );
+        vlc_object_destroy( p_help_module );
+        /*module_EndBank( p_vlc );*/
+        if( i_object ) vlc_object_release( p_vlc );
         return VLC_EGENERIC;
     }
 
+    /* Hack: remove the help module here */
+    vlc_object_detach( p_help_module );
+    config_Free( p_help_module );
+    vlc_object_destroy( p_help_module );
+    /* End hack */
+
     /*
      * System specific configuration
      */
-    system_Configure( p_vlc );
+    system_Configure( p_vlc, &i_argc, ppsz_argv );
 
     /*
      * Message queue options
@@ -422,15 +504,14 @@ vlc_error_t vlc_init_r( vlc_t *p_vlc, int i_argc, char *ppsz_argv[] )
             libvlc.i_verbose = __MIN( i_tmp, 2 );
         }
     }
-    libvlc.b_color = libvlc.b_color || config_GetInt( p_vlc, "color" );
+    libvlc.b_color = libvlc.b_color && config_GetInt( p_vlc, "color" );
 
     /*
      * Output messages that may still be in the queue
      */
     msg_Flush( p_vlc );
 
-    /* p_vlc inititalization. FIXME ? */
-    p_vlc->i_desync = config_GetInt( p_vlc, "desync" ) * (mtime_t)1000;
+    /* p_vlc initialization. FIXME ? */
 
 #if defined( __i386__ )
     if( !config_GetInt( p_vlc, "mmx" ) )
@@ -483,16 +564,12 @@ vlc_error_t vlc_init_r( vlc_t *p_vlc, int i_argc, char *ppsz_argv[] )
     }
 
     /*
-     * Initialize shared resources and libraries
+     * Initialize hotkey handling
      */
-    if( config_GetInt( p_vlc, "network-channel" )
-         && network_ChannelCreate( p_vlc ) )
-    {
-        /* On error during Channels initialization, switch off channels */
-        msg_Warn( p_vlc,
-                  "channels initialization failed, deactivating channels" );
-        config_PutInt( p_vlc, "network-channel", VLC_FALSE );
-    }
+    var_Create( p_vlc, "key-pressed", VLC_VAR_INTEGER );
+    p_vlc->p_hotkeys = malloc( sizeof(p_hotkeys) );
+    /* Do a copy (we don't need to modify the strings) */
+    p_vlc->p_hotkeys = p_hotkeys;
 
     /*
      * Initialize playlist and get commandline files
@@ -505,225 +582,216 @@ vlc_error_t vlc_init_r( vlc_t *p_vlc, int i_argc, char *ppsz_argv[] )
         {
             module_Unneed( p_vlc, p_vlc->p_memcpy_module );
         }
-        //module_EndBank( p_vlc );
+        /*module_EndBank( p_vlc );*/
+        if( i_object ) vlc_object_release( p_vlc );
         return VLC_EGENERIC;
     }
 
-    /* Update the handle status */
-    p_vlc->i_status = VLC_STATUS_STOPPED;
+    /*
+     * Load background interfaces
+     */
+    psz_modules = config_GetPsz( p_vlc, "extraintf" );
+    psz_parser = psz_modules;
+    while ( psz_parser && *psz_parser )
+    {
+        char *psz_module, *psz_temp;
+        psz_module = psz_parser;
+        psz_parser = strchr( psz_module, ',' );
+        if ( psz_parser )
+        {
+            *psz_parser = '\0';
+            psz_parser++;
+        }
+        psz_temp = (char *)malloc( strlen(psz_module) + sizeof(",none") );
+        if( psz_temp )
+        {
+            sprintf( psz_temp, "%s,none", psz_module );
+            VLC_AddIntf( 0, psz_temp, VLC_FALSE );
+            free( psz_temp );
+        }
+    }
+    if ( psz_modules )
+    {
+        free( psz_modules );
+    }
+
+    /*
+     * Allways load the hotkeys interface if it exists
+     */
+    VLC_AddIntf( 0, "hotkeys,none", VLC_FALSE );
+
+    /*
+     * FIXME: kludge to use a p_vlc-local variable for the Mozilla plugin
+     */
+    var_Create( p_vlc, "drawable", VLC_VAR_INTEGER );
+    var_Create( p_vlc, "drawableredraw", VLC_VAR_INTEGER );
+    var_Create( p_vlc, "drawablet", VLC_VAR_INTEGER );
+    var_Create( p_vlc, "drawablel", VLC_VAR_INTEGER );
+    var_Create( p_vlc, "drawableb", VLC_VAR_INTEGER );
+    var_Create( p_vlc, "drawabler", VLC_VAR_INTEGER );
+    var_Create( p_vlc, "drawablex", VLC_VAR_INTEGER );
+    var_Create( p_vlc, "drawabley", VLC_VAR_INTEGER );
+    var_Create( p_vlc, "drawablew", VLC_VAR_INTEGER );
+    var_Create( p_vlc, "drawableh", VLC_VAR_INTEGER );
+    var_Create( p_vlc, "drawableportx", VLC_VAR_INTEGER );
+    var_Create( p_vlc, "drawableporty", VLC_VAR_INTEGER );
 
     /*
      * Get input filenames given as commandline arguments
      */
     GetFilenames( p_vlc, i_argc, ppsz_argv );
 
+    if( i_object ) vlc_object_release( p_vlc );
     return VLC_SUCCESS;
 }
 
 /*****************************************************************************
- * vlc_add_intf: add an interface
+ * VLC_AddIntf: add an interface
  *****************************************************************************
  * This function opens an interface plugin and runs it. If b_block is set
- * to 0, vlc_add_intf will return immediately and let the interface run in a
- * separate thread. If b_block is set to 1, vlc_add_intf will continue until
+ * to 0, VLC_AddIntf will return immediately and let the interface run in a
+ * separate thread. If b_block is set to 1, VLC_AddIntf will continue until
  * user requests to quit.
  *****************************************************************************/
-vlc_error_t vlc_add_intf( const char *psz_module, vlc_bool_t b_block )
+int VLC_AddIntf( int i_object, char const *psz_module, vlc_bool_t b_block )
 {
-    return vlc_add_intf_r( GLOBAL_VLC,
-                           psz_module, b_block );
-}
-
-vlc_error_t vlc_add_intf_r( vlc_t *p_vlc, const char *psz_module,
-                                          vlc_bool_t b_block )
-{
-    vlc_error_t err;
+    int i_err;
     intf_thread_t *p_intf;
-    char *psz_oldmodule = NULL;
-
-    /* Check that the handle is valid */
-    if( !p_vlc || p_vlc->i_status != VLC_STATUS_RUNNING )
-    {
-        fprintf( stderr, "error: invalid status (!RUNNING)\n" );
-        return VLC_ESTATUS;
-    }
+    vlc_t *p_vlc = vlc_current_object( i_object );
 
-    if( psz_module )
+    if( !p_vlc )
     {
-        psz_oldmodule = config_GetPsz( p_vlc, "intf" );
-        config_PutPsz( p_vlc, "intf", psz_module );
+        return VLC_ENOOBJ;
     }
 
     /* Try to create the interface */
-    p_intf = intf_Create( p_vlc );
-
-    if( psz_module )
-    {
-        config_PutPsz( p_vlc, "intf", psz_oldmodule );
-        if( psz_oldmodule )
-        {
-            free( psz_oldmodule );
-        }
-    }
+    p_intf = intf_Create( p_vlc, psz_module ? psz_module : "$intf" );
 
     if( p_intf == NULL )
     {
-        msg_Err( p_vlc, "interface initialization failed" );
+        msg_Err( p_vlc, "interface \"%s\" initialization failed", psz_module );
+        if( i_object ) vlc_object_release( p_vlc );
         return VLC_EGENERIC;
     }
 
     /* Try to run the interface */
     p_intf->b_block = b_block;
-    err = intf_RunThread( p_intf );
-    if( err )
+    i_err = intf_RunThread( p_intf );
+    if( i_err )
     {
         vlc_object_detach( p_intf );
         intf_Destroy( p_intf );
-        return err;
+        if( i_object ) vlc_object_release( p_vlc );
+        return i_err;
     }
 
+    if( i_object ) vlc_object_release( p_vlc );
     return VLC_SUCCESS;
 }
 
 /*****************************************************************************
- * vlc_destroy: stop playing and destroy everything.
+ * VLC_Destroy: stop playing and destroy everything.
  *****************************************************************************
  * This function requests the running threads to finish, waits for their
  * termination, and destroys their structure.
  *****************************************************************************/
-vlc_error_t vlc_destroy( void )
+int VLC_Destroy( int i_object )
 {
-    return vlc_destroy_r( GLOBAL_VLC );
-}
+    vlc_t *p_vlc = vlc_current_object( i_object );
 
-vlc_error_t vlc_destroy_r( vlc_t *p_vlc )
-{
-    /* Check that the handle is valid */
-    if( !p_vlc || (p_vlc->i_status != VLC_STATUS_STOPPED
-                    && p_vlc->i_status != VLC_STATUS_CREATED) )
+    if( !p_vlc )
     {
-        fprintf( stderr, "error: invalid status "
-                         "(!STOPPED&&!CREATED)\n" );
-        return VLC_ESTATUS;
+        return VLC_ENOOBJ;
     }
 
-    if( p_vlc->i_status == VLC_STATUS_STOPPED )
+    /*
+     * Free allocated memory
+     */
+    if( p_vlc->p_memcpy_module )
+    {
+        module_Unneed( p_vlc, p_vlc->p_memcpy_module );
+        p_vlc->p_memcpy_module = NULL;
+    }
+
+    if( p_vlc->psz_homedir )
     {
-        /*
-         * Go back into channel 0 which is the network
-         */
-        if( config_GetInt( p_vlc, "network-channel" ) && p_vlc->p_channel )
-        {
-            network_ChannelJoin( p_vlc, COMMON_CHANNEL );
-        }
-    
-        /*
-         * Free allocated memory
-         */
-        if( p_vlc->p_memcpy_module != NULL )
-        {
-            module_Unneed( p_vlc, p_vlc->p_memcpy_module );
-        }
-    
         free( p_vlc->psz_homedir );
-    
-        /*
-         * XXX: Free module bank !
-         */
-        //module_EndBank( p_vlc );
-    
-        /*
-         * System specific cleaning code
-         */
-        system_End( p_vlc );
-    
-        /* Update the handle status */
-        p_vlc->i_status = VLC_STATUS_CREATED;
+        p_vlc->psz_homedir = NULL;
     }
 
-    /* Update the handle status, just in case */
-    p_vlc->i_status = VLC_STATUS_NONE;
+    if( p_vlc->psz_configfile )
+    {
+        free( p_vlc->psz_configfile );
+        p_vlc->psz_configfile = NULL;
+    }
+
+    /*
+     * XXX: Free module bank !
+     */
+    /*module_EndBank( p_vlc );*/
+
+    /*
+     * System specific cleaning code
+     */
+    system_End( p_vlc );
 
     /* Destroy mutexes */
     vlc_mutex_destroy( &p_vlc->config_lock );
+#ifdef SYS_DARWIN
+    vlc_mutex_destroy( &p_vlc->quicktime_lock );
+#endif
 
     vlc_object_detach( p_vlc );
 
+    /* Release object before destroying it */
+    if( i_object ) vlc_object_release( p_vlc );
+
     vlc_object_destroy( p_vlc );
 
     /* Stop thread system: last one out please shut the door! */
-    vlc_threads_end( &libvlc );
+    vlc_threads_end( p_libvlc );
 
     return VLC_SUCCESS;
 }
 
 /*****************************************************************************
- * vlc_die: ask vlc to die.
+ * VLC_Die: ask vlc to die.
  *****************************************************************************
  * This function sets p_vlc->b_die to VLC_TRUE, but does not do any other
- * task. It is your duty to call vlc_end and vlc_destroy afterwards.
+ * task. It is your duty to call vlc_end and VLC_Destroy afterwards.
  *****************************************************************************/
-vlc_error_t vlc_die( void )
+int VLC_Die( int i_object )
 {
-    return vlc_die_r( GLOBAL_VLC );
-}
+    vlc_t *p_vlc = vlc_current_object( i_object );
 
-vlc_error_t vlc_die_r( vlc_t *p_vlc )
-{
     if( !p_vlc )
     {
-        fprintf( stderr, "error: invalid status (!EXIST)\n" );
-        return VLC_ESTATUS;
+        return VLC_ENOOBJ;
     }
 
     p_vlc->b_die = VLC_TRUE;
 
+    if( i_object ) vlc_object_release( p_vlc );
     return VLC_SUCCESS;
 }
 
 /*****************************************************************************
- * vlc_status: return the current vlc status.
- *****************************************************************************
- * This function returns the current value of p_vlc->i_status.
- *****************************************************************************/
-vlc_status_t vlc_status( void )
-{
-    return vlc_status_r( GLOBAL_VLC );
-}
-
-vlc_status_t vlc_status_r( vlc_t *p_vlc )
-{
-    if( !p_vlc )
-    {
-        return VLC_STATUS_NONE;
-    }
-
-    return p_vlc->i_status;
-}
-
-/*****************************************************************************
- * vlc_add_target: adds a target for playing.
+ * VLC_AddTarget: adds a target for playing.
  *****************************************************************************
  * This function adds psz_target to the current playlist. If a playlist does
  * not exist, it will create one.
  *****************************************************************************/
-vlc_error_t vlc_add_target( const char *psz_target, int i_mode, int i_pos )
-{
-    return vlc_add_target_r( GLOBAL_VLC,
-                             psz_target, i_mode, i_pos );
-}
-
-vlc_error_t vlc_add_target_r( vlc_t *p_vlc, const char *psz_target,
-                                            int i_mode, int i_pos )
+int VLC_AddTarget( int i_object, char const *psz_target,
+                   char const **ppsz_options, int i_options,
+                   int i_mode, int i_pos )
 {
-    vlc_error_t err;
+    int i_err;
     playlist_t *p_playlist;
+    vlc_t *p_vlc = vlc_current_object( i_object );
 
-    if( !p_vlc || ( p_vlc->i_status != VLC_STATUS_STOPPED
-                     && p_vlc->i_status != VLC_STATUS_RUNNING ) )
+    if( !p_vlc )
     {
-        fprintf( stderr, "error: invalid status (!STOPPED&&!RUNNING)\n" );
-        return VLC_ESTATUS;
+        return VLC_ENOOBJ;
     }
 
     p_playlist = vlc_object_find( p_vlc, VLC_OBJECT_PLAYLIST, FIND_ANYWHERE );
@@ -735,150 +803,117 @@ vlc_error_t vlc_add_target_r( vlc_t *p_vlc, const char *psz_target,
 
         if( p_playlist == NULL )
         {
+            if( i_object ) vlc_object_release( p_vlc );
             return VLC_EGENERIC;
         }
 
         vlc_object_yield( p_playlist );
     }
 
-    err = playlist_Add( p_playlist, psz_target, i_mode, i_pos );
+    i_err = playlist_Add( p_playlist, psz_target, ppsz_options, i_options,
+                          i_mode, i_pos );
 
     vlc_object_release( p_playlist );
 
-    return err;
+    if( i_object ) vlc_object_release( p_vlc );
+    return i_err;
 }
 
 /*****************************************************************************
- * vlc_set: set a vlc variable
+ * VLC_Set: set a vlc variable
  *****************************************************************************
  *
  *****************************************************************************/
-vlc_error_t vlc_set( const char *psz_var, const char *psz_val )
-{
-    return vlc_set_r( GLOBAL_VLC, psz_var, psz_val );
-}
-
-vlc_error_t vlc_set_r( vlc_t *p_vlc, const char *psz_var, const char *psz_val )
+int VLC_Set( int i_object, char const *psz_var, vlc_value_t value )
 {
-    module_config_t *p_config;
+    vlc_t *p_vlc = vlc_current_object( i_object );
+    int i_ret;
 
     if( !p_vlc )
     {
-        fprintf( stderr, "error: invalid status\n" );
-        return VLC_ESTATUS;
+        return VLC_ENOOBJ;
     }
 
-    p_config = config_FindConfig( VLC_OBJECT(p_vlc), psz_var );
-
-    if( !p_config )
+    /* FIXME: Temporary hack for Mozilla, if variable starts with conf:: then
+     * we handle it as a configuration variable. Don't tell Gildas :) -- sam */
+    if( !strncmp( psz_var, "conf::", 6 ) )
     {
-        msg_Err( p_vlc, "option %s does not exist", psz_var );
-        return VLC_EGENERIC;
-    }
+        module_config_t *p_item;
+        char const *psz_newvar = psz_var + 6;
 
-    vlc_mutex_lock( p_config->p_lock );
+        p_item = config_FindConfig( VLC_OBJECT(p_vlc), psz_newvar );
 
-    switch( p_config->i_type )
-    {
-    case CONFIG_ITEM_BOOL:
-        if( psz_val && *psz_val )
+        if( p_item )
         {
-            if( !strcmp( psz_val, "off" ) || !strcmp( psz_val, "no" ) )
-            {
-                p_config->i_value = VLC_FALSE;
-            }
-            else
+            switch( p_item->i_type )
             {
-                p_config->i_value = atoi( psz_val );
+                case CONFIG_ITEM_BOOL:
+                    config_PutInt( p_vlc, psz_newvar, value.b_bool );
+                    break;
+                case CONFIG_ITEM_INTEGER:
+                    config_PutInt( p_vlc, psz_newvar, value.i_int );
+                    break;
+                case CONFIG_ITEM_FLOAT:
+                    config_PutFloat( p_vlc, psz_newvar, value.f_float );
+                    break;
+                default:
+                    config_PutPsz( p_vlc, psz_newvar, value.psz_string );
+                    break;
             }
+            if( i_object ) vlc_object_release( p_vlc );
+            return VLC_SUCCESS;
         }
-        else
-        {
-            p_config->i_value = VLC_TRUE;
-        }
-        break;
-    case CONFIG_ITEM_INTEGER:
-        if( psz_val && *psz_val )
-        {
-            p_config->i_value = atoi( psz_val );
-        }
-        else
-        {
-            p_config->i_value = 0;
-        }
-        break;
-    case CONFIG_ITEM_FLOAT:
-        if( psz_val && *psz_val )
-        {
-            p_config->f_value = (float)atof( psz_val );
-        }
-        else
-        {
-            p_config->f_value = 0.0;
-        }
-        break;
-    case CONFIG_ITEM_STRING:
-    case CONFIG_ITEM_FILE:
-    case CONFIG_ITEM_MODULE:
-    default:
-        if( p_config->psz_value )
-        {
-            free( p_config->psz_value );
-        }
-
-        if( psz_val )
-        {
-            p_config->psz_value = strdup( psz_val );
-        }
-        else
-        {
-            p_config->psz_value = NULL;
-        }
-        break;
     }
 
-    if( p_config->pf_callback )
-    {
-        vlc_mutex_unlock( p_config->p_lock );
-        p_config->pf_callback( VLC_OBJECT(p_vlc) );
-    }
-    else
-    {
-        vlc_mutex_unlock( p_config->p_lock );
-    }
+    i_ret = var_Set( p_vlc, psz_var, value );
 
-    return VLC_SUCCESS;
+    if( i_object ) vlc_object_release( p_vlc );
+    return i_ret;
 }
 
-/* XXX: temporary hacks */
-
 /*****************************************************************************
- * vlc_play: play
+ * VLC_Get: get a vlc variable
+ *****************************************************************************
+ *
  *****************************************************************************/
-vlc_error_t vlc_play( )
+int VLC_Get( int i_object, char const *psz_var, vlc_value_t *p_value )
 {
-    return vlc_play_r( GLOBAL_VLC );
+    vlc_t *p_vlc = vlc_current_object( i_object );
+    int i_ret;
+
+    if( !p_vlc )
+    {
+        return VLC_ENOOBJ;
+    }
+
+    i_ret = var_Get( p_vlc, psz_var, p_value );
+
+    if( i_object ) vlc_object_release( p_vlc );
+    return i_ret;
 }
 
-vlc_error_t vlc_play_r( vlc_t *p_vlc )
+/* FIXME: temporary hacks */
+
+/*****************************************************************************
+ * VLC_Play: play
+ *****************************************************************************/
+int VLC_Play( int i_object )
 {
     playlist_t * p_playlist;
+    vlc_t *p_vlc = vlc_current_object( i_object );
 
     /* Check that the handle is valid */
-    if( !p_vlc || p_vlc->i_status != VLC_STATUS_STOPPED )
+    if( !p_vlc )
     {
-        fprintf( stderr, "error: invalid status (!STOPPED)\n" );
-        return VLC_ESTATUS;
+        return VLC_ENOOBJ;
     }
 
-    /* Update the handle status */
-    p_vlc->i_status = VLC_STATUS_RUNNING;
-
     p_playlist = vlc_object_find( p_vlc, VLC_OBJECT_PLAYLIST, FIND_CHILD );
 
     if( !p_playlist )
     {
-        return VLC_EOBJECT;
+        if( i_object ) vlc_object_release( p_vlc );
+        return VLC_ENOOBJ;
     }
 
     vlc_mutex_lock( &p_playlist->object_lock );
@@ -894,36 +929,32 @@ vlc_error_t vlc_play_r( vlc_t *p_vlc )
 
     vlc_object_release( p_playlist );
 
+    if( i_object ) vlc_object_release( p_vlc );
     return VLC_SUCCESS;
 }
 
 /*****************************************************************************
- * vlc_stop: stop
+ * VLC_Stop: stop
  *****************************************************************************/
-vlc_error_t vlc_stop( )
-{
-    return vlc_stop_r( GLOBAL_VLC );
-}
-
-vlc_error_t vlc_stop_r( vlc_t *p_vlc )
+int VLC_Stop( int i_object )
 {
     intf_thread_t *   p_intf;
     playlist_t    *   p_playlist;
     vout_thread_t *   p_vout;
     aout_instance_t * p_aout;
+    vlc_t *p_vlc = vlc_current_object( i_object );
 
     /* Check that the handle is valid */
-    if( !p_vlc || ( p_vlc->i_status != VLC_STATUS_STOPPED
-                     && p_vlc->i_status != VLC_STATUS_RUNNING ) )
+    if( !p_vlc )
     {
-        fprintf( stderr, "error: invalid status (!STOPPED&&!RUNNING)\n" );
-        return VLC_ESTATUS;
+        return VLC_ENOOBJ;
     }
 
     /*
      * Ask the interfaces to stop and destroy them
      */
     msg_Dbg( p_vlc, "removing all interfaces" );
+
     while( (p_intf = vlc_object_find( p_vlc, VLC_OBJECT_INTF, FIND_CHILD )) )
     {
         intf_StopThread( p_intf );
@@ -935,6 +966,7 @@ vlc_error_t vlc_stop_r( vlc_t *p_vlc )
     /*
      * Free playlists
      */
+    
     msg_Dbg( p_vlc, "removing all playlists" );
     while( (p_playlist = vlc_object_find( p_vlc, VLC_OBJECT_PLAYLIST,
                                           FIND_CHILD )) )
@@ -943,7 +975,7 @@ vlc_error_t vlc_stop_r( vlc_t *p_vlc )
         vlc_object_release( p_playlist );
         playlist_Destroy( p_playlist );
     }
-
+    
     /*
      * Free video outputs
      */
@@ -952,7 +984,7 @@ vlc_error_t vlc_stop_r( vlc_t *p_vlc )
     {
         vlc_object_detach( p_vout );
         vlc_object_release( p_vout );
-        vout_DestroyThread( p_vout );
+        vout_Destroy( p_vout );
     }
 
     /*
@@ -966,78 +998,170 @@ vlc_error_t vlc_stop_r( vlc_t *p_vlc )
         aout_Delete( p_aout );
     }
 
-    /* Update the handle status */
-    p_vlc->i_status = VLC_STATUS_STOPPED;
-
+    if( i_object ) vlc_object_release( p_vlc );
     return VLC_SUCCESS;
 }
 
 /*****************************************************************************
- * vlc_pause: toggle pause
+ * VLC_Pause: toggle pause
  *****************************************************************************/
-vlc_error_t vlc_pause( )
-{
-    return vlc_pause_r( GLOBAL_VLC );
-}
-
-vlc_error_t vlc_pause_r( vlc_t *p_vlc )
+int VLC_Pause( int i_object )
 {
     input_thread_t *p_input;
+    vlc_t *p_vlc = vlc_current_object( i_object );
+
+    if( !p_vlc )
+    {
+        return VLC_ENOOBJ;
+    }
 
     p_input = vlc_object_find( p_vlc, VLC_OBJECT_INPUT, FIND_CHILD );
 
     if( !p_input )
     {
-        return VLC_EOBJECT;
+        if( i_object ) vlc_object_release( p_vlc );
+        return VLC_ENOOBJ;
     }
 
     input_SetStatus( p_input, INPUT_STATUS_PAUSE );
     vlc_object_release( p_input );
 
+    if( i_object ) vlc_object_release( p_vlc );
     return VLC_SUCCESS;
 }
 
 /*****************************************************************************
- * vlc_fullscreen: toggle fullscreen mode
+ * VLC_FullScreen: toggle fullscreen mode
  *****************************************************************************/
-vlc_error_t vlc_fullscreen( )
-{
-    return vlc_fullscreen_r( GLOBAL_VLC );
-}
-
-vlc_error_t vlc_fullscreen_r( vlc_t *p_vlc )
+int VLC_FullScreen( int i_object )
 {
     vout_thread_t *p_vout;
+    vlc_t *p_vlc = vlc_current_object( i_object );
+
+    if( !p_vlc )
+    {
+        return VLC_ENOOBJ;
+    }
 
     p_vout = vlc_object_find( p_vlc, VLC_OBJECT_VOUT, FIND_CHILD );
 
     if( !p_vout )
     {
-        return VLC_EOBJECT;
+        if( i_object ) vlc_object_release( p_vlc );
+        return VLC_ENOOBJ;
     }
 
     p_vout->i_changes |= VOUT_FULLSCREEN_CHANGE;
     vlc_object_release( p_vout );
 
+    if( i_object ) vlc_object_release( p_vlc );
     return VLC_SUCCESS;
 }
 
 /* following functions are local */
 
+/*****************************************************************************
+ * SetLanguage: set the interface language.
+ *****************************************************************************
+ * We set the LC_MESSAGES locale category for interface messages and buttons,
+ * as well as the LC_CTYPE category for string sorting and possible wide
+ * character support.
+ *****************************************************************************/
+static void SetLanguage ( char const *psz_lang )
+{
+#if defined( ENABLE_NLS ) \
+     && ( defined( HAVE_GETTEXT ) || defined( HAVE_INCLUDED_GETTEXT ) )
+
+    char *          psz_path;
+#if defined( SYS_DARWIN ) || defined ( WIN32 ) || defined( SYS_BEOS )
+    char            psz_tmp[1024];
+#endif
+
+    if( psz_lang && !*psz_lang )
+    {
+#   if defined( HAVE_LC_MESSAGES )
+        setlocale( LC_MESSAGES, psz_lang );
+#   endif
+        setlocale( LC_CTYPE, psz_lang );
+    }
+    else if( psz_lang )
+    {
+#ifdef SYS_DARWIN
+        /* I need that under Darwin, please check it doesn't disturb
+         * other platforms. --Meuuh */
+        setenv( "LANG", psz_lang, 1 );
+
+#elif defined( SYS_BEOS ) || defined( WIN32 )
+        /* We set LC_ALL manually because it is the only way to set
+         * the language at runtime under eg. Windows. Beware that this
+         * makes the environment unconsistent when libvlc is unloaded and
+         * should probably be moved to a safer place like vlc.c. */
+        static char psz_lcall[20];
+        snprintf( psz_lcall, 19, "LC_ALL=%s", psz_lang );
+        psz_lcall[19] = '\0';
+        putenv( psz_lcall );
+#endif
+
+        setlocale( LC_ALL, psz_lang );
+    }
+
+    /* Specify where to find the locales for current domain */
+#if !defined( SYS_DARWIN ) && !defined( WIN32 ) && !defined( SYS_BEOS )
+    psz_path = LOCALEDIR;
+#else
+    snprintf( psz_tmp, sizeof(psz_tmp), "%s/%s", libvlc.psz_vlcpath,
+              "locale" );
+    psz_path = psz_tmp;
+#endif
+    if( !bindtextdomain( PACKAGE, psz_path ) )
+    {
+        fprintf( stderr, "warning: no domain %s in directory %s\n",
+                 PACKAGE, psz_path );
+    }
+
+    /* Set the default domain */
+    textdomain( PACKAGE );
+
+#if defined( SYS_BEOS ) || defined ( SYS_DARWIN ) || \
+    ( defined( WIN32 ) && !defined( HAVE_INCLUDED_GETTEXT ) )
+    /* BeOS only support UTF8 strings */
+    /* Mac OS X prefers UTF8 */
+    bind_textdomain_codeset( PACKAGE, "UTF-8" );
+#endif
+
+#endif
+}
+
 /*****************************************************************************
  * GetFilenames: parse command line options which are not flags
  *****************************************************************************
- * Parse command line for input files.
+ * Parse command line for input files as well as their associated options.
+ * An option always follows its associated input and begins with a ":".
  *****************************************************************************/
 static int GetFilenames( vlc_t *p_vlc, int i_argc, char *ppsz_argv[] )
 {
-    int i_opt;
+    int i_opt, i_options;
 
-    /* We assume that the remaining parameters are filenames */
-    for( i_opt = optind; i_opt < i_argc; i_opt++ )
+    /* We assume that the remaining parameters are filenames
+     * and their input options */
+    for( i_opt = i_argc - 1; i_opt >= optind; i_opt-- )
     {
-        vlc_add_target_r( p_vlc, ppsz_argv[ i_opt ],
-                          PLAYLIST_APPEND | PLAYLIST_GO, PLAYLIST_END );
+        i_options = 0;
+
+        /* Count the input options */
+        while( *ppsz_argv[ i_opt ] == ':' && i_opt > optind )
+        {
+            i_options++;
+            i_opt--;
+        }
+
+        /* TODO: write an internal function of this one, to avoid
+         *       unnecessary lookups. */
+        VLC_AddTarget( p_vlc->i_object_id, ppsz_argv[ i_opt ],
+                       (char const **)( i_options ? &ppsz_argv[i_opt + 1] :
+                                        NULL ), i_options,
+                       PLAYLIST_INSERT | (i_opt == optind ? PLAYLIST_GO : 0),
+                       0 );
     }
 
     return VLC_SUCCESS;
@@ -1048,26 +1172,31 @@ static int GetFilenames( vlc_t *p_vlc, int i_argc, char *ppsz_argv[] )
  *****************************************************************************
  * Print a short inline help. Message interface is initialized at this stage.
  *****************************************************************************/
-static void Usage( vlc_t *p_this, const char *psz_module_name )
+static void Usage( vlc_t *p_this, char const *psz_module_name )
 {
-#define FORMAT_STRING "      --%s%s%s%s%s%s%s %s%s\n"
-    /* option name -------------'     | | | |  | |
-     * <bra --------------------------' | | |  | |
-     * option type or "" ---------------' | |  | |
-     * ket> ------------------------------' |  | |
-     * padding spaces ----------------------'  | |
-     * comment --------------------------------' |
-     * comment suffix ---------------------------'
+#define FORMAT_STRING "  %s --%s%s%s%s%s%s%s "
+    /* short option ------'    |     | | | |  | |
+     * option name ------------'     | | | |  | |
+     * <bra -------------------------' | | |  | |
+     * option type or "" --------------' | |  | |
+     * ket> -----------------------------' |  | |
+     * padding spaces ---------------------'  | |
+     * comment -------------------------------' |
+     * comment suffix --------------------------'
      *
      * The purpose of having bra and ket is that we might i18n them as well.
      */
 #define LINE_START 8
 #define PADDING_SPACES 25
     vlc_list_t *p_list;
-    module_t **pp_parser;
+    module_t *p_parser;
     module_config_t *p_item;
     char psz_spaces[PADDING_SPACES+LINE_START+1];
     char psz_format[sizeof(FORMAT_STRING)];
+    char psz_buffer[1000];
+    char psz_short[4];
+    int i_index;
+    int i_width = ConsoleWidth() - (PADDING_SPACES+LINE_START+1);
 
     memset( psz_spaces, ' ', PADDING_SPACES+LINE_START );
     psz_spaces[PADDING_SPACES+LINE_START] = '\0';
@@ -1082,40 +1211,44 @@ static void Usage( vlc_t *p_this, const char *psz_module_name )
     p_list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );
 
     /* Enumerate the config for each module */
-    for( pp_parser = (module_t **)p_list->pp_objects ;
-         *pp_parser ;
-         pp_parser++ )
+    for( i_index = 0; i_index < p_list->i_count; i_index++ )
     {
         vlc_bool_t b_help_module;
 
+        p_parser = (module_t *)p_list->p_values[i_index].p_object ;
+
         if( psz_module_name && strcmp( psz_module_name,
-                                       (*pp_parser)->psz_object_name ) )
+                                       p_parser->psz_object_name ) )
         {
             continue;
         }
 
         /* Ignore modules without config options */
-        if( !(*pp_parser)->i_config_items )
+        if( !p_parser->i_config_items )
         {
             continue;
         }
 
-        b_help_module = !strcmp( "help", (*pp_parser)->psz_object_name );
+        b_help_module = !strcmp( "help", p_parser->psz_object_name );
 
         /* Print module options */
-        for( p_item = (*pp_parser)->p_config;
+        for( p_item = p_parser->p_config;
              p_item->i_type != CONFIG_HINT_END;
              p_item++ )
         {
+            char *psz_text;
             char *psz_bra = NULL, *psz_type = NULL, *psz_ket = NULL;
             char *psz_suf = "", *psz_prefix = NULL;
             int i;
-
+            if ( p_item->b_advanced && !config_GetInt( p_this, "advanced" ))
+            {
+                continue;
+            }
             switch( p_item->i_type )
             {
             case CONFIG_HINT_CATEGORY:
             case CONFIG_HINT_USAGE:
-                fprintf( stderr, " %s\n", p_item->psz_text );
+                fprintf( stdout, " %s\n", p_item->psz_text );
                 break;
 
             case CONFIG_ITEM_STRING:
@@ -1128,16 +1261,15 @@ static void Usage( vlc_t *p_this, const char *psz_module_name )
                 }
                 else
                 {
-                    psz_bra = " [";
-                    psz_type = malloc( 1000 );
-                    memset( psz_type, 0, 1000 );
-                    for( i=0; p_item->ppsz_list[i]; i++ )
+                    psz_bra = " {";
+                    psz_type = psz_buffer;
+                    psz_type[0] = '\0';
+                    for( i = 0; p_item->ppsz_list[i]; i++ )
                     {
+                        if( i ) strcat( psz_type, "," );
                         strcat( psz_type, p_item->ppsz_list[i] );
-                        strcat( psz_type, "|" );
                     }
-                    psz_type[ strlen( psz_type ) - 1 ] = '\0';
-                    psz_ket = "]";
+                    psz_ket = "}";
                     break;
                 }
             case CONFIG_ITEM_INTEGER:
@@ -1156,82 +1288,108 @@ static void Usage( vlc_t *p_this, const char *psz_module_name )
                 break;
             }
 
+            if( !psz_type )
+            {
+                continue;
+            }
+
             /* Add short option if any */
             if( p_item->i_short )
             {
-                psz_format[2] = '-';
-                psz_format[3] = p_item->i_short;
-                psz_format[4] = ',';
+                sprintf( psz_short, "-%c,", p_item->i_short );
             }
             else
             {
-                psz_format[2] = ' ';
-                psz_format[3] = ' ';
-                psz_format[4] = ' ';
+                strcpy( psz_short, "   " );
             }
 
-            if( psz_type )
+            i = PADDING_SPACES - strlen( p_item->psz_name )
+                 - strlen( psz_bra ) - strlen( psz_type )
+                 - strlen( psz_ket ) - 1;
+
+            if( p_item->i_type == CONFIG_ITEM_BOOL && !b_help_module )
             {
-                i = PADDING_SPACES - strlen( p_item->psz_name )
-                     - strlen( psz_bra ) - strlen( psz_type )
-                     - strlen( psz_ket ) - 1;
-                if( p_item->i_type == CONFIG_ITEM_BOOL
-                     && !b_help_module )
-                {
-                    /* If option is of type --foo-bar, we print its counterpart
-                     * as --no-foo-bar, but if it is of type --foobar (without
-                     * dashes in the name) we print it as --nofoobar. Both
-                     * values are of course valid, only the display changes. */
-                    vlc_bool_t b_dash = VLC_FALSE;
-                    psz_prefix = p_item->psz_name;
-                    while( *psz_prefix )
-                    {
-                        if( *psz_prefix++ == '-' )
-                        {
-                            b_dash = VLC_TRUE;
-                            break;
-                        }
-                    }
+                /* If option is of type --foo-bar, we print its counterpart
+                 * as --no-foo-bar, but if it is of type --foobar (without
+                 * dashes in the name) we print it as --nofoobar. Both
+                 * values are of course valid, only the display changes. */
+                psz_prefix = strchr( p_item->psz_name, '-' ) ? ", --no-"
+                                                             : ", --no";
+                i -= strlen( p_item->psz_name ) + strlen( psz_prefix );
+            }
 
-                    if( b_dash )
-                    {
-                        psz_prefix = ", --no-";
-                        i -= strlen( p_item->psz_name ) + strlen( ", --no-" );
-                    }
-                    else
-                    {
-                        psz_prefix = ", --no";
-                        i -= strlen( p_item->psz_name ) + strlen( ", --no" );
-                    }
-                }
+            if( i < 0 )
+            {
+                psz_spaces[0] = '\n';
+                i = 0;
+            }
+            else
+            {
+                psz_spaces[i] = '\0';
+            }
 
-                if( i < 0 )
-                {
-                    i = 0;
-                    psz_spaces[i] = '\n';
-                }
-                else
+            if( p_item->i_type == CONFIG_ITEM_BOOL && !b_help_module )
+            {
+                fprintf( stdout, psz_format, psz_short, p_item->psz_name,
+                         psz_prefix, p_item->psz_name, psz_bra, psz_type,
+                         psz_ket, psz_spaces );
+            }
+            else
+            {
+                fprintf( stdout, psz_format, psz_short, p_item->psz_name,
+                         "", "", psz_bra, psz_type, psz_ket, psz_spaces );
+            }
+
+            psz_spaces[i] = ' ';
+
+            /* We wrap the rest of the output */
+            sprintf( psz_buffer, "%s%s", p_item->psz_text, psz_suf );
+            psz_text = psz_buffer;
+            while( *psz_text )
+            {
+                char *psz_parser, *psz_word;
+                int i_end = strlen( psz_text );
+
+                /* If the remaining text fits in a line, print it. */
+                if( i_end <= i_width )
                 {
-                    psz_spaces[i] = '\0';
+                    fprintf( stdout, "%s\n", psz_text );
+                    break;
                 }
 
-                if( p_item->i_type == CONFIG_ITEM_BOOL &&
-                    !b_help_module )
+                /* Otherwise, eat as many words as possible */
+                psz_parser = psz_text;
+                do
                 {
-                    fprintf( stderr, psz_format, p_item->psz_name, psz_prefix,
-                             p_item->psz_name, psz_bra, psz_type, psz_ket,
-                             psz_spaces, p_item->psz_text, psz_suf );
-                }
-                else
+                    psz_word = psz_parser;
+                    psz_parser = strchr( psz_word, ' ' );
+                    /* If no space was found, we reached the end of the text
+                     * block; otherwise, we skip the space we just found. */
+                    psz_parser = psz_parser ? psz_parser + 1
+                                            : psz_text + i_end;
+
+                } while( psz_parser - psz_text <= i_width );
+
+                /* We cut a word in one of these cases:
+                 *  - it's the only word in the line and it's too long.
+                 *  - we used less than 80% of the width and the word we are
+                 *    going to wrap is longer than 40% of the width, and even
+                 *    if the word would have fit in the next line. */
+                if( psz_word == psz_text
+                     || ( psz_word - psz_text < 80 * i_width / 100
+                           && psz_parser - psz_word > 40 * i_width / 100 ) )
                 {
-                    fprintf( stderr, psz_format, p_item->psz_name, "", "",
-                             psz_bra, psz_type, psz_ket, psz_spaces,
-                             p_item->psz_text, psz_suf );
+                    char c = psz_text[i_width];
+                    psz_text[i_width] = '\0';
+                    fprintf( stdout, "%s\n%s", psz_text, psz_spaces );
+                    psz_text += i_width;
+                    psz_text[0] = c;
                 }
-                psz_spaces[i] = ' ';
-                if ( p_item->ppsz_list )
+                else
                 {
-                    free( psz_type );
+                    psz_word[-1] = '\0';
+                    fprintf( stdout, "%s\n%s", psz_text, psz_spaces );
+                    psz_text = psz_word;
                 }
             }
         }
@@ -1241,8 +1399,8 @@ static void Usage( vlc_t *p_this, const char *psz_module_name )
     vlc_list_release( p_list );
 
 #ifdef WIN32        /* Pause the console because it's destroyed when we exit */
-        fprintf( stderr, _("\nPress the RETURN key to continue...\n") );
-        getchar();
+    fprintf( stdout, _("\nPress the RETURN key to continue...\n") );
+    getchar();
 #endif
 }
 
@@ -1255,8 +1413,9 @@ static void Usage( vlc_t *p_this, const char *psz_module_name )
 static void ListModules( vlc_t *p_this )
 {
     vlc_list_t *p_list;
-    module_t **pp_parser;
+    module_t *p_parser;
     char psz_spaces[22];
+    int i_index;
 
     memset( psz_spaces, ' ', 22 );
 
@@ -1265,29 +1424,29 @@ static void ListModules( vlc_t *p_this )
 #endif
 
     /* Usage */
-    fprintf( stderr, _("Usage: %s [options] [items]...\n\n"),
+    fprintf( stdout, _("Usage: %s [options] [items]...\n\n"),
                      p_this->p_vlc->psz_object_name );
 
-    fprintf( stderr, _("[module]              [description]\n") );
+    fprintf( stdout, _("[module]              [description]\n") );
 
     /* List all modules */
     p_list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );
 
     /* Enumerate each module */
-    for( pp_parser = (module_t **)p_list->pp_objects ;
-         *pp_parser ;
-         pp_parser++ )
+    for( i_index = 0; i_index < p_list->i_count; i_index++ )
     {
         int i;
 
+        p_parser = (module_t *)p_list->p_values[i_index].p_object ;
+
         /* Nasty hack, but right now I'm too tired to think about a nice
          * solution */
-        i = 22 - strlen( (*pp_parser)->psz_object_name ) - 1;
+        i = 22 - strlen( p_parser->psz_object_name ) - 1;
         if( i < 0 ) i = 0;
         psz_spaces[i] = 0;
 
-        fprintf( stderr, "  %s%s %s\n", (*pp_parser)->psz_object_name,
-                         psz_spaces, (*pp_parser)->psz_longname );
+        fprintf( stdout, "  %s%s %s\n", p_parser->psz_object_name,
+                         psz_spaces, p_parser->psz_longname );
 
         psz_spaces[i] = ' ';
     }
@@ -1295,8 +1454,8 @@ static void ListModules( vlc_t *p_this )
     vlc_list_release( p_list );
 
 #ifdef WIN32        /* Pause the console because it's destroyed when we exit */
-        fprintf( stderr, _("\nPress the RETURN key to continue...\n") );
-        getchar();
+    fprintf( stdout, _("\nPress the RETURN key to continue...\n") );
+    getchar();
 #endif
 }
 
@@ -1311,15 +1470,15 @@ static void Version( void )
     ShowConsole();
 #endif
 
-    fprintf( stderr, VERSION_MESSAGE "\n" );
-    fprintf( stderr,
+    fprintf( stdout, VERSION_MESSAGE "\n" );
+    fprintf( stdout,
       _("This program comes with NO WARRANTY, to the extent permitted by "
         "law.\nYou may redistribute it under the terms of the GNU General "
         "Public License;\nsee the file named COPYING for details.\n"
-        "Written by the VideoLAN team at Ecole Centrale, Paris.\n") );
+        "Written by the VideoLAN team; see AUTHORS file.\n") );
 
 #ifdef WIN32        /* Pause the console because it's destroyed when we exit */
-    fprintf( stderr, _("\nPress the RETURN key to continue...\n") );
+    fprintf( stdout, _("\nPress the RETURN key to continue...\n") );
     getchar();
 #endif
 }
@@ -1332,11 +1491,52 @@ static void Version( void )
 #ifdef WIN32 /*  */
 static void ShowConsole( void )
 {
+#   ifndef UNDER_CE
     AllocConsole();
     freopen( "CONOUT$", "w", stdout );
     freopen( "CONOUT$", "w", stderr );
     freopen( "CONIN$", "r", stdin );
+#   endif
     return;
 }
 #endif
 
+/*****************************************************************************
+ * ConsoleWidth: Return the console width in characters
+ *****************************************************************************
+ * We use the stty shell command to get the console width; if this fails or
+ * if the width is less than 80, we default to 80.
+ *****************************************************************************/
+static int ConsoleWidth( void )
+{
+    int i_width = 80;
+
+#ifndef WIN32
+    char buf[20], *psz_parser;
+    FILE *file;
+    int i_ret;
+
+    file = popen( "stty size 2>/dev/null", "r" );
+    if( file )
+    {
+        i_ret = fread( buf, 1, 20, file );
+        if( i_ret > 0 )
+        {
+            buf[19] = '\0';
+            psz_parser = strchr( buf, ' ' );
+            if( psz_parser )
+            {
+                i_ret = atoi( psz_parser + 1 );
+                if( i_ret >= 80 )
+                {
+                    i_width = i_ret;
+                }
+            }
+        }
+
+        pclose( file );
+    }
+#endif
+
+    return i_width;
+}