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://mail.gnome.org/archives/gnome-announce-list/2003-October/msg00054.html

News
====

0.99.9:
* Add support for m4a, DV files and wax playlists
* HIG fixes
* Read additional data from extm3u playlists
* Warn the user when we can't play encrypted files
* Fix problems opening files with paths containing escape codes
* Fix bug with the popup window disappearing while dragging the
  volume slider
* Don't save removable media items in the playlists
* Fix a crash with taking a screenshot of small videos
* Small UI fixes

0.99.8:
* Online manual from Chee Bin HOH
* Use the statusbar for buffering feedback
* Use less memory when there's no video output
* Fix playback of Quicktime files with reference urls
* Fix Real playlists support with "stop" commands
* Support the XvMC video driver
* Support audio/x-ms-asf data type
* Added ability to launch totem in fullscreen mode
* Fix compilation with GTK+ 2.3.x

0.99.7:
* Fix .pls playlist parsing and saving, as well as .m3u, .asx and .desktop
  playlist parsing
* Fix seeking with the arrows
* Add more paths for the Realplayer codecs
* Add an error message when we can't save the playlist
* Fix warnings when we have ampersands in the filename
* Fix XRandR handling

0.99.6:
* Shuffle option in playlist
* Make HTTP proxies work again
* Fix scaling, fullscreen and visualisation in GStreamer backend
* Get the title of all the tracks when playing an Audio CD
* Plenty of fixes for streams playback (playback on start works, no network
  activity when paused)
* Much faster playlist parsing when the files contain known good extensions
* Make properties menu unsensitive when we didn't manage to open a file, or
  the logo was shown
* Fix restoration of the size on restart after exit in fullscreen
* Remove selected entries from the playlist with 'Delete'
* Use 'eject' to eject CDs and DVDs
* Fix parsing of some ASX playlists
* Ignore empty lines in .m3u files
* Make Shift+F10 display a popup menu
* Fix access keys
* Fix drag and dropping local files with '%' in their name
* Update the "skip to" spinner as time passes
* Fix a hang on exit when playing back a song with visual effects on and paused
* A lot of API changes in the BaocnVideoWidget, cleanups

0.99.5:
* Modify the volume slider to have shortcuts to 0% and 100%
* Work around screensaver not being disabled when using xscreensaver
* Release the soundcard on pause if xine-lib is new enough to allow so
* Fix window size restoration on startup
* HIG-ify the error dialogs
* Fix plural handling for i18n
* Fix most of the build warnings
* Fix double-free that might have weird consequences

0.99.4:
* Fix possible crasher due to an old version of glade
* Update the subtitle and languages menus after having played a DVD or ogm file

0.99.3:
* On-the-fly switching between visual effects plugins
* Allow AC3 passthrough sound
* Fix races when getting errors on startup
* Fix vanity compilation
* Better error messages
* Implement recursive directory loading in the playlist
* Update the playlist title when playing a CD with CDDB
* Check that we could get tracks before trying to playback optical media
* Don't tell nautilus we can't thumbnail a file if it just takes a long time
* Don't show the window in the current workspace when enqueuing songs
* Remember "Always On Top" setting, and video widget size across sessions
* Added Startup Notification for files opened from Nautilus
* Use Konqueror when clicking on the "Add proprietary plugins" button when KDE
  is running
* Make the screenshot menu item unsensitive when no file is playing
* Save screenshots to the right place when "desktop directory is selected", and
  the home directory is the desktop
* Make the CD selector work on FreeBSD
* Hide the popups when changing workspaces
* Fixup argument parsing
* Fix a memleak in the recent files
* Make lirc silent on startup
* Detect libcurl version properly
* Build fixes for XRandR

0.99.2:
* 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
* Stop the stream before exiting, fixes the long waits on exit
* Fix display of non-UTF8 id3 tags
* Rewrote most of the screensaver disabling code
* Implemented Winamp m3u compatibility and relative paths resolution
* Don't take more than 30 seconds to thumbnail a movie
* Fix the location of the screenshots if ~/Desktop exists (GNOME 2.3)
* Implemented seek to time (GStreamer)
* Sync'ed visuals quality with the xine backend (GStreamer)
* Really fix the position of the popup controls on first appearance

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

add an XINE_MSG_AUDIO_OUT_UNVAILABLE
audio_oss_out.c ao_oss_open ()
add check for open device in write()

- support gxine, freevo, ypl playlist formats
- use xpath where possible in playlist parsing
- fix command-line parsing
- write a widget more suitable for seeking in place of the current slider

- 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?
- 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
- 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
- finish vanity
- test with RTL languages

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