path: root/README

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

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://lists.gnome.org/archives/gnome-announce-list/2003-May/msg00096.html

News
====

1.0(?):
* Fixed XFree86 lockup on start bug (see http://bugs.xfree86.org/cgi-bin/bugzilla/show_bug.cgi?id=260 for the patch)
* Automatic resolution switching when going to fullscreen with auto-resize
enabled (useful for TV output)
* Audio output selection: stereo, 4.0, 5.0 or 5.1 channels
* Changed default command-line action to replace, not enqueue
* Plenty of small bug fixes (see ChangeLog)

0.99.1:
* Added a automatic downloader for the DLLs on x86 machines
* Added a brightness and contrast preferences
* Fixed display of filenames in non-UTF-8 encodings without warnings
* Many behavioural fixes for the GStreamer backend
* HIG fixes for most of the dialogues
* Make it possible to turn off subtitles in DVDs if "no subtitles" is not the
  default
* Try harder to thumbnail short movies
* Make OGM subtitles and alternate soundtracks work
* Fix a crash when starting up totem from nautilus with more than one file
* Autostart playback of optical media if they're listed on the command-line
* FreeBSD build fixes

0.99.0:
* Added support for error messages coming from the xine engine itself
* Fixed playbacks of DVDs and other media in the movie menu
* Speed up playlist loading
* Worked around a bug in egg-recent that would add a '/' to local filenames
* Read links in .desktop files to be able to use the drag'n'drop of the video
  as a bookmark system
* devfs support, FreeBSD support and misc. parsing fixes for the CD
  selection widget
* moved fullscreen code out of the video widget and into totem (enables
  fullscreen to work on the gstreamer backend)
* Automatic GNOME-based Proxy configuration
* Make the visual quality option menu actually work
* Add the /apps/totem/debug entry to enable debug in the playback engine
* Fixes concerning the colliding error and buffering dialogs
* Added a --disable-lirc argument to configure
* Fix handling of Recent Files and URIs

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
====

- 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
- 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?
- implement parsing of gxine's playlist (see xine-ui/src/xitk mediamark.c, guess_gx_playlist)
- 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)
- remove the processed gtk+/glib command-line parameters from the argv
- implement recursive loading for directories in the playlist only for local directories
- enhance the look of the controls popup in fullscreen
- fix the skip to spinner's range not getting updated (see update_mrl_label)
- register all the icons with the stock stuff (see bluecurve for what icons
we could be getting)
- rtsp plugin for xine?
http://www.live.com/liveMedia/#testProgs

From Iain:
> if (position_in_file > 1second) {
>    seek (0);
> } else {
>    go_to_previous_track ();
> }

GStreamer backend TODO
======================
- brightness/contrast (See http://bugzilla.gnome.org/show_bug.cgi?id=115823)
- bacon_video_widget_get_current_frame
- audio cd playback, with cddb
- VCD playback
- DVD playback with menus
- fps, bitrate, fourcc information
- detect properly if there's a sound device
- proprietary plugins?
- deinterlacing
- network connection speed (mmsh://, http://, rtsp://...)
- subtitles and languages (not only DVD, ogg/ogm as well)
- better error messages (see xine backend for examples)
- aspect ratio changes

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