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

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

News
====

0.98.0:
* Added the Vanity webcam utility
* Added a Nautilus properties page
* Added options to configure the visual effects more precisely
* Added a buffering dialog for when opening network files, statusbar now says
  "Streaming" when streaming from the network
* Really set the Real decoders' path, link the DLLs from /usr/lib/win32 on
  startup
* Draw a black background on the video widget on startup
* Fix resizing to sizes smaller than the default dimensions
* Fix a crash when using the "Open Location..." dialog
* Fix a crash in the error dialog
* Don't start playback on startup when restoring playlists
* Gstreamer backend updates

0.97.0:
* Experimental GStreamer backend (pass --enable-gstreamer to configure)
* Re-enable the visuals on the fly
* Added a TV-out feature via DXR3 or NVTV
* Implement playlist reordering, saving, and automatic restore on startup
* Added a button to get a filemanager to add new proprietary plugins (DLLs,
  and Real Media .so files)
* Added a deinterlacing setting
* Added a popup menu on the video canvas
* Make it possible to hide everything but the video canvas
* Fix positioning problem with the popup controls when switching to fullscreen
  for the first time
* Fix the thumbnailer (better to test it next time...)

0.96.0:
* Added subtitles and audio languages selection menus for DVDs
* Added support for setting the network connection speed
* Added mousewheel support for all the sliders
* Added an "Open Location" menu item to the File menu
* Make it possible to make screenshots of the vis plugins, and switch them
  off and on on-the-fly
* Add 'Always on Top' functionality
* Added an Eject button
* Add SMIL playlist support, and differentiate Real Video playlists from the
  actual video files
* Thumbnails now have "film-like" holes on their sides, like cells
* Fix lockups on Red Hat Linux 9
* Make the playlist and the label use CDDB information
* Use an internal mixer for the volume instead of the system one
* Use the configured CD device for the CDDA plugin
* Fix a crash when it was a URI being drag and not a local filename
* Fix build system for the thumbnailer's schemas
* Much less verbosity on the command line
* Fix a problem with the "remote" API which would make Totem receive only
  the first file of a list of them
* Fix a crash when changing the resolution of the screen, in fullscreen mode

0.95.1:
* Fix a crasher bug when switching to fullscreen

0.95.0:
* Xinerama, dual-head and RandR support
* Added a "remote" mode to control a running Totem
* Seeking with the seekbar is no longer a mess
* Fix screenshots when the aspect ratio was 1.0
* Better error reporting
* Fix statusbar time reporting
* Actually use detection by content instead of suffix guesses
* Support Real Audio URLs in the playlist
* Make it possible to cycle the playlist both ways in repeat mode
* Renamed GtkXine to BaconVideoWidget
* Plenty of compilation and bug fixes, memleaks plugged

0.90.0:
* added Screenshot function
* drag'n'drop and mousewheel actions for the video canvas
  (drag a video to the desktop to bookmark it)
* added a video thumbnailer for Nautilus
* faster video widget with faster fullscreen
* added authentication dialogs for locations needing it
* moved the gnome-vfs plugin to xine-lib
* make it work on remote displays
* some cleanups making seeking faster
* added visual effects for audio-only files
* added a statusbar
* added CDDA support (Digital CD playback)
* added subtitle support (only on the command-line, use like:
  "totem file.avi#subtitle:file.sub")
* added a dialog for more precise seeking
* plenty of bug fixes

0.13.1:
* Make it work again on glib-2.x based platforms
* CD selection widget fixes

0.13.0:
* Plenty of small bug fixes
* Detection and easier selection of the Optical Media Drive
* Better DVD navigation (John McCutchan <ttb@tentacle.dhs.org>)
* Fix wrong aspect ratio

0.12.1:
* Fix DVD playback from the menu item
* Added the Real Media types to the list of handled files

0.12.0:
* Port to the new xine API (1.0 alpha)
* New Properties window
* Working preferences (whoo! stop asking about that one now)
* Add support for more multimedia keys (grab ACME CVS to configure them</hint>)
* Plenty of cleaning up (Daniel Caujolle-Bert, myself)
* Some minor UI changes (icons and layout, by Luca Ferretti)
* Be more helpful to the user about DVD and VCD playback

0.11.0:
* Fix 2 crasher bugs with the playlist (with help from Sebastien Bacher
<seb128@debian.org>)
* Recent files support (James Willcox <jwillcox@gnome.org> and myself)
* Added preference to change the window size when a new file is loaded
* lirc remote control support (James Willcox <jwillcox@gnome.org>)
* .spec file for Red Hat distros (Matthias Saou <matthias@rpmforge.net>)

0.10.0:
* Minor UI bugfixes
* Fix leak in scale ratio change by not using xine_get_current_frame()
* Fix some memory leaks
* Fix .desktop file installation
* Make DVD and VCD playback work
* Make the file selectors remember the path they were in
* Made it so that the fullscreen window would always overlap the normal UI

0.9.1:
* Fix the gconf schemas file

0.9:
* Fixed nautilus integration and support more file-types
* Killed all the lockups with a better threading
* Loads of small bug fixes
* New logo
* Add scaling menu items and shortcuts
* Disable the screensaver when in full-screen mode

0.8:
* Removed eel dependency
* Added dnd to both the main window and the playlist
* Volume is not accessible if the sound device is busy or inexistant
* Nifty icon reflecting the volume
* Aspect toggling
* Some UI changes
* More error checking

0.7:
* First release !

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

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

Controls
========

I:
	Switch deinterlacing on and off
P:
	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
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
====

- gtk_xine_play/pause instead of set_speed (hmmm)
- Maybe move it into monkeymedia? The only real gnome deps
  are gnomevfs and gconf, and i believe gtkxine depends on them already
  anyway. Would be nice to not have to pull the mm bits from a thousand
  places :)
- Removing hard-coded deps in monkey-media:
  <hadess> if you dl_open'ed the libraries when they are needed, i would
  be 100 % with it
- Play with OSD and stuff
- 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
- Read the URI in .desktop files and add that to the playlist (otherwise we
  can't drop stuff we dragged from Totem)
- have a "progress" thing going when adding more than a couple of files
- check that the fake event is generated more often, depending on the
  intervals of the screensaver
- automatic download and install of the proprietary codecs
  decoders needing it:
    - w32
    - qt
    - real
  types of files:
    - .dll, .acm, .ax
  types of install:
    - cabextract-able

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

Rebuild totem with --enable-debug to get a better debug output

Contact
=======

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

