806
765
and choose the subtitle language you want to display.</para>
807
766
<para>To disable the display of subtitles, select
808
767
<menuchoice><guimenu>View</guimenu><guisubmenu>Subtitles</guisubmenu><guimenuitem>None</guimenuitem></menuchoice>.</para>
809
<note><para>By default, Totem Movie Player will choose the same language for the
768
<note><para>By default, <application>Totem Movie Player</application> will choose the same language for the
810
769
subtitles as the one you normally use on your computer.</para></note>
811
<tip><para>Totem Movie Player will automatically load and display subtitles if the file which contains them has the same
812
name as the video file played and the extension <filename>asc</filename>, <filename>txt</filename>,
813
<filename>sub</filename>, <filename>smi</filename>, or <filename>ssa</filename>.
770
<para><application>Totem Movie Player</application> will automatically load and display subtitles for a video if it finds a subtitle file with the
771
same name as the video being played, and the extension <filename>asc</filename>, <filename>txt</filename>,
772
<filename>sub</filename>, <filename>srt</filename>, <filename>smi</filename>, <filename>ssa</filename> or <filename>ass</filename>.
774
<para>If the file containing the subtitles has a different name from the video being played, you can
775
right-click on the video in the playlist and choose <menuchoice><guimenuitem>Select Text Subtitles</guimenuitem></menuchoice>
776
from the popup menu to load the correct subtitle file. You may also choose subtitles by choosing
777
<menuchoice><guimenu>View</guimenu><guimenuitem>Select Text Subtitles</guimenuitem></menuchoice>.</para>
778
<para>Using the <guilabel>Subtitles downloader</guilabel> plugin, you can also download subtitles from the OpenSubtitles service. See
779
<xref linkend="totem-plugins-opensubtitles"/> for more information.</para>
817
782
<sect2 id="totem-usage-take-screenshot">
818
783
<title>To Take a Screenshot</title>
819
<para>To take a screenshot of the movie or visualisation that is playing, choose
784
<para>To take a screenshot of the movie or visualization that is playing, choose
821
786
<guimenu>Edit</guimenu>
822
787
<guimenuitem>Take Screenshot</guimenuitem>
823
</menuchoice>. The <guilabel>Save Screenshot</guilabel> dialog is displayed. Choose a location and
824
insert the filename as which you want to save the screenshot, then click the <guibutton>Save</guibutton> button
825
to save the screenshot.
827
<tip><para>Totem Movie Player 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>
788
</menuchoice>. The <application>Save Screenshot</application> dialog is displayed. Choose a location and
789
insert the filename as which you want to save the screenshot, then click on the <guibutton>Save</guibutton> button
790
to save the screenshot.
792
<tip><para><application>Totem Movie Player</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>
795
<sect2 id="totem-usage-create-screenshot-gallery">
796
<title>To Create a Screenshot Gallery</title>
797
<para>To create a gallery of screenshots of the movie or visualization that is playing, choose
799
<guimenu>Edit</guimenu>
800
<guimenuitem>Create Screenshot Gallery</guimenuitem>
801
</menuchoice>. The <application>Save Gallery</application> dialog is displayed. Choose a location and
802
insert the filename as which you want to save the gallery image, then click on the <guibutton>Save</guibutton> button
803
to save the screenshot.
805
<tip><para>You may specify the width of the individual screenshots in the gallery using the <guilabel>Screenshot width</guilabel> entry.
806
The default width is 128 pixels.</para>
807
<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;
808
however, this may be overridden by deselecting the <guilabel>Calculate the number of screenshots</guilabel> checkbox and entering the new
809
number in the <guilabel>Number of screenshots</guilabel> spin box.</para></tip>
813
<!-- =========== Plugins ======================================= -->
814
<sect1 id="totem-plugins">
815
<title>Plugins</title>
816
<para><application>Totem Movie Player</application> has many features which are present in the form of plugins — pieces of the software which are only loaded
818
<sect2 id="totem-plugins-load">
819
<title>To Enable a Plugin</title>
820
<para>To view the list of installed plugins, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Plugins</guimenuitem></menuchoice>. The
821
<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
822
a description of the currently selected plugin. Plugins which have options which can be changed will have a sensitive <guibutton>Configure</guibutton>
823
button on the right.</para>
824
<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
825
there is any error loading the plugin, an error dialog will also be displayed immediately.</para>
826
<para>To disable a plugin again, deselect its checkbox. Plugins will remain enabled or disabled as set even when <application>Totem Movie Player</application> is
829
<sect2 id="totem-plugins-always-on-top">
830
<title>Always on Top</title>
831
<para>When enabled, the <guilabel>Always on Top</guilabel> plugin will force the main <application>Totem Movie Player</application> window to be on top of
832
all other windows while a movie is playing, but not while audio or visualizations are playing. To stop the window being on top, disable
833
the plugin again.</para>
835
<sect2 id="totem-plugins-coherence">
836
<title>Coherence DLNA/UPnP Client</title>
837
<para>The <guilabel>Coherence DLNA/UPnP Client</guilabel> plugin allows <application>Totem Movie Player</application> to play multimedia content from
838
UPnP media servers (such as Coherence servers) on the local network.</para>
839
<para>With the <guilabel>Coherence DLNA/UPnP Client</guilabel> plugin enabled, choose
840
<menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the
841
<guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Coherence DLNA/UPnP Client</guilabel> from the drop-down list at the
842
top of the sidebar to display the <guilabel>Coherence DLNA/UPnP Client</guilabel> sidebar.</para>
843
<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,
844
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
845
<application>Totem Movie Player</application>'s playlist and play it. You may alternatively right-click on a file and choose
846
<menuchoice><guimenuitem>Play</guimenuitem></menuchoice> or <menuchoice><guimenuitem>Enqueue</guimenuitem></menuchoice> to play the file
847
immediately or add it to the playlist, respectively.</para>
848
<para>If the media server allows it, choosing <menuchoice><guimenuitem>Delete</guimenuitem></menuchoice> from a file's context menu allows you to
849
delete that file from the media server.</para>
851
<sect2 id="totem-plugins-gromit">
852
<title>Gromit Annotations</title>
853
<para>The <guilabel>Gromit Annotations</guilabel> plugin allows you to draw on top of movies as they are played using
854
<ulink type="http" url="http://www.home.unix-ag.org/simon/gromit/"><application>Gromit</application></ulink>. You must have
855
<application>Gromit</application> installed before you can enable the plugin — consult your operating system documentation for
856
information on how to do this.</para>
857
<para>With the plugin enabled, press <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo> to toggle <application>Gromit</application>
858
on or off. When <application>Gromit</application> is enabled, your pointer will change to a crosshair. To draw on the screen, hold down your
859
mouse button and drag your pointer around, before releasing your mouse button. Press <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo>
860
again to toggle <application>Gromit</application> off.</para>
861
<para>To clear the screen of annotations, press <keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>, or close
862
<application>Totem Movie Player</application>.</para>
864
<sect2 id="totem-plugins-jamendo">
865
<title>Jamendo</title>
866
<para>The <guilabel>Jamendo</guilabel> plugin allows you to listen to the collection of Creative Commons-licensed music on the
867
<ulink type="http" url="http://www.jamendo.com/en/">Jamendo</ulink> service.</para>
868
<sect3 id="totem-plugins-jamendo-configuration">
869
<title>To Configure the Plugin</title>
870
<para>The <guilabel>Jamendo</guilabel> plugin can be configured. Click on the <guibutton>Configure</guibutton> button when enabling the plugin,
871
and the <application>Jamendo Plugin Configuration</application> dialog will be displayed. Here, you can choose whether to download songs in Ogg or
872
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
873
you have a faster Internet connection).</para>
874
<para>Once you're done, click <guibutton>OK</guibutton>.</para>
876
<sect3 id="totem-plugins-jamendo-setup">
877
<title>To Display the Jamendo Sidebar</title>
878
<para>With the <guilabel>Jamendo</guilabel> plugin enabled, choose
879
<menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the
880
<guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Jamendo</guilabel> from the drop-down list at the top of the sidebar
881
to display the <guilabel>Jamendo</guilabel> sidebar.</para>
883
<sect3 id="totem-plugins-jamendo-search">
884
<title>To Search for Music</title>
885
<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
886
by tags. Click on the search button to start your search.</para>
887
<para>Search results will be displayed in the tree view in the <guilabel>Search Results</guilabel> page of the sidebar, and can be browsed
888
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
889
below it. Click again to hide the album's tracks.</para>
890
<para>With an artist selected, you can click on the <guibutton>Jamendo Album Page</guibutton> button to open that album's page on the
891
Jamendo website. Double-clicking an album, or choosing <menuchoice><guimenuitem>Add to Playlist</guimenuitem></menuchoice> from the album's
892
context menu, will replace your playlist with all the tracks on that album and begin streaming the first track from Jamendo's website.
893
Double-clicking an individual track will replace your playlist with just that track.</para>
895
<sect3 id="totem-plugins-jamendo-popular">
896
<title>Popular Albums and Latest Releases</title>
897
<para>Viewing the <guilabel>Popular</guilabel> page in the <guilabel>Jamendo</guilabel> sidebar will load a list of the most popular albums
898
on Jamendo at the moment, which can be played as with search results. Viewing the <guilabel>Latest Releases</guilabel> page will likewise
899
load a list of the latest albums released on Jamendo.</para>
902
<sect2 id="totem-plugins-tracker">
903
<title>Local Search</title>
904
<para>The <guilabel>Local Search</guilabel> plugin allows you to search for playable movies and audio files on your computer from within
905
<application>Totem Movie Player</application>. With the plugin enabled, choose
906
<menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the
907
<guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Local Search</guilabel> from the drop-down list at the top of the
908
sidebar to display the <guilabel>Local Search</guilabel> sidebar.</para>
909
<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
910
search terms may include wildcards such as <literal>*</literal>, which will match any character. For example, the search
911
<userinput>*.mpg</userinput> will find all movies with the <filename class="extension">.mpg</filename> file extension.</para>
912
<para>Search results may be browsed using the <guibutton>Back</guibutton> and <guibutton>Forward</guibutton> buttons at the bottom of the
913
sidebar, and you may jump to a specific results page by entering its number in the spin box.</para>
915
<sect2 id="totem-plugins-publish">
916
<title>Publish Playlist</title>
917
<para>The <guilabel>Publish Playlist</guilabel> plugin allows you to publish playlists on your local network to allow other computers to access
918
and play them.</para>
919
<sect3 id="totem-plugins-publish-configuration">
920
<title>To Configure the Plugin</title>
921
<para>The <guilabel>Publish Playlist</guilabel> plugin can be configured. Click on the <guibutton>Configure</guibutton> button when enabling the
922
plugin, and the configuration dialog will be displayed. Here, you can change the name which will appear for your playlist share. The following
923
strings will be replaced when playlists are published:
926
<term><literal>%a</literal></term>
927
<listitem><para>Replaced with the program's name: <application>Totem Movie Player</application>.</para></listitem>
930
<term><literal>%h</literal></term>
931
<listitem><para>Replaced with your computer's host name.</para></listitem>
934
<term><literal>%u</literal></term>
935
<listitem><para>Replaced with your username.</para></listitem>
938
<term><literal>%U</literal></term>
939
<listitem><para>Replaced with your real name.</para></listitem>
942
<term><literal>%%</literal></term>
943
<listitem><para>Replaced with a literal percent sign.</para></listitem>
947
<para>You can also select the <guilabel>Use encrypted transport protocol</guilabel> checkbox if you wish to encrypt the shared playlists when
948
they're transmitted over the network.</para>
949
<para>Once you're done, click <guibutton>Close</guibutton>.</para>
951
<sect3 id="totem-plugins-publish-publishing">
952
<title>To Publish Playlists</title>
953
<para>With the plugin enabled, you do not need to explicitly publish playlists; they are automatically made available on the network as
954
a Zeroconf website.</para>
956
<sect3 id="totem-plugins-publish-neighborhood">
957
<title>To Browse your Neighborhood</title>
958
<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
959
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
960
your computer.</para>
963
<sect2 id="totem-plugins-opensubtitles">
964
<title>Subtitles downloader</title>
965
<para>The <guilabel>Subtitles downloader</guilabel> plugin allows you to find and download subtitle files from the
966
<ulink type="http" url="http://www.opensubtitles.org/en">OpenSubtitles</ulink> service.</para>
967
<para>Subtitles can only be downloaded for local movies; not audio files, DVDs, DVB streams, VCDs or HTTP streams. To search for subtitles for
968
the currently playing movie, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Download Movie Subtitles</guimenuitem></menuchoice>, which
969
will display the <application>Download Movie Subtitles</application> dialog.</para>
970
<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
971
<guibutton>Find</guibutton> button to search for subtitles for the current movie. Subtitles are found on the basis of the movie's content,
972
rather than its filename or tags.</para>
973
<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
974
<emphasis>reloading</emphasis> the movie with the subtitles, so after selecting the subtitle file you wish to download, click on the
975
<guibutton>Play with Subtitle</guibutton> button to download the subtitles and reload the movie.</para>
976
<note><para>Downloaded subtitle files are cached so that they do not need to be downloaded again when playing the movie again. When downloading
977
new subtitles for a movie, any previously downloaded subtitles for that movie are deleted.</para></note>
979
<sect2 id="totem-plugins-thumbnail">
980
<title>Thumbnail</title>
981
<para>The <guilabel>Thumbnail</guilabel> plugin sets <application>Totem Movie Player</application>'s main window icon to a thumbnail of the current movie,
982
and updates the icon when new movies are loaded.</para>
983
<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
984
<application>Totem Movie Player</application> logo.</para></note>
986
<sect2 id="totem-plugins-brasero">
987
<title>Video Disc Recorder</title>
988
<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>
989
<para>To burn the current playlist, choose <menuchoice><guimenu>Movie</guimenu><guimenuitem>Create Video Disc</guimenuitem></menuchoice>.
990
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
991
information, see the <ulink type="help" url="ghelp:brasero?brasero-new-project-video">Brasero documentation</ulink>.</para>
993
<sect2 id="totem-plugins-youtube">
994
<title>YouTube browser</title>
995
<para>The <guilabel>YouTube browser</guilabel> plugin allows you to search and browse
996
<ulink type="http" url="http://www.youtube.com/">YouTube</ulink>, and play YouTube videos directly in
997
<application>Totem Movie Player</application>. With the plugin enabled, choose
998
<menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the
999
<guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>YouTube</guilabel> from the drop-down list at the top of the
1000
sidebar to display the <guilabel>YouTube</guilabel> sidebar.</para>
1001
<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>.
1002
The search results will be listed in the tree view below. More results will be loaded automatically as you scroll down the list.</para>
1003
<para>To play a video, double-click it in the results list, or choose <menuchoice><guimenuitem>Add to Playlist</guimenuitem></menuchoice> from
1004
its context menu. When a video is played, a list of related videos will automatically be loaded in the <guilabel>Related Videos</guilabel>
1005
page of the <guilabel>YouTube</guilabel> sidebar.</para>
1006
<para>YouTube videos can be opened in a web browser by choosing <menuchoice><guimenuitem>Open in Web Browser</guimenuitem></menuchoice> from
1007
their context menu. This will open the video in its original location on the YouTube website.</para>
832
1011
<!-- =========== Usage ======================================= -->
added
removed
help/oc/totem.xml
