Totem.Object¶

Subclasses:: None

Methods¶

Inherited:: Gtk.Application (21), Gio.Application (37), GObject.Object (37), Gio.ActionGroup (14), Gio.ActionMap (5)
Structs:: GObject.ObjectClass (5)

class	`get_supported_content_types` ()
class	`get_supported_uri_schemes` ()
	`add_to_playlist` (uri, display_name, play)
	`add_to_view` (file, title)
	`can_seek_next` ()
	`can_seek_previous` ()
	`clear_playlist` ()
	`empty_menu_section` (id)
	`exit` ()
	`get_current_mrl` ()
	`get_current_time` ()
	`get_main_window` ()
	`get_menu_section` (id)
	`get_playlist_length` ()
	`get_playlist_pos` ()
	`get_rate` ()
	`get_short_title` ()
	`get_title_at_playlist_pos` (playlist_index)
	`get_video_widget` ()
	`get_volume` ()
	`is_fullscreen` ()
	`is_paused` ()
	`is_playing` ()
	`is_seekable` ()
	`next_angle` ()
	`pause` ()
	`play` ()
	`play_pause` ()
	`remote_command` (cmd, url)
	`remote_get_setting` (setting)
	`remote_set_setting` (setting, value)
	`seek_next` ()
	`seek_previous` ()
	`seek_relative` (offset, accurate)
	`seek_time` (msec, accurate)
	`set_current_subtitle` (subtitle_uri)
	`set_rate` (rate)
	`set_volume` (volume)
	`show_error` (title, reason)
	`stop` ()

Virtual Methods¶

Inherited:: Gtk.Application (2), Gio.Application (15), GObject.Object (7), Gio.ActionGroup (14), Gio.ActionMap (3)

Properties¶

Inherited:: Gtk.Application (5), Gio.Application (8)

Name	Type	Flags	Short Description
`current-content-type`	`str`	r	Current stream’s content-type.
`current-display-name`	`str`	r	Current stream’s display name.
`current-mrl`	`str`	r	The MRL of the current stream.
`current-time`	`int`	r	The player’s position (time) in the current stream.
`fullscreen`	`bool`	r	Whether Totem is in fullscreen mode.
`main-page`	`str`	r	Current main page.
`playing`	`bool`	r	Whether Totem is currently playing a file.
`seekable`	`bool`	r	Whether the current stream is seekable.
`stream-length`	`int`	r	The length of the current stream.

Signals¶

Inherited:: Gtk.Application (3), Gio.Application (7), GObject.Object (1), Gio.ActionGroup (4)

Name	Short Description
`file-closed`	The `Totem.Object` `::file-closed` signal is emitted when Totem closes a stream.
`file-has-played`	The `Totem.Object` `::file-has-played` signal is emitted when a new stream has started playing in Totem.
`file-opened`	The `Totem.Object` `::file-opened` signal is emitted when a new stream is opened by Totem.
`get-text-subtitle`	The `Totem.Object` `::get-text-subtitle` signal is emitted before opening a stream, so that plugins have the opportunity to detect or download text subtitles for the stream if necessary.
`get-user-agent`	The `Totem.Object` `::get-user-agent` signal is emitted before opening a stream, so that plugins have the opportunity to return the user-agent to be set.
`metadata-updated`	The `Totem.Object` `::metadata-updated` signal is emitted when the metadata of a stream is updated, typically when it’s being loaded.

Fields¶

Inherited:: Gtk.Application (3), Gio.Application (7), GObject.Object (1), Gio.ActionGroup (4)

Class Details¶

class Totem.Object(**kwargs)¶

Bases:: Gtk.Application
Abstract:: No
Structure:: Totem.ObjectClass

All the fields in the Totem.Object structure are private and should never be accessed directly.

classmethod get_supported_content_types()¶

Returns:: a None-terminated array of the content types Totem supports
Return type:: [str]

Get the full list of file content types which Totem supports playing.

New in version 3.1.5.

classmethod get_supported_uri_schemes()¶

Returns:: a None-terminated array of the URI schemes Totem supports
Return type:: [str]

Get the full list of URI schemes which Totem supports accessing.

New in version 3.1.5.

add_to_playlist(uri, display_name, play)¶

Parameters:

uri (str) – the URI to add to the playlist
display_name (str or None) – the display name of the URI
play (bool) – whether to play the added item

Add uri to the playlist and play it immediately.

add_to_view(file, title)¶

Parameters:

file (Gio.File) – a Gio.File representing a media
title (str) – a title for the media, or None

Adds a local media file to the main view.

can_seek_next()¶

Return type:: bool

Returns true if Totem.Object.seek_next() would have an effect.

can_seek_previous()¶

Return type:: bool

