304
316
<!-- ================ Usage Subsection ================================ -->
305
317
<sect2 id="totem-open-file">
306
318
<title>To Open a File</title>
307
<para>To open a video or an audio file, choose <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></shortcut><guimenu>Movie</guimenu><guisubmenu>Open</guisubmenu></menuchoice>. The <guilabel>Select Movies or Playlists</guilabel> dialogue is displayed. Select the file(s) you want to open, then click <guibutton>OK</guibutton>.</para>
308
<para>You can drag a file from another application such as a file manager to the
309
<application>Totem Movie Player</application> window. The <application>Totem Movie Player</application> application
310
will open the file and play the movie or song. <application>Totem Movie Player</application>
311
displays the title of the movie or song in the titlebar of
312
the window and in the playlist in the sidebar.
314
<para>If you try to open a file format that <application>Totem Movie Player</application> does
315
not recognize, the application displays an error message. This error is most often encountered
316
if you do not have the correct codecs installed. Information on getting codecs working can be found on
317
the <ulink url="http://www.gnome.org/projects/totem/#codecs">Totem Movie Player website</ulink>.
319
<para>To open a video or an audio file, choose <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></shortcut><guimenu>Movie</guimenu><guisubmenu>Open</guisubmenu></menuchoice>. The <application>Select Movies or Playlists</application> dialogue is displayed. Select the file or files you want to open, then click <guibutton>OK</guibutton>.</para>
320
<para>You can drag a file from another application such as a file manager to the <application>Totem Movie Player</application> window. If you drag the file to the display area, the file will replace the current playlist and will start playing immediately. If you drag the file to the playlist in the sidebar, the file will be appended to the current playlist. The <application>Totem Movie Player</application> application will open the file and play the movie or song. <application>Totem Movie Player</application> displays the title of the movie or song in the titlebar of the window and in the playlist in the sidebar.</para>
321
<para>If you try to open a file format that <application>Totem Movie Player</application> does not recognise, the application displays an error message. This error is most often encountered if you do not have the correct codecs installed. Information on getting codecs working can be found on the <ulink url="http://projects.gnome.org/totem/#codecs" type="http"><application>Totem Movie Player</application> website</ulink>.</para>
320
<para>You can double-click on a video or an audio file in the <application>Nautilus</application> file manager to open it on the <application>Totem Movie Player</application> window.</para>
323
<para>You can double-click on a video or an audio file in the <application>Nautilus</application> file manager to open it in the <application>Totem Movie Player</application> window.</para>
324
327
<sect2 id="totem-usage-open-location">
325
328
<title>To Open a Location</title>
326
<para>To open a file by URI location, choose
328
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo></shortcut>
329
<guimenu>Movie</guimenu>
330
<guimenuitem>Open Location</guimenuitem>
331
</menuchoice>. The <guilabel>Open Location</guilabel> dialog is displayed. Use the drop-down
332
combination box to specify the URI location of file you would like to open (it lists URIs which have
333
previously been opened) – or type one in directly – then click
334
on the <guibutton>Open</guibutton> button.
329
<para>To open a file by URI (location), choose <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo></shortcut><guimenu>Movie</guimenu><guimenuitem>Open Location</guimenuitem></menuchoice>. The <application>Open Location</application> dialogue is displayed. Use the drop-down combination box to specify the URI you would like to open (it lists URIs which have previously been opened) – or type one in directly – then click on the <guibutton>Open</guibutton> button.</para>
330
<para>If you have a URI in the clipboard already, it will automatically be pasted into the combination box.</para>
338
333
<sect2 id="totem-usage-play">
339
<title>To Play a Movie (DVD, VCD or CD)</title>
334
<title>To Play a Movie (DVD or VCD)</title>
340
335
<para>Insert the disc in your computer's optical drive, then choose <menuchoice><guimenu>Movie</guimenu><guimenuitem>Play Disc</guimenuitem></menuchoice>.</para>
336
<para>To eject a DVD or VCD, choose <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo></shortcut><guimenu>Movie</guimenu><guimenuitem>Eject</guimenuitem></menuchoice>.</para>
343
<sect2 id="totem-usage-eject">
344
<title>To Eject a DVD, VCD or CD</title>
345
<para>To eject a DVD, VCD, or CD, choose <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo></shortcut><guimenu>Movie</guimenu><guimenuitem>Eject</guimenuitem></menuchoice>.</para>
348
339
<sect2 id="totem-usage-pause">
349
340
<title>To Pause a Movie or Song</title>
350
<para>To pause a movie or song that is playing, click on the
341
<para>To pause a movie or song that is playing, click on the <inlinemediaobject>
352
342
<imageobject><imagedata fileref="figures/totem_pause_button.png" format="PNG"/></imageobject>
353
343
<textobject><phrase>Shows pause button.</phrase></textobject>
354
</inlinemediaobject> button, or choose
356
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo></shortcut>
357
<guimenu>Movie</guimenu>
358
<guimenuitem>Play / Pause</guimenuitem>
359
</menuchoice>. You may also use the <keycap>P</keycap> key to pause or play a movie. When you pause a movie or song, the statusbar displays <guilabel>Paused</guilabel>
360
and the time elapsed on the current movie or song stops.
362
<para>To resume playing a movie or song, click on the
344
</inlinemediaobject> button, or choose <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo></shortcut><guimenu>Movie</guimenu><guimenuitem>Play / Pause</guimenuitem></menuchoice>. You may also use the <keycap>P</keycap> key to pause or play a movie.</para>
345
<para>To resume playing a movie or song, click on the <inlinemediaobject>
364
346
<imageobject><imagedata fileref="figures/totem_play_button.png" format="PNG"/></imageobject>
365
347
<textobject><phrase>Shows play button.</phrase></textobject>
366
</inlinemediaobject> button, or choose
368
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo></shortcut>
369
<guimenu>Movie</guimenu>
370
<guimenuitem>Play / Pause</guimenuitem>
348
</inlinemediaobject> button again, or choose <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo></shortcut><guimenu>Movie</guimenu><guimenuitem>Play / Pause</guimenuitem></menuchoice>.</para>
375
351
<sect2 id="totem-usage-view-properties">
376
352
<title>To View Properties of a Movie or Song</title>
377
<para>To view properties of a movie or song, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> to make the sidebar appear, and choose <guimenu>Properties</guimenu> in the drop-down list.</para>
378
<para>The dialogue contains the following information: <variablelist>
382
<para>Title, artist, album, year and duration of the movie or song, as well as any embedded comment the movie or song has.</para>
388
<para>Video dimensions, codec, framerate and bitrate.</para>
394
<para>Audio codec, channels, sample rate and bitrate.</para>
397
</variablelist></para>
353
<para>To view the properties of a movie or song, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> to make the sidebar appear, and choose <guimenu>Properties</guimenu> in the drop-down list at the top of the sidebar.</para>
400
356
<sect2 id="totem-usage-seek">
405
361
<term>To skip forward</term>
407
<para>To skip forward a movie or song, choose <menuchoice><shortcut><keycap>Right</keycap></shortcut><guimenu>Go</guimenu><guimenuitem>Skip Forward</guimenuitem></menuchoice>.</para>
363
<para>To skip forward through a movie or song, choose <menuchoice><shortcut><keycap>Right</keycap></shortcut><guimenu>Go</guimenu><guimenuitem>Skip Forward</guimenuitem></menuchoice>.</para>
411
367
<term>To skip backward</term>
413
<para>To skip backward a movie or song, choose <menuchoice><shortcut><keycap>Left</keycap></shortcut><guimenu>Go</guimenu><guimenuitem>Skip Backward</guimenuitem></menuchoice>.</para>
369
<para>To skip backwards through a movie or song, choose <menuchoice><shortcut><keycap>Left</keycap></shortcut><guimenu>Go</guimenu><guimenuitem>Skip Backwards</guimenuitem></menuchoice>.</para>
417
373
<term>To skip to a time</term>
419
<para>To skip to a specific elapsed time in the movie or song, choose
421
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>K</keycap></keycombo></shortcut>
422
<guimenu>Go</guimenu>
423
<guimenuitem>Skip to</guimenuitem>
424
</menuchoice>. The <guilabel>Skip to</guilabel> dialog is displayed. Use the
425
spin box to specify the elapsed time (in seconds) to skip to, then
426
click <guibutton>OK</guibutton>.
375
<para>To skip to a specific elapsed time in the movie or song, choose <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>K</keycap></keycombo></shortcut><guimenu>Go</guimenu><guimenuitem>Skip to</guimenuitem></menuchoice>. The <application>Skip to</application> dialogue is displayed. Use the spin box to specify the elapsed time (in seconds) to skip to, then click <guibutton>OK</guibutton>.</para>
376
<para>The spin box also allows more natural language to be used. You can enter a time in the formats "hh:mm:ss", "mm:ss" or "ss"; where "hh" is the hour, "mm" is the minute and "ss" is the second to skip to.</para>
431
380
<term>To move to the next movie or song</term>
433
<para>To move to the next movie or song, choose
435
<shortcut><keycombo><keycap>Alt</keycap><keycap>Right</keycap></keycombo></shortcut>
436
<guimenu>Go</guimenu>
437
<guimenuitem>Next Chapter/Movie</guimenuitem>
438
</menuchoice> or click on the
382
<para>To move to the next movie or song, choose <menuchoice><shortcut><keycombo><keycap>Alt</keycap><keycap>Right</keycap></keycombo></shortcut><guimenu>Go</guimenu><guimenuitem>Next Chapter/Movie</guimenuitem></menuchoice> or click on the <inlinemediaobject>
440
383
<imageobject><imagedata fileref="figures/totem_next_button.png" format="PNG"/></imageobject>
441
384
<textobject><phrase>Shows a seek next button</phrase></textobject>
442
</inlinemediaobject> button.
385
</inlinemediaobject> button.</para>
447
389
<term>To move to the previous movie or song</term>
449
<para>To move to the previous movie or song, choose
451
<shortcut><keycombo><keycap>Alt</keycap><keycap>Left</keycap></keycombo></shortcut>
452
<guimenu>Go</guimenu>
453
<guimenuitem>Previous Chapter/Movie</guimenuitem>
454
</menuchoice>, or click on the
391
<para>To move to the previous movie or song, choose <menuchoice><shortcut><keycombo><keycap>Alt</keycap><keycap>Left</keycap></keycombo></shortcut><guimenu>Go</guimenu><guimenuitem>Previous Chapter/Movie</guimenuitem></menuchoice> or click on the <inlinemediaobject>
456
392
<imageobject><imagedata fileref="figures/totem_previous_button.png" format="PNG"/></imageobject>
457
393
<textobject><phrase>Shows a seek previous button</phrase></textobject>
458
</inlinemediaobject> button.
394
</inlinemediaobject> button.</para>
466
401
<title>To Change the Zoom Factor</title>
467
402
<sect3 id="totem-usage-change-size">
468
403
<title>To Change the Video Size</title>
469
<para>To change the zoom factor of the display area, you can use the
404
<para>To change the zoom factor of the display area, you can use the following methods:</para>
474
<para>To zoom to fullscreen mode, choose
475
<menuchoice><shortcut><keycap>F11</keycap></shortcut>
476
<guimenu>View</guimenu><guimenuitem>Fullscreen</guimenuitem></menuchoice>. You can also
477
use the <keycap>F</keycap> key to toggle fullscreen mode.
478
To exit fullscreen mode, click on the
479
<guibutton>Leave Fullscreen</guibutton> button or press
480
<keycap>Esc</keycap>, <keycap>F11</keycap> or <keycap>F</keycap>.
484
<para>To zoom to half the size (50%) of the original movie or visualisation,
487
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>0</keycap></keycombo></shortcut>
488
<guimenu>View</guimenu><guisubmenu>Fit Window to Movie</guisubmenu>
489
<guimenuitem>Resize 1:2</guimenuitem>
494
<para>To zoom to the size (100%) of the original movie or visualisation,
497
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>1</keycap></keycombo></shortcut>
498
<guimenu>View</guimenu><guisubmenu>Fit Window to Movie</guisubmenu>
499
<guimenuitem>Resize 1:1</guimenuitem>
504
<para>To zoom to double the size (200%) of the original movie or visualisation,
507
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>2</keycap></keycombo></shortcut>
508
<guimenu>View</guimenu><guisubmenu>Fit Window to Movie</guisubmenu>
509
<guimenuitem>Resize 2:1</guimenuitem>
407
<para>To zoom to fullscreen mode, choose <menuchoice><shortcut><keycap>F11</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Fullscreen</guimenuitem></menuchoice>. You can also use the <keycap>F</keycap> key to toggle fullscreen mode. To exit fullscreen mode, click on the <guibutton>Leave Fullscreen</guibutton> button or press <keycap>Esc</keycap>, <keycap>F11</keycap> or <keycap>F</keycap>.</para>
410
<para>To change the size of the original movie or visualisation, choose <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>0</keycap></keycombo></shortcut><guimenu>View</guimenu><guimenuitem>Fit Window to Movie</guimenuitem></menuchoice> and choose a scale ratio.</para>
515
414
<sect3 id="totem-usage-change-ratio">
516
415
<title>To Change the Video Aspect Ratio</title>
517
<para>To switch between different aspect ratios, choose <menuchoice><shortcut><keycap>A</keycap></shortcut><guimenu>View</guimenu><guisubmenu>Aspect Ratio</guisubmenu></menuchoice>. The supported aspect ratios available are: <itemizedlist>
518
<listitem><para>Auto</para></listitem>
519
<listitem><para>Square</para></listitem>
520
<listitem><para>4:3 (TV)</para></listitem>
521
<listitem><para>16:9 (Widescreen)</para></listitem>
522
<listitem><para>2.11:1 (DVB)</para></listitem>
523
</itemizedlist><note>
524
<para>The default aspect ratio is Auto.</para>
416
<para>To switch between different aspect ratios, choose <menuchoice><shortcut><keycap>A</keycap></shortcut><guimenu>View</guimenu><guisubmenu>Aspect Ratio</guisubmenu></menuchoice>.</para>
529
420
<sect2 id="totem-usage-adjust-volume">
530
421
<title>To Adjust the Volume</title>
531
<para>To increase the volume, choose <menuchoice><shortcut><keycap>Up</keycap></shortcut><guimenu>Sound</guimenu><guimenuitem>Volume Up</guimenuitem></menuchoice> or move the volume slider to the right. To decrease the volume, choose <menuchoice><shortcut><keycap>Down</keycap></shortcut><guimenu>Sound</guimenu><guimenuitem>Volume Down</guimenuitem></menuchoice> or move the volume slider to the left.</para>
532
<para>To adjust the sound volume, you can also use the volume button. Press the volume button and choose the volume level with the slider.</para>
422
<para>To increase the volume, choose <menuchoice><shortcut><keycap>Up</keycap></shortcut><guimenu>Sound</guimenu><guimenuitem>Volume Up</guimenuitem></menuchoice>. To decrease the volume, choose <menuchoice><shortcut><keycap>Down</keycap></shortcut><guimenu>Sound</guimenu><guimenuitem>Volume Down</guimenuitem></menuchoice>.</para>
423
<para>You can also use the volume button: click on the volume button and choose the volume level with the slider.</para>
535
426
<sect2 id="totem-usage-on-top">
536
<title>To Make the Window Always On Top</title>
537
<para>To make the <application>Totem Movie Player</application> window always on top of other application windows,
540
<guimenu>Edit</guimenu>
541
<guimenuitem>Plugins</guimenuitem>
542
</menuchoice>. Select the <guilabel>Always on Top</guilabel> plugin to enable it. The Totem Movie Player window will now stay on
543
top of all other windows while a movie is playing, but not while audio or visualisations are playing.
545
<para>To stop the window always being on top, disable the <guilabel>Always on Top</guilabel> plugin again.</para>
427
<title>To Make the Window Always on Top</title>
428
<para>To make the <application>Totem Movie Player</application> window always on top of other application windows, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Plugins</guimenuitem></menuchoice>. Select the <guilabel>Always on Top</guilabel> plugin to enable it. The <application>Totem Movie Player</application> window will now stay on top of all other windows while a movie is playing, but not while audio or visualisations are playing.</para>
429
<para>To stop the window from always being on top, disable the <guilabel>Always on Top</guilabel> plugin again. See <xref linkend="totem-plugins-always-on-top"/> for more information.</para>
548
432
<sect2 id="totem-usage-show-control">
549
433
<title>To Show or Hide Controls</title>
550
<para>To show or hide the <application>Totem Movie Player</application> window controls, choose
552
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>H</keycap></keycombo></shortcut>
553
<guimenu>View</guimenu>
554
<guimenuitem>Show Controls</guimenuitem>
555
</menuchoice>, or press the <keycap>H</keycap> key.
556
You can also right-click on the <application>Totem Movie Player</application> window, then choose
558
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>H</keycap></keycombo></shortcut>
559
<guimenuitem>Show Controls</guimenuitem>
560
</menuchoice> from the popup menu.
562
<para>If the <guilabel>Show Controls</guilabel> option is selected,
563
<application>Totem Movie Player</application> will show the menubar, time elapsed slider,
564
seek control buttons, volume slider and statusbar on the window. If
565
the <guilabel>Show Controls</guilabel> option is unselected, the application
566
will hide these controls and show only the display area.
434
<para>To show or hide the <application>Totem Movie Player</application> window controls, choose <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>H</keycap></keycombo></shortcut><guimenu>View</guimenu><guimenuitem>Show Controls</guimenuitem></menuchoice>, or press the <keycap>H</keycap> key. You can also right-click on the <application>Totem Movie Player</application> window, then choose <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>H</keycap></keycombo></shortcut><guimenuitem>Show Controls</guimenuitem></menuchoice> from the popup menu.</para>
435
<para>If the <guilabel>Show Controls</guilabel> option is selected, <application>Totem Movie Player</application> will show the menubar, elapsed time slider, seek control buttons, volume slider and statusbar on the window. If the <guilabel>Show Controls</guilabel> option is unselected, the application will hide these controls and show only the display area.</para>
570
438
<sect2 id="totem-usage-playlist">
571
439
<title>To Manage the Playlist</title>
575
<para><xref linkend="totem-usage-playlist-show-hide"/></para>
578
<para><xref linkend="totem-usage-playlist-manage"/></para>
581
<para><xref linkend="totem-usage-playlist-repeat"/></para>
584
<para><xref linkend="totem-usage-playlist-shuffle"/></para>
589
441
<sect3 id="totem-usage-playlist-show-hide">
590
442
<title>To Show or Hide the Playlist</title>
591
<para>To show the playlist, choose
593
<guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem>
594
</menuchoice>, or click the <guilabel>Sidebar</guilabel> button, and
595
choose <guimenu>Playlist</guimenu> on the top of
596
the sidebar. The <guilabel>Playlist</guilabel> dialog is displayed.</para>
597
<para>To hide Playlist, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the <guilabel>Sidebar</guilabel> button again.</para>
443
<para>To show or hide the playlist, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the <guibutton>Sidebar</guibutton> button, and choose <guimenu>Playlist</guimenu> on the top of the sidebar.</para>
600
446
<sect3 id="totem-usage-playlist-manage">
601
447
<title>Manage a Playlist</title>
602
<para>You can use the <guilabel>Playlist</guilabel> dialogue to do the following: <variablelist>
448
<para>You can use the <application>Playlist</application> dialogue to do the following: <variablelist>
604
450
<term>To add a track or movie</term>
606
<para>To add a track or movie to the playlist, click on the <guibutton>Add</guibutton>
607
button. The <guilabel>Select Movies or Playlists</guilabel> dialog is displayed. Select the file that you
608
want to add to the playlist, then click <guibutton>Add</guibutton>.
452
<para>To add a track or movie to the playlist, click on the <guibutton>Add</guibutton> button. The <application>Select Movies or Playlists</application> dialogue is displayed. Select the file that you want to add to the playlist, then click <guibutton>Add</guibutton>.</para>
613
456
<term>To remove a track or movie</term>
615
<para>To remove a track or movie from the playlist, select the items to remove from the
616
<guilabel>filename</guilabel> list box, then click on the <guibutton>Remove</guibutton> button.
458
<para>To remove a track or movie from the playlist, select the item or items to remove from the playlist, then click on the <guibutton>Remove</guibutton> button.</para>
621
462
<term>To save the playlist to a file</term>
623
<para>To save the playlist to a file, click on the <guibutton>Save Playlist</guibutton>
624
button. The <guilabel>Save Playlist</guilabel> dialog is displayed; specify
625
the filename as which you want to save the playlist, and click <guibutton>Save</guibutton>.
464
<para>To save the playlist to a file, click on the <guibutton>Save Playlist</guibutton> button. The <application>Save Playlist</application> dialogue is displayed; specify the filename as which you want to save the playlist, and click <guibutton>Save</guibutton>.</para>
630
468
<term>To move a track or movie up the playlist</term>
632
<para>To move a track or movie up the playlist, select the item from the
633
<guilabel>filename</guilabel> list box, then click on the <guibutton>Move Up</guibutton> button.
470
<para>To move a track or movie up the playlist, select the item from the playlist, then click on the <guibutton>Move Up</guibutton> button.</para>
638
474
<term>To move a track or movie down the playlist</term>
640
<para>To move a track or movie down the playlist, select the item from the
641
<guilabel>filename</guilabel> list box, then click on the <guibutton>Move Down</guibutton> button.
476
<para>To move a track or movie down the playlist, select the item from the playlist, then click on the <guibutton>Move Down</guibutton> button.</para>
645
479
</variablelist></para>
657
491
<sect2 id="totem-usage-subtitle">
658
492
<title>To Choose Subtitles</title>
660
the language of the subtitles, select
661
<menuchoice><guimenu>View</guimenu><guisubmenu>Subtitles</guisubmenu></menuchoice>
662
and choose the subtitle language you want to display.</para>
493
<para>To choose the language of the subtitles, select <menuchoice><guimenu>View</guimenu><guisubmenu>Subtitles</guisubmenu></menuchoice> and choose the subtitle language you want to display.</para>
663
494
<para>To disable the display of subtitles, select <menuchoice><guimenu>View</guimenu><guisubmenu>Subtitles</guisubmenu><guimenuitem>None</guimenuitem></menuchoice>.</para>
664
<note><para>By default, Totem Movie Player will choose the same language for the
665
subtitles as the one you normally use on your computer.</para></note>
666
<tip><para>Totem Movie Player will automatically load and display subtitles if the file which contains them has the same
667
name as the video file played and the extension <filename>asc</filename>, <filename>txt</filename>,
668
<filename>sub</filename>, <filename>smi</filename>, or <filename>ssa</filename>.
495
<note><para>By default, <application>Totem Movie Player</application> will choose the same language for the subtitles as the one you normally use on your computer.</para></note>
496
<para><application>Totem Movie Player</application> will automatically load and display subtitles for a video if it finds a subtitle file with the same name as the video being played, and the extension <filename>asc</filename>, <filename>txt</filename>, <filename>sub</filename>, <filename>srt</filename>, <filename>smi</filename>, <filename>ssa</filename> or <filename>ass</filename>.</para>
497
<para>If the file containing the subtitles has a different name from the video being played, you can right-click on the video in the playlist and choose <menuchoice><guimenuitem>Select Text Subtitles</guimenuitem></menuchoice> from the popup menu to load the correct subtitle file. You may also choose subtitles by choosing <menuchoice><guimenu>View</guimenu><guimenuitem>Select Text Subtitles</guimenuitem></menuchoice>.</para>
498
<para>Using the <guilabel>Subtitles downloader</guilabel> plugin, you can also download subtitles from the OpenSubtitles service. See <xref linkend="totem-plugins-opensubtitles"/> for more information.</para>
672
501
<sect2 id="totem-usage-take-screenshot">
673
502
<title>To Take a Screenshot</title>
674
<para>To take a screenshot of the movie or visualisation that is playing, choose
676
<guimenu>Edit</guimenu>
677
<guimenuitem>Take Screenshot</guimenuitem>
678
</menuchoice>. The <guilabel>Save Screenshot</guilabel> dialog is displayed. Choose a location and
679
insert the filename as which you want to save the screenshot, then click the <guibutton>Save</guibutton> button
680
to save the screenshot.
682
<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>
503
<para>To take a screenshot of the movie or visualisation that is playing, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Take Screenshot</guimenuitem></menuchoice>. The <application>Save Screenshot</application> dialogue is displayed. Choose a location and insert the filename as which you want to save the screenshot, then click on the <guibutton>Save</guibutton> button to save the screenshot.</para>
504
<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> dialogue.</para></tip>
507
<sect2 id="totem-usage-create-screenshot-gallery">
508
<title>To Create a Screenshot Gallery</title>
509
<para>To create a gallery of screenshots of the movie or visualisation that is playing, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Create Screenshot Gallery</guimenuitem></menuchoice>. The <application>Save Gallery</application> dialogue is displayed. Choose a location and insert the filename as which you want to save the gallery image, then click on the <guibutton>Save</guibutton> button to save the screenshot.</para>
510
<tip><para>You may specify the width of the individual screenshots in the gallery using the <guilabel>Screenshot width</guilabel> entry. The default width is 128 pixels.</para>
511
<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; however, this may be overridden by deselecting the <guilabel>Calculate the number of screenshots</guilabel> checkbox and entering the new number in the <guilabel>Number of screenshots</guilabel> spin box.</para></tip>
515
<!-- =========== Plugins ======================================= -->
516
<sect1 id="totem-plugins">
517
<title>Plugins</title>
518
<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 if necessary.</para>
519
<sect2 id="totem-plugins-load">
520
<title>To Enable a Plugin</title>
521
<para>To view the list of installed plugins, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Plugins</guimenuitem></menuchoice>. The <application>Configure Plugins</application> dialogue is displayed. On the left is a list of all the plugins you have installed, while on the right is a description of the currently selected plugin. Plugins which have options which can be changed will have a sensitive <guibutton>Configure</guibutton> button on the right.</para>
522
<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 there is any error loading the plugin, an error dialogue will also be displayed immediately.</para>
523
<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 closed.</para>
525
<sect2 id="totem-plugins-always-on-top">
526
<title>Always on Top</title>
527
<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 all other windows while a movie is playing, but not while audio or visualisations are playing. To stop the window being on top, disable the plugin again.</para>
529
<sect2 id="totem-plugins-coherence">
530
<title>Coherence DLNA/UPnP Client</title>
531
<para>The <guilabel>Coherence DLNA/UPnP Client</guilabel> plugin allows <application>Totem Movie Player</application> to play multimedia content from UPnP media servers (such as Coherence servers) on the local network.</para>
532
<para>With the <guilabel>Coherence DLNA/UPnP Client</guilabel> plugin enabled, choose <menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the <guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Coherence DLNA/UPnP Client</guilabel> from the drop-down list at the top of the sidebar to display the <guilabel>Coherence DLNA/UPnP Client</guilabel> sidebar.</para>
533
<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, 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 <application>Totem Movie Player</application>'s playlist and play it. You may alternatively right-click on a file and choose <menuchoice><guimenuitem>Play</guimenuitem></menuchoice> or <menuchoice><guimenuitem>Enqueue</guimenuitem></menuchoice> to play the file immediately or add it to the playlist, respectively.</para>
534
<para>If the media server allows it, choosing <menuchoice><guimenuitem>Delete</guimenuitem></menuchoice> from a file's context menu allows you to delete that file from the media server.</para>
536
<sect2 id="totem-plugins-gromit">
537
<title>Gromit Annotations</title>
538
<para>The <guilabel>Gromit Annotations</guilabel> plugin allows you to draw on top of movies as they are played using <ulink type="http" url="http://www.home.unix-ag.org/simon/gromit/"><application>Gromit</application></ulink>. You must have <application>Gromit</application> installed before you can enable the plugin — consult your operating system documentation for information on how to do this.</para>
539
<para>With the plugin enabled, press <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo> to toggle <application>Gromit</application> on or off. When <application>Gromit</application> is enabled, your pointer will change to a crosshair. To draw on the screen, hold down your mouse button and drag your pointer around, before releasing your mouse button. Press <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo> again to toggle <application>Gromit</application> off.</para>
540
<para>To clear the screen of annotations, press <keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>, or close <application>Totem Movie Player</application>.</para>
542
<sect2 id="totem-plugins-jamendo">
543
<title>Jamendo</title>
544
<para>The <guilabel>Jamendo</guilabel> plugin allows you to listen to the collection of Creative Commons-licenced music on the <ulink type="http" url="http://www.jamendo.com/en/">Jamendo</ulink> service.</para>
545
<sect3 id="totem-plugins-jamendo-configuration">
546
<title>To Configure the Plugin</title>
547
<para>The <guilabel>Jamendo</guilabel> plugin can be configured. Click on the <guibutton>Configure</guibutton> button when enabling the plugin, and the <application>Jamendo Plugin Configuration</application> dialogue will be displayed. Here, you can choose whether to download songs in Ogg or 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 you have a faster Internet connection).</para>
548
<para>Once you're done, click <guibutton>OK</guibutton>.</para>
550
<sect3 id="totem-plugins-jamendo-setup">
551
<title>To Display the Jamendo Sidebar</title>
552
<para>With the <guilabel>Jamendo</guilabel> plugin enabled, choose <menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the <guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Jamendo</guilabel> from the drop-down list at the top of the sidebar to display the <guilabel>Jamendo</guilabel> sidebar.</para>
554
<sect3 id="totem-plugins-jamendo-search">
555
<title>To Search for Music</title>
556
<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 by tags. Click on the search button to start your search.</para>
557
<para>Search results will be displayed in the tree view in the <guilabel>Search Results</guilabel> page of the sidebar, and can be browsed 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 below it. Click again to hide the album's tracks.</para>
558
<para>With an artist selected, you can click on the <guibutton>Jamendo Album Page</guibutton> button to open that album's page on the Jamendo website. Double-clicking an album, or choosing <menuchoice><guimenuitem>Add to Playlist</guimenuitem></menuchoice> from the album's context menu, will replace your playlist with all the tracks on that album and begin streaming the first track from Jamendo's website. Double-clicking an individual track will replace your playlist with just that track.</para>
560
<sect3 id="totem-plugins-jamendo-popular">
561
<title>Popular Albums and Latest Releases</title>
562
<para>Viewing the <guilabel>Popular</guilabel> page in the <guilabel>Jamendo</guilabel> sidebar will load a list of the most popular albums on Jamendo at the moment, which can be played as with search results. Viewing the <guilabel>Latest Releases</guilabel> page will likewise load a list of the latest albums released on Jamendo.</para>
565
<sect2 id="totem-plugins-tracker">
566
<title>Local Search</title>
567
<para>The <guilabel>Local Search</guilabel> plugin allows you to search for playable movies and audio files on your computer from within <application>Totem Movie Player</application>. With the plugin enabled, choose <menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the <guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Local Search</guilabel> from the drop-down list at the top of the sidebar to display the <guilabel>Local Search</guilabel> sidebar.</para>
568
<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 search terms may include wildcards such as <literal>*</literal>, which will match any character. For example, the search <userinput>*.mpg</userinput> will find all movies with the <filename class="extension">.mpg</filename> file extension.</para>
569
<para>Search results may be browsed using the <guibutton>Back</guibutton> and <guibutton>Forward</guibutton> buttons at the bottom of the sidebar, and you may jump to a specific results page by entering its number in the spin box.</para>
571
<sect2 id="totem-plugins-publish">
572
<title>Publish Playlist</title>
573
<para>The <guilabel>Publish Playlist</guilabel> plugin allows you to publish playlists on your local network to allow other computers to access and play them.</para>
574
<sect3 id="totem-plugins-publish-configuration">
575
<title>To Configure the Plugin</title>
576
<para>The <guilabel>Publish Playlist</guilabel> plugin can be configured. Click on the <guibutton>Configure</guibutton> button when enabling the plugin, and the configuration dialogue will be displayed. Here, you can change the name which will appear for your playlist share. The following strings will be replaced when playlists are published: <variablelist>
578
<term><literal>%a</literal></term>
579
<listitem><para>Replaced with the program's name: <application>Totem Movie Player</application>.</para></listitem>
582
<term><literal>%h</literal></term>
583
<listitem><para>Replaced with your computer's host name.</para></listitem>
586
<term><literal>%u</literal></term>
587
<listitem><para>Replaced with your username.</para></listitem>
590
<term><literal>%U</literal></term>
591
<listitem><para>Replaced with your real name.</para></listitem>
594
<term><literal>%%</literal></term>
595
<listitem><para>Replaced with a literal percent sign.</para></listitem>
597
</variablelist></para>
598
<para>You can also select the <guilabel>Use encrypted transport protocol</guilabel> checkbox if you wish to encrypt the shared playlists when they're transmitted over the network.</para>
599
<para>Once you're done, click <guibutton>Close</guibutton>.</para>
601
<sect3 id="totem-plugins-publish-publishing">
602
<title>To Publish Playlists</title>
603
<para>With the plugin enabled, you do not need to explicitly publish playlists; they are automatically made available on the network as a Zeroconf website.</para>
605
<sect3 id="totem-plugins-publish-neighborhood">
606
<title>To Browse your Neighborhood</title>
607
<para>To view the shared playlists of others on your network, select <guilabel>Neighbourhood</guilabel> from the drop-down list at the top of the 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 your computer.</para>
610
<sect2 id="totem-plugins-opensubtitles">
611
<title>Subtitles downloader</title>
612
<para>The <guilabel>Subtitles downloader</guilabel> plugin allows you to find and download subtitle files from the <ulink type="http" url="http://www.opensubtitles.org/en">OpenSubtitles</ulink> service.</para>
613
<para>Subtitles can only be downloaded for local movies; not audio files, DVDs, DVB streams, VCDs or HTTP streams. To search for subtitles for the currently playing movie, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Download Movie Subtitles</guimenuitem></menuchoice>, which will display the <application>Download Movie Subtitles</application> dialogue.</para>
614
<para>Select the language in which you wish to have your subtitles from the drop-down list at the top of the dialogue, then click on the <guibutton>Find</guibutton> button to search for subtitles for the current movie. Subtitles are found on the basis of the movie's content, rather than its filename or tags.</para>
615
<para>Search results are listed in the tree view in the middle of the dialogue. Currently, subtitles can only be used with a movie by <emphasis>reloading</emphasis> the movie with the subtitles, so after selecting the subtitle file you wish to download, click on the <guibutton>Play with Subtitle</guibutton> button to download the subtitles and reload the movie.</para>
616
<note><para>Downloaded subtitle files are cached so that they do not need to be downloaded again when playing the movie again. When downloading new subtitles for a movie, any previously downloaded subtitles for that movie are deleted.</para></note>
618
<sect2 id="totem-plugins-thumbnail">
619
<title>Thumbnail</title>
620
<para>The <guilabel>Thumbnail</guilabel> plugin sets <application>Totem Movie Player</application>'s main window icon to a thumbnail of the current movie, and updates the icon when new movies are loaded.</para>
621
<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 <application>Totem Movie Player</application> logo.</para></note>
623
<sect2 id="totem-plugins-brasero">
624
<title>Video Disc Recorder</title>
625
<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>
626
<para>To burn the current playlist, choose <menuchoice><guimenu>Movie</guimenu><guimenuitem>Create Video Disc</guimenuitem></menuchoice>. A <application>Brasero</application> dialogue will be displayed, giving options for converting the movies to the appropriate format and burning them to disc. For more information, see the <ulink type="help" url="ghelp:brasero?brasero-new-project-video">Brasero documentation</ulink>.</para>
628
<sect2 id="totem-plugins-youtube">
629
<title>YouTube browser</title>
630
<para>The <guilabel>YouTube browser</guilabel> plugin allows you to search and browse <ulink type="http" url="http://www.youtube.com/">YouTube</ulink>, and play YouTube videos directly in <application>Totem Movie Player</application>. With the plugin enabled, choose <menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the <guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>YouTube</guilabel> from the drop-down list at the top of the sidebar to display the <guilabel>YouTube</guilabel> sidebar.</para>
631
<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>. The search results will be listed in the tree view below. More results will be loaded automatically as you scroll down the list.</para>
632
<para>To play a video, double-click it in the results list, or choose <menuchoice><guimenuitem>Add to Playlist</guimenuitem></menuchoice> from its context menu. When a video is played, a list of related videos will automatically be loaded in the <guilabel>Related Videos</guilabel> page of the <guilabel>YouTube</guilabel> sidebar.</para>
633
<para>YouTube videos can be opened in a web browser by choosing <menuchoice><guimenuitem>Open in Web Browser</guimenuitem></menuchoice> from their context menu. This will open the video in its original location on the YouTube website.</para>
687
637
<!-- =========== Usage ======================================= -->