
                         _|_ __|_ _ ._ _  
			  |_(_)|_(/_| | | 

Totem is movie player for the Gnome desktop based on xine. It features a
playlist, a full-screen mode, seek and volume controls, as well as
complete keyboard navigation.

Read the previous release notes if you encounter problems:
http://mail.gnome.org/archives/gnome-announce-list/2003-October/msg00054.html

News
====

See NEWS file

Dependencies
============

xine-lib 1.0 rc4a or newer:
	http://xinehq.de
GNOME 2.2 development platform:
	http://www.gnome.org

Controls
========

H:
	Hide/Show controls in windowed mode
I:
	Switch deinterlacing on and off
P, Space (fullscreen only):
	Play/Pause
Escape (in full screen mode):
	Switch to windowed mode
F:
	Toggle full screen
0/,1,2:
	Zoom respectively to 50%, 100% and 200% of the video's original size
Left arrow:
	Go back 15 seconds
Right arrow:
	Go forward 60 seconds
Shift+Left arrow:
	Go back 5 seconds
Shift+Right arrow:
	Go forward 15 seconds
Up Arrow:
	Increase the volume by 8%
Down Arrow:
	Decrease the volume by 8%
B:
	Previous stream (Back)
N:
	Next stream (Next)
Q:
	Quit
S:
	Show the "Skip to" dialog

Copyright
=========

gtk-xine.[ch] from gnome-xine by Guenter Bartsch <guenter@users.sourceforge.net>
with the following enhancements by myself:
- port to Gtk+ 2.0
- real full-screen mode for _NET_WM aware window managers (metacity, sawfish2,
  kwin > 2.2, etc.)
- use of signals
- use of properties
- loads of API cleanups
- move all the internal data to a private structure

Nifty media player icon by Jakub Steiner <jimmac@ximian.com>

UI help by Seth Nickell <snickell@stanford.edu>

FAQ
===

Q: Totem doesn't appear in the applications to open videos in Nautilus.

A: You probably installed Totem in a different prefix. Here is how to fix it.
   $ cd /where/the/totem/sources/are/
   $ cd data && make user-install

   And it should now. Enjoy.

TODO
====

- support gxine, freevo, ypl playlist formats
- write a widget more suitable for seeking in place of the current slider
- check if there's a CD in the drive before trying to play anything
- try to load optical media depending on what's in the drive
- broadcasting and network client
- Play with OSD and stuff
- ports to other windowing system/OSes?
- Browser plugin ? See for examples:
  http://lxr.mozilla.org/seamonkey/source/modules/plugin/samples/default/unix/ for examples
  http://devedge.netscape.com/library/manuals/2002/plugin/1.0/preface.html
- split the baconvideowidget into a GtkWidget and a GObject (use a GInterface)?
- add equaliser support to the API
- be able to choose the deinterlace method?
http://article.gmane.org/gmane.comp.video.xine.devel/4304/match=tvtime
- white bits on the screen when switching to fullscreen (more obvious when changing res as well)
- accessible subtitles?
http://article.gmane.org/gmane.comp.video.xine.devel/3456/match=+api+addition+subtitles+accessibility
- implement a subclass of the checkbox menu item that takes two strings as parameters and switche between the two depending on the state (eg. Lock/Unlock)
- enhance the look of the controls popup in fullscreen
- rtsp plugin for xine?
http://www.live.com/liveMedia/#testProgs
- finish vanity

GStreamer backend TODO
======================
- bacon_video_widget_get_current_frame (screenshot)
- audio cd playback, with cddb (track listing, info retreival)
- VCD playback
- DVD playback with menus (unstable)
- fps, bitrate
- deinterlacing
- network connection speed (mmsh://, http://, rtsp://...)
- subtitles and languages (not only DVD, ogg/ogm as well)
- aspect ratio changes

BUGS
====

Bugs should be lodged in Gnome's Bugzilla:
http://bugzilla.gnome.org/enter_bug.cgi?product=totem

To get a better debug output, run:
gconftool-2 --set --type bool /apps/totem/debug true

Contact
=======

Bastien Nocera <hadess@hadess.net>
http://hadess.net/totem.php3