Returns true if Totem.Object.seek_previous() would have an effect.

clear_playlist()¶: Empties the current playlist.

empty_menu_section(id)¶

Parameters:: id (str) – the ID for the menu section to empty

Empty the Gio.Menu section pointed to by id, and remove any related actions. Note that menu items with specific target will not have the associated action removed.

exit()¶: Closes Totem.

get_current_mrl()¶

Returns:: a newly-allocated string containing the MRL of the current stream
Return type:: str

Get the MRL of the current stream, or None if nothing’s playing. Free with GLib.free().

get_current_time()¶

Returns:: the current position in the stream
Return type:: int

Gets the current position’s time in the stream as a gint64.

get_main_window()¶

Returns:: Totem’s main window
Return type:: Gtk.Window

Gets Totem’s main window and increments its reference count.

get_menu_section(id)¶

Parameters:: id (str) – the ID for the menu section to look up
Returns:: a Gio.Menu or None on failure
Return type:: Gio.Menu or None

Get the Gio.Menu of the given id from the main Totem Gtk.Builder file.

get_playlist_length()¶

Returns:: the playlist length
Return type:: int

Returns the length of the current playlist.

get_playlist_pos()¶

Returns:: the index of the current playlist entry, or -1
Return type:: int

Returns the 0-based index of the current entry in the playlist. If there is no current entry in the playlist, -1 is returned.

get_rate()¶

Returns:: the volume level
Return type:: float

Gets the current playback rate, with 1.0 being the normal playback rate.

get_short_title()¶

Returns:: the current entry’s title, or None; free with GLib.free()
Return type:: str

Gets the title of the current entry in the playlist.

get_title_at_playlist_pos(playlist_index)¶

Parameters:: playlist_index (int) – the 0-based entry index
Returns:: the entry title at index, or None; free with GLib.free()
Return type:: str

Gets the title of the playlist entry at index.

get_video_widget()¶

Returns:: Totem’s video widget
Return type:: Gtk.Widget

Gets Totem’s video widget and increments its reference count.

get_volume()¶

Returns:: the volume level
Return type:: float

Gets the current volume level, as a value between 0.0 and 1.0.

is_fullscreen()¶

Returns:: True if Totem is fullscreened
Return type:: bool

Returns True if Totem is fullscreened.

is_paused()¶

Returns:: True if playback is paused, False otherwise
Return type:: bool

Returns True if playback is paused.

is_playing()¶

Returns:: True if Totem is playing a stream
Return type:: bool

Returns True if Totem is playing a stream.

is_seekable()¶

Returns:: True if the current stream is seekable
Return type:: bool

Returns True if the current stream is seekable.

next_angle()¶: Switches to the next angle, if watching a DVD. If not watching a DVD, this is a no-op.

pause()¶: Pauses the current stream. If Totem is already paused, it continues to be paused.

play()¶: Plays the current stream. If Totem is already playing, it continues to play. If the stream cannot be played, and error dialog is displayed.

play_pause()¶: Gets the current MRL from the playlist and attempts to play it. If the stream is already playing, playback is paused.

remote_command(cmd, url)¶

Parameters:

cmd (Totem.RemoteCommand) – a Totem.RemoteCommand
url (str) – an MRL to play, or None

Executes the specified cmd on this instance of Totem. If cmd is an operation requiring an MRL, url is required; it can be None otherwise.

If Totem’s fullscreened and the operation is executed correctly, the controls will appear as if the user had moved the mouse.

remote_get_setting(setting)¶

Parameters:: setting (Totem.RemoteSetting) – a Totem.RemoteSetting
Returns:: True if the setting is enabled, False otherwise
Return type:: bool

Returns the value of setting for this instance of Totem.

remote_set_setting(setting, value)¶

Parameters:

setting (Totem.RemoteSetting) – a Totem.RemoteSetting
value (bool) – the new value for the setting

Sets setting to value on this instance of Totem.

seek_next()¶: If a DVD is being played, goes to the next chapter. If a normal stream is being played, plays the next entry in the playlist.

seek_previous()¶: If a DVD is being played, goes to the previous chapter. If a normal stream is being played, goes to the start of the stream if possible. If seeking is not possible, plays the previous entry in the playlist.

seek_relative(offset, accurate)¶

Parameters:

offset (int) – the time offset to seek to
accurate (bool) – whether to use accurate seek, an accurate seek might be slower for some formats (see GStreamer docs)

Seeks to an offset from the current position in the stream, or displays an error dialog if that’s not possible.

seek_time(msec, accurate)¶

Parameters:

msec (int) – the time to seek to
accurate (bool) – whether to use accurate seek, an accurate seek might be slower for some formats (see GStreamer docs)

