737
696
and choose the subtitle language you want to display.</para>
738
697
<para>To disable the display of subtitles, select
739
698
<menuchoice><guimenu>View</guimenu><guisubmenu>Subtitles</guisubmenu><guimenuitem>None</guimenuitem></menuchoice>.</para>
740
<note><para>By default, &app; will choose the same language for the
699
<note><para>By default, <application>&app;</application> will choose the same language for the
741
700
subtitles as the one you normally use on your computer.</para></note>
742
<tip><para>&app; will automatically load and display subtitles if the file which contains them has the same
743
name as the video file played and the extension <filename>asc</filename>, <filename>txt</filename>,
744
<filename>sub</filename>, <filename>smi</filename>, or <filename>ssa</filename>.
701
<para><application>&app;</application> will automatically load and display subtitles for a video if it finds a subtitle file with the
702
same name as the video being played, and the extension <filename>asc</filename>, <filename>txt</filename>,
703
<filename>sub</filename>, <filename>srt</filename>, <filename>smi</filename>, <filename>ssa</filename> or <filename>ass</filename>.
705
<para>If the file containing the subtitles has a different name from the video being played, you can
706
right-click on the video in the playlist and choose <menuchoice><guimenuitem>Select Text Subtitles</guimenuitem></menuchoice>
707
from the popup menu to load the correct subtitle file. You may also choose subtitles by choosing
708
<menuchoice><guimenu>View</guimenu><guimenuitem>Select Text Subtitles</guimenuitem></menuchoice>.</para>
709
<para>Using the <guilabel>Subtitles downloader</guilabel> plugin, you can also download subtitles from the OpenSubtitles service. See
710
<xref linkend="totem-plugins-opensubtitles"/> for more information.</para>
748
713
<sect2 id="totem-usage-take-screenshot">
749
714
<title>To Take a Screenshot</title>
750
<para>To take a screenshot of the movie or visualisation that is playing, choose
715
<para>To take a screenshot of the movie or visualization that is playing, choose
752
717
<guimenu>Edit</guimenu>
753
718
<guimenuitem>Take Screenshot</guimenuitem>
754
</menuchoice>. The <guilabel>Save Screenshot</guilabel> dialog is displayed. Choose a location and
755
insert the filename as which you want to save the screenshot, then click the <guibutton>Save</guibutton> button
756
to save the screenshot.
758
<tip><para>&app; will display a preview of the screenshot which is to be saved on the left-hand side of the <guilabel>Save Screenshot</guilabel> dialog.</para></tip>
719
</menuchoice>. The <application>Save Screenshot</application> dialog is displayed. Choose a location and
720
insert the filename as which you want to save the screenshot, then click on the <guibutton>Save</guibutton> button
721
to save the screenshot.
723
<tip><para><application>&app;</application> will display a preview of the screenshot which is to be saved on the left-hand side of the <application>Save Screenshot</application> dialog.</para></tip>
726
<sect2 id="totem-usage-create-screenshot-gallery">
727
<title>To Create a Screenshot Gallery</title>
728
<para>To create a gallery of screenshots of the movie or visualization that is playing, choose
730
<guimenu>Edit</guimenu>
731
<guimenuitem>Create Screenshot Gallery</guimenuitem>
732
</menuchoice>. The <application>Save Gallery</application> dialog is displayed. Choose a location and
733
insert the filename as which you want to save the gallery image, then click on the <guibutton>Save</guibutton> button
734
to save the screenshot.
736
<tip><para>You may specify the width of the individual screenshots in the gallery using the <guilabel>Screenshot width</guilabel> entry.
737
The default width is 128 pixels.</para>
738
<para>You may also specify the number of screenshots to be put in the gallery. By default, this is calculated based on the length of the movie;
739
however, this may be overridden by deselecting the <guilabel>Calculate the number of screenshots</guilabel> checkbox and entering the new
740
number in the <guilabel>Number of screenshots</guilabel> spin box.</para></tip>
744
<!-- =========== Plugins ======================================= -->
745
<sect1 id="totem-plugins">
746
<title>Plugins</title>
747
<para><application>&app;</application> has many features which are present in the form of plugins — pieces of the software which are only loaded
749
<sect2 id="totem-plugins-load">
750
<title>To Enable a Plugin</title>
751
<para>To view the list of installed plugins, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Plugins</guimenuitem></menuchoice>. The
752
<application>Configure Plugins</application> dialog is displayed. On the left is a list of all the plugins you have installed, while on the right is
753
a description of the currently selected plugin. Plugins which have options which can be changed will have a sensitive <guibutton>Configure</guibutton>
754
button on the right.</para>
755
<para>To enable a plugin, simply select the checkbox to the left of its name in the plugin list, and the plugin will be loaded immediately. If
756
there is any error loading the plugin, an error dialog will also be displayed immediately.</para>
757
<para>To disable a plugin again, deselect its checkbox. Plugins will remain enabled or disabled as set even when <application>&app;</application> is
760
<sect2 id="totem-plugins-always-on-top">
761
<title>Always on Top</title>
762
<para>When enabled, the <guilabel>Always on Top</guilabel> plugin will force the main <application>&app;</application> window to be on top of
763
all other windows while a movie is playing, but not while audio or visualizations are playing. To stop the window being on top, disable
764
the plugin again.</para>
766
<sect2 id="totem-plugins-coherence">
767
<title>Coherence DLNA/UPnP Client</title>
768
<para>The <guilabel>Coherence DLNA/UPnP Client</guilabel> plugin allows <application>&app;</application> to play multimedia content from
769
UPnP media servers (such as Coherence servers) on the local network.</para>
770
<para>With the <guilabel>Coherence DLNA/UPnP Client</guilabel> plugin enabled, choose
771
<menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the
772
<guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Coherence DLNA/UPnP Client</guilabel> from the drop-down list at the
773
top of the sidebar to display the <guilabel>Coherence DLNA/UPnP Client</guilabel> sidebar.</para>
774
<para>The tree view in the sidebar will list the available media servers. Clicking on one will expand it to show the types of media it can serve,
775
and clicking on a media folder will expand it to list the media files available. Double-clicking on a media file will add it to
776
<application>&app;</application>'s playlist and play it. You may alternatively right-click on a file and choose
777
<menuchoice><guimenuitem>Play</guimenuitem></menuchoice> or <menuchoice><guimenuitem>Enqueue</guimenuitem></menuchoice> to play the file
778
immediately or add it to the playlist, respectively.</para>
779
<para>If the media server allows it, choosing <menuchoice><guimenuitem>Delete</guimenuitem></menuchoice> from a file's context menu allows you to
780
delete that file from the media server.</para>
782
<sect2 id="totem-plugins-gromit">
783
<title>Gromit Annotations</title>
784
<para>The <guilabel>Gromit Annotations</guilabel> plugin allows you to draw on top of movies as they are played using
785
<ulink type="http" url="http://www.home.unix-ag.org/simon/gromit/"><application>Gromit</application></ulink>. You must have
786
<application>Gromit</application> installed before you can enable the plugin — consult your operating system documentation for
787
information on how to do this.</para>
788
<para>With the plugin enabled, press <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo> to toggle <application>Gromit</application>
789
on or off. When <application>Gromit</application> is enabled, your pointer will change to a crosshair. To draw on the screen, hold down your
790
mouse button and drag your pointer around, before releasing your mouse button. Press <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo>
791
again to toggle <application>Gromit</application> off.</para>
792
<para>To clear the screen of annotations, press <keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>, or close
793
<application>&app;</application>.</para>
795
<sect2 id="totem-plugins-jamendo">
796
<title>Jamendo</title>
797
<para>The <guilabel>Jamendo</guilabel> plugin allows you to listen to the collection of Creative Commons-licensed music on the
798
<ulink type="http" url="http://www.jamendo.com/en/">Jamendo</ulink> service.</para>
799
<sect3 id="totem-plugins-jamendo-configuration">
800
<title>To Configure the Plugin</title>
801
<para>The <guilabel>Jamendo</guilabel> plugin can be configured. Click on the <guibutton>Configure</guibutton> button when enabling the plugin,
802
and the <application>Jamendo Plugin Configuration</application> dialog will be displayed. Here, you can choose whether to download songs in Ogg or
803
MP3 format (Ogg is preferred due to its open-source nature); and the number of albums to retrieve when doing a search (choose more albums if
804
you have a faster Internet connection).</para>
805
<para>Once you're done, click <guibutton>OK</guibutton>.</para>
807
<sect3 id="totem-plugins-jamendo-setup">
808
<title>To Display the Jamendo Sidebar</title>
809
<para>With the <guilabel>Jamendo</guilabel> plugin enabled, choose
810
<menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the
811
<guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Jamendo</guilabel> from the drop-down list at the top of the sidebar
812
to display the <guilabel>Jamendo</guilabel> sidebar.</para>
814
<sect3 id="totem-plugins-jamendo-search">
815
<title>To Search for Music</title>
816
<para>Enter your search terms in the search entry at the top of the <guilabel>Jamendo</guilabel> sidebar. You can search by either artist or
817
by tags. Click on the search button to start your search.</para>
818
<para>Search results will be displayed in the tree view in the <guilabel>Search Results</guilabel> page of the sidebar, and can be browsed
819
through using the arrow buttons at the bottom of the sidebar. Albums are listed, and if you click on an album, its tracks will be listed
820
below it. Click again to hide the album's tracks.</para>
821
<para>With an artist selected, you can click on the <guibutton>Jamendo Album Page</guibutton> button to open that album's page on the
822
Jamendo website. Double-clicking an album, or choosing <menuchoice><guimenuitem>Add to Playlist</guimenuitem></menuchoice> from the album's
823
context menu, will replace your playlist with all the tracks on that album and begin streaming the first track from Jamendo's website.
824
Double-clicking an individual track will replace your playlist with just that track.</para>
826
<sect3 id="totem-plugins-jamendo-popular">
827
<title>Popular Albums and Latest Releases</title>
828
<para>Viewing the <guilabel>Popular</guilabel> page in the <guilabel>Jamendo</guilabel> sidebar will load a list of the most popular albums
829
on Jamendo at the moment, which can be played as with search results. Viewing the <guilabel>Latest Releases</guilabel> page will likewise
830
load a list of the latest albums released on Jamendo.</para>
833
<sect2 id="totem-plugins-tracker">
834
<title>Local Search</title>
835
<para>The <guilabel>Local Search</guilabel> plugin allows you to search for playable movies and audio files on your computer from within
836
<application>&app;</application>. With the plugin enabled, choose
837
<menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the
838
<guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Local Search</guilabel> from the drop-down list at the top of the
839
sidebar to display the <guilabel>Local Search</guilabel> sidebar.</para>
840
<para>To perform a search, enter your search terms in the search entry at the top of the sidebar and click <guibutton>Find</guibutton>. Your
841
search terms may include wildcards such as <literal>*</literal>, which will match any character. For example, the search
842
<userinput>*.mpg</userinput> will find all movies with the <filename class="extension">.mpg</filename> file extension.</para>
843
<para>Search results may be browsed using the <guibutton>Back</guibutton> and <guibutton>Forward</guibutton> buttons at the bottom of the
844
sidebar, and you may jump to a specific results page by entering its number in the spin box.</para>
846
<sect2 id="totem-plugins-publish">
847
<title>Publish Playlist</title>
848
<para>The <guilabel>Publish Playlist</guilabel> plugin allows you to publish playlists on your local network to allow other computers to access
849
and play them.</para>
850
<sect3 id="totem-plugins-publish-configuration">
851
<title>To Configure the Plugin</title>
852
<para>The <guilabel>Publish Playlist</guilabel> plugin can be configured. Click on the <guibutton>Configure</guibutton> button when enabling the
853
plugin, and the configuration dialog will be displayed. Here, you can change the name which will appear for your playlist share. The following
854
strings will be replaced when playlists are published:
857
<term><literal>%a</literal></term>
858
<listitem><para>Replaced with the program's name: <application>&app;</application>.</para></listitem>
861
<term><literal>%h</literal></term>
862
<listitem><para>Replaced with your computer's host name.</para></listitem>
865
<term><literal>%u</literal></term>
866
<listitem><para>Replaced with your username.</para></listitem>
869
<term><literal>%U</literal></term>
870
<listitem><para>Replaced with your real name.</para></listitem>
873
<term><literal>%%</literal></term>
874
<listitem><para>Replaced with a literal percent sign.</para></listitem>
878
<para>You can also select the <guilabel>Use encrypted transport protocol</guilabel> checkbox if you wish to encrypt the shared playlists when
879
they're transmitted over the network.</para>
880
<para>Once you're done, click <guibutton>Close</guibutton>.</para>
882
<sect3 id="totem-plugins-publish-publishing">
883
<title>To Publish Playlists</title>
884
<para>With the plugin enabled, you do not need to explicitly publish playlists; they are automatically made available on the network as
885
a Zeroconf website.</para>
887
<sect3 id="totem-plugins-publish-neighborhood">
888
<title>To Browse your Neighborhood</title>
889
<para>To view the shared playlists of others on your network, select <guilabel>Neighborhood</guilabel> from the drop-down list at the top of the
890
sidebar. If any playlists have been published on the network, they will be listed here. Double-click on a playlist to load and play it on
891
your computer.</para>
894
<sect2 id="totem-plugins-opensubtitles">
895
<title>Subtitles downloader</title>
896
<para>The <guilabel>Subtitles downloader</guilabel> plugin allows you to find and download subtitle files from the
897
<ulink type="http" url="http://www.opensubtitles.org/en">OpenSubtitles</ulink> service.</para>
898
<para>Subtitles can only be downloaded for local movies; not audio files, DVDs, DVB streams, VCDs or HTTP streams. To search for subtitles for
899
the currently playing movie, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Download Movie Subtitles</guimenuitem></menuchoice>, which
900
will display the <application>Download Movie Subtitles</application> dialog.</para>
901
<para>Select the language in which you wish to have your subtitles from the drop-down list at the top of the dialog, then click on the
902
<guibutton>Find</guibutton> button to search for subtitles for the current movie. Subtitles are found on the basis of the movie's content,
903
rather than its filename or tags.</para>
904
<para>Search results are listed in the tree view in the middle of the dialog. Currently, subtitles can only be used with a movie by
905
<emphasis>reloading</emphasis> the movie with the subtitles, so after selecting the subtitle file you wish to download, click on the
906
<guibutton>Play with Subtitle</guibutton> button to download the subtitles and reload the movie.</para>
907
<note><para>Downloaded subtitle files are cached so that they do not need to be downloaded again when playing the movie again. When downloading
908
new subtitles for a movie, any previously downloaded subtitles for that movie are deleted.</para></note>
910
<sect2 id="totem-plugins-thumbnail">
911
<title>Thumbnail</title>
912
<para>The <guilabel>Thumbnail</guilabel> plugin sets <application>&app;</application>'s main window icon to a thumbnail of the current movie,
913
and updates the icon when new movies are loaded.</para>
914
<note><para>If a thumbnail doesn't exist for the current movie (or if you're playing an audio file), the main window icon will be reset to the
915
<application>&app;</application> logo.</para></note>
917
<sect2 id="totem-plugins-brasero">
918
<title>Video Disc Recorder</title>
919
<para>The <guilabel>Video Disc Recorder</guilabel> plugin allows you to burn the current playlist to a DVD or VCD using <application>Brasero</application>.</para>
920
<para>To burn the current playlist, choose <menuchoice><guimenu>Movie</guimenu><guimenuitem>Create Video Disc</guimenuitem></menuchoice>.
921
A <application>Brasero</application> dialog will be displayed, giving options for converting the movies to the appropriate format and burning them to disc. For more
922
information, see the <ulink type="help" url="ghelp:brasero?brasero-new-project-video">Brasero documentation</ulink>.</para>
924
<sect2 id="totem-plugins-youtube">
925
<title>YouTube browser</title>
926
<para>The <guilabel>YouTube browser</guilabel> plugin allows you to search and browse
927
<ulink type="http" url="http://www.youtube.com/">YouTube</ulink>, and play YouTube videos directly in
928
<application>&app;</application>. With the plugin enabled, choose
929
<menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the
930
<guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>YouTube</guilabel> from the drop-down list at the top of the
931
sidebar to display the <guilabel>YouTube</guilabel> sidebar.</para>
932
<para>To search for a YouTube video, enter your search terms in the entry at the top of the sidebar, then click <guibutton>Find</guibutton>.
933
The search results will be listed in the tree view below. More results will be loaded automatically as you scroll down the list.</para>
934
<para>To play a video, double-click it in the results list, or choose <menuchoice><guimenuitem>Add to Playlist</guimenuitem></menuchoice> from
935
its context menu. When a video is played, a list of related videos will automatically be loaded in the <guilabel>Related Videos</guilabel>
936
page of the <guilabel>YouTube</guilabel> sidebar.</para>
937
<para>YouTube videos can be opened in a web browser by choosing <menuchoice><guimenuitem>Open in Web Browser</guimenuitem></menuchoice> from
938
their context menu. This will open the video in its original location on the YouTube website.</para>
763
942
<!-- =========== Usage ======================================= -->