"SfR Fresh" - the SfR Freeware/Shareware Archive

Member "gxine-0.5.903/README" of archive gxine-0.5.903.tar.gz:

    1 
    2   gxine, a GTK+ frontend for xine
    3   ===============================
    4 
    5 (C) 2001-2004 Guenter Bartsch
    6 (C) 2004-2007 Darren Salt
    7 (C) 2001-2007 the xine project team
    8 
    9 gxine is free software released under the GPL.
   10 
   11 
   12 About
   13 -----
   14 
   15 gxine is a GTK+ based GUI for the xine-lib video player library. It is a
   16 media player that can play all the audio/video formats that libxine
   17 supports. Currently, this includes MPEG1/2, some AVI and Quicktime files,
   18 some network streaming methods and disc based media (VCD, SVCD, DVD).
   19 A more complete list can be found on http://xinehq.de/.
   20 
   21 * Example files referenced in the following text may be found in the misc/
   22   directory in gxine's source or in the documentation directory, typically
   23   /usr/share/doc/gxine if you're using a packaged version.
   24 
   25 
   26 General use
   27 -----------
   28 
   29 A few things which may not be immediately obvious:
   30 
   31 - You can hide and show the toolbar by clicking the middle mouse button over
   32   the video display. (In windowed mode, you need to be using the separate
   33   toolbar for this to work.)
   34 
   35 - You can always access the menus by right-clicking over the video panel.
   36 
   37 You need a window manager which supports full-screen windows. If you're
   38 using one which doesn't, full-screen mode won't work.
   39 
   40 If you're using xcompmgr or a window manager which supports compositing,
   41 you'll need to ensure that Xv colourkey autopainting is disabled (and you
   42 may need to restart gxine).
   43   File -> Configure -> Preferences: video.device.xv_colorkey
   44 
   45 As of 0.6.0, gxine will prompt for authentication for http:// MRLs if needed.
   46 ("http://user:pass@site/path" was previously the only way to do this.)
   47 
   48 Currently, storage of the authentication details is insecure: it is stored
   49 as plain text in the playlist file, and the playlist file (when saved) is
   50 subject to the umask setting, which is normally 022 or 002 - both of which
   51 allow it to be read by anybody.
   52 
   53 
   54 LIRC support
   55 ------------
   56 
   57 gxine has full LIRC support. You need to have either of
   58   ~/.gxine/lircrc
   59   ~/.lircrc
   60 to use it. The files are read in that order; definitions are *not* overridden.
   61 
   62 An example lircrc file is included. You'll almost certainly want to modify it.
   63 
   64 You can let gxine execute any Javascript code you want on lirc input :-)
   65 
   66 
   67 Javascript
   68 ----------
   69 
   70 gxine is almost entirely controllable via Javascript. You can bind keys to
   71 Javascript fragments (single commands, sequences of commands) - have a look
   72 at the key bindings window (accessed via the File menu) for more
   73 information.
   74 
   75 As of 0.5.0, there's also support for startup scripts - one global, one
   76 user-defined. Both are run, the global script first, when you start gxine.
   77 
   78 Here's an example which provides independent zoom settings for windowed
   79 and full-screen modes. You'll need to modify your keymap as described.
   80 
   81   // swap_zoom() suggested usage:
   82   //   Windowed mode:
   83   //     if (vo_fullscreen.v) swap_zoom (); vo_fullscreen.v = false;
   84   //   Fullscreen mode:
   85   //     swap_zoom (); vo_fullscreen.toggle ();
   86   function swap_zoom ()
   87   {
   88     var tmp = vo_zoom.v;
   89     vo_zoom.v = zoom_other;
   90     zoom_other = tmp;
   91   }
   92   var zoom_other = 100;
   93 
   94 There's a Javascript reference at
   95   http://developer.mozilla.org/en/docs/JavaScript
   96 
   97 As of 0.6.0, various deprecated functions are obsolete and are not included
   98 by default. You can enable them with --enable-obsolete, but this is not
   99 recommended; you should migrate to the vo_* and ao_* objects.
  100 
  101 Obsolete functions will be removed and deprecated functions obsoleted in 2008.
  102 
  103 
  104 VDR support
  105 -----------
  106 
  107 As of 0.4.0, gxine has VDR support. You'll need vdr, vdr-xine and a
  108 suitably-patched xine-lib (see the vdr-xine documentation for details) to
  109 make use of this.
  110 
  111 If ~/.gxine already exists and contains a key bindings file from an older
  112 version of gxine:
  113 
  114  * Your key bindings be upgraded automatically. Any bindings with command
  115    strings which don't match one of the defaults or which already have
  116    descriptions (also new in 0.4.0) will be left untouched - you'll have to
  117    check these ones yourself.
  118 
  119  * There are some new bindings for use with VDR. These will be added at the
  120    same time.
  121 
  122 
  123 GNOME VFS support
  124 -----------------
  125 
  126 You'll get this automatically if the GNOME VFS library is present on your
  127 system.
  128 
  129 
  130 GTK themes
  131 ----------
  132 
  133 If you wish to use different speaker icons, you must provide button-sized
  134 images (normally 20x20) for stock items "gxine-media-speaker" and
  135 "gxine-media-speaker-mute". The direction, size and state settings should be
  136 wildcarded.
  137 
  138 Also present are some "gxine-settings-*" items: "av-sync", "hue",
  139 "saturation", "contrast", "brightness", "volume", "compressor", "amplifier".
  140 
  141 The appearance of the time widget and info bar may be controlled via any of
  142 the following (highest priority last):
  143   gxine's default gtkrc file (typically /usr/share/gxine/gtkrc)
  144   gxine's gtkrc conf file (typically /etc/gxine/gtkrc)
  145   ~/.gtkrc-2.0
  146   ~/.gxine/gtkrc
  147 
  148 
  149 Toolbar and keypad windows
  150 --------------------------
  151 
  152 gxine has three files which define the layout and content of the toolbars
  153 (windowed and full-screen modes are handled separately) and the keypad
  154 window. You can override the defaults by providing
  155 
  156   ~/.gxine/keypad.xml
  157   ~/.gxine/toolbar-fullscreen.xml
  158   ~/.gxine/toolbar-window.xml
  159 
  160 These files may contain translatable labels and tooltips; they are prefixed
  161 with "~". (You probably won't need this.)
  162 
  163 The keypad definition is a full window definition; the other definitions
  164 require a single non-window container at the top level. The menu bar and
  165 video pane are fixed features.
  166 
  167 (Full documentation of these files is yet to be written.)
  168 
  169 
  170 Bug reports and feature requests
  171 --------------------------------
  172 
  173 * If you installed gxine from a distribution:
  174 
  175   You should report problems and request features via your distribution's bug
  176   tracking system.
  177 
  178 * If you installed gxine from source fetched from xinehq.de or Sourceforge:
  179 
  180   Check that you're using a recent version and that the problem is still
  181   present in that version. If you are or it is, then you should report the
  182   problem. To do this, visit
  183     <URL:http://sourceforge.net/projects/xine/>
  184   and use either the "Bugs" link or the "RFE" link.
  185 
  186 * If you installed gxine from a third-party archive:
  187 
  188   You should contact that archive's maintainer.
  189 
  190 
  191 If you find that your problem or missing feature has already been reported,
  192 there's no point in re-reporting it, but if you have any extra information
  193 which may help in fixing the problem, you should add that to the existing
  194 report.
  195 
  196 If you're not sure what to do, you can always post to the xine-user mailing
  197 list. (But do search the list archive first.)