Seeks to an absolute time in the stream, or displays an error dialog if that’s not possible.

set_current_subtitle(subtitle_uri)¶

Parameters:: subtitle_uri (str) – the URI of the subtitle file to add

Add the subtitle_uri subtitle file to the playlist, setting it as the subtitle for the current playlist entry.

set_rate(rate)¶

Parameters:: rate (float) – the new absolute playback rate
Returns:: True on success, False on failure.
Return type:: bool

Sets the playback rate, with 1.0 being the normal playback rate.

set_volume(volume)¶

Parameters:: volume (float) – the new absolute volume value

Sets the volume, with 1.0 being the maximum, and 0.0 being the minimum level.

show_error(title, reason)¶

Parameters:

title (str) – the error dialog title
reason (str) – the error dialog text

Displays a non-blocking error dialog with the given title and reason.

stop()¶: Stops playback, and sets the playlist back at the start.

Signal Details¶

Totem.Object.signals.file_closed(object)¶

Signal Name:: file-closed
Flags:: RUN_LAST
Parameters:: object (Totem.Object) – The object which received the signal

The Totem.Object ::file-closed signal is emitted when Totem closes a stream.

Totem.Object.signals.file_has_played(object, mrl)¶

Signal Name:

file-has-played

Flags:

RUN_LAST

Parameters:

object (Totem.Object) – The object which received the signal
mrl (str) – the MRL of the opened stream

The Totem.Object ::file-has-played signal is emitted when a new stream has started playing in Totem.

Totem.Object.signals.file_opened(object, mrl)¶

Signal Name:

file-opened

Flags:

RUN_LAST

Parameters:

object (Totem.Object) – The object which received the signal
mrl (str) – the MRL of the opened stream

The Totem.Object ::file-opened signal is emitted when a new stream is opened by Totem.

Totem.Object.signals.get_text_subtitle(object, mrl)¶

Signal Name:

get-text-subtitle

Flags:

RUN_LAST

Parameters:

object (Totem.Object) – The object which received the signal
mrl (str) – the MRL of the opened stream

Returns:

allocated string representing the URI of the subtitle to use for mrl

Return type:

str

The Totem.Object ::get-text-subtitle signal is emitted before opening a stream, so that plugins have the opportunity to detect or download text subtitles for the stream if necessary.

Totem.Object.signals.get_user_agent(object, mrl)¶

Signal Name:

get-user-agent

Flags:

RUN_LAST

Parameters:

object (Totem.Object) – The object which received the signal
mrl (str) – the MRL of the opened stream

Returns:

allocated string representing the user-agent to use for mrl

Return type:

str

The Totem.Object ::get-user-agent signal is emitted before opening a stream, so that plugins have the opportunity to return the user-agent to be set.

Totem.Object.signals.metadata_updated(object, artist, title, album, track_number)¶

Signal Name:

metadata-updated

Flags:

RUN_LAST

Parameters:

object (Totem.Object) – The object which received the signal
artist (str) – the name of the artist, or None
title (str) – the stream title, or None
album (str) – the name of the stream’s album, or None
track_number (int) – the stream’s track number

The Totem.Object ::metadata-updated signal is emitted when the metadata of a stream is updated, typically when it’s being loaded.

Property Details¶

Totem.Object.props.current_content_type¶

Name:: current-content-type
Type:: str
Default Value:: None
Flags:: READABLE

The content-type of the current stream.

Totem.Object.props.current_display_name¶

Name:: current-display-name
Type:: str
Default Value:: None
Flags:: READABLE

The display name of the current stream.

Totem.Object.props.current_mrl¶

Name:: current-mrl
Type:: str
Default Value:: None
Flags:: READABLE

The MRL of the current stream.

Totem.Object.props.current_time¶

Name:: current-time
Type:: int
Default Value:: 0
Flags:: READABLE

The player’s position (time) in the current stream, in milliseconds.

Totem.Object.props.fullscreen¶

Name:: fullscreen
Type:: bool
Default Value:: False
Flags:: READABLE

If True, Totem is in fullscreen mode.

Totem.Object.props.main_page¶

Name:: main-page
Type:: str
Default Value:: None
Flags:: READABLE

The name of the current main page (usually “grilo”, or “player”).

Totem.Object.props.playing¶

Name:: playing
Type:: bool
Default Value:: False
Flags:: READABLE

If True, Totem is playing an audio or video file.

Totem.Object.props.seekable¶

Name:: seekable
Type:: bool
Default Value:: False
Flags:: READABLE

If True, the current stream is seekable.

Totem.Object.props.stream_length¶

Name:: stream-length
Type:: int
Default Value:: 0
Flags:: READABLE

The length of the current stream, in milliseconds.