RB.PlaylistManager¶

Subclasses:	None

Methods¶

Inherited:	GObject.Object (37)
Structs:	GObject.ObjectClass (5)

class	`error_quark` ()
class	`new` (shell, playlists_file)
	`add_to_playlist` (name, uri)
	`create_static_playlist` (name)
	`delete_playlist` (name)
	`export_playlist` (name, uri, m3u_format)
	`get_playlist_names` ()
	`get_playlists` ()
	`load_playlists` ()
	`new_playlist` (suggested_name, automatic)
	`new_playlist_from_selection_data` (data)
	`parse_file` (uri)
	`remove_from_playlist` (name, uri)
	`save_playlist_file` (source)
	`save_playlists` (force)
	`shutdown` ()

Virtual Methods¶

Inherited:	GObject.Object (7)

	`do_load_finish` ()
	`do_load_start` ()
	`do_playlist_added` (source)
	`do_playlist_created` (source)

Properties¶

Name	Type	Flags	Short Description
`playlists-file`	`str`	r/w	playlists file
`shell`	`RB.Shell`	r/w	`RB.Shell` object
`source`	`RB.Source`	r/w	`RB.Source` object

Signals¶

Inherited:	GObject.Object (1)

Name	Short Description
`load-finish`	Emitted when the playlist manager finishes loading the user’s playlist file.
`load-start`	Emitted when the playlist manager starts loading the user’s playlist file.
`playlist-added`	Emitted when a playlist is added, including when being loaded from the user’s playlist file.
`playlist-created`	Emitted when a new playlist is created.

Fields¶

Inherited:	GObject.Object (1)

Name	Type	Access	Description
parent	`GObject.Object`	r

Class Details¶

class RB.PlaylistManager(**kwargs)¶

Bases:	`GObject.Object`
Abstract:	No
Structure:	`RB.PlaylistManagerClass`

classmethod error_quark()¶

Return type:	`int`

classmethod new(shell, playlists_file)¶

Parameters:	shell (`RB.Shell`) – the `RB.Shell` playlists_file (`str`) – the full path to the playlist file to load
Returns:	the `RB.PlaylistManager`
Return type:	`RB.PlaylistManager`

Creates the RB.PlaylistManager instance

add_to_playlist(name, uri)¶

Parameters:	name (`str`) – name of the playlist to add to uri (`str`) – URI of the entry to add to the playlist
Raises:	`GLib.Error`
Returns:	`True` if successful.
Return type:	`bool`

Adds an entry to the specified playlist. Fails if no playlist with that name exists. This is part of the playlist manager dbus interface.

create_static_playlist(name)¶

Parameters:	name (`str`) – name of the new playlist
Raises:	`GLib.Error`
Returns:	`True` if successful.
Return type:	`bool`

Creates a new static playlist source with the given name. Will fail if a playlist with that name already exists. This is part of the playlist manager dbus interface.

delete_playlist(name)¶

Parameters:	name (`str`) – name of the playlist to delete
Raises:	`GLib.Error`
Returns:	`True` if successful.
Return type:	`bool`

Deletes the specified playlist. Will fail if no playlist with that name exists. This is part of the playlist manager dbus interface.

export_playlist(name, uri, m3u_format)¶

Parameters:	name (`str`) – name of the playlist to export uri (`str`) – playlist save location m3u_format (`bool`) – if `True`, save in M3U format, otherwise save in PLS format
Raises:	`GLib.Error`
Returns:	`True` if successful.
Return type:	`bool`

Saves the specified playlist to a file in either M3U or PLS format. This is part of the playlist manager dbus interface.

get_playlist_names()¶

Raises: GLib.Error

Returns:

True if successful.

playlists:	holds the array of playlist names on reutrn

Return type: (bool, playlists: str)

Allocates and returns an array containing the names of all local playlists. This is part of the playlist manager dbus interface.

get_playlists()¶

Returns:	list of playlists
Return type:	[`RB.Source`]

Returns a GLib.List containing all local playlist source objects.

load_playlists()¶: Loads the user’s playlists, or if the playlist file does not exists, reads the default playlist file. Should be called only once on startup.

new_playlist(suggested_name, automatic)¶

Parameters:	suggested_name (`str`) – optional name to use for the new playlist automatic (`bool`) – if `True`, create an auto playlist
Returns:	the new playlist object.
Return type:	`RB.Source`

Creates a new playlist and adds it to the source list.

new_playlist_from_selection_data(data)¶

Parameters:	data (`Gtk.SelectionData`) – the `Gtk.SelectionData` from which to create a playlist
Returns:	the new playlist.
Return type:	`RB.Source`

Creates a new playlist based on selection data from gtk. Used to implement playlist creation through drag and drop to the source list.

parse_file(uri)¶

Parameters:	uri (`str`) – URI of the playlist to load
Raises:	`GLib.Error`
Returns:	`True` on success
Return type:	`bool`

Parses a playlist file, adding entries to the database and to a new static playlist. If the playlist file includes a title, the static playlist created will have the same title.

remove_from_playlist(name, uri)¶

Parameters:	name (`str`) – name of the playlist to remove from uri (`str`) – URI of the entry to remove from the playlist
Raises:	`GLib.Error`
Returns:	`True` if successful.
Return type:	`bool`

Removes an entry from the specified playlist. Fails if no playlist with that name exists. This is part of the playlist manager dbus interface.

save_playlist_file(source)¶

Parameters:	source (`RB.Source`) –

save_playlists(force)¶

Parameters:	force (`bool`) – if `True`, save playlists synchronously and unconditionally
Returns:	`True` if a playlist save operation has been started
Return type:	`bool`

Saves the user’s playlists. If the force flag is True, the playlists will always be saved. Otherwise, the playlists will only be saved if a playlist has been created, modified, or deleted since the last time the playlists were saved, and no save operation is currently taking place.

shutdown()¶: Shuts down the playlist manager, making sure any outstanding playlist save operation finishes.

do_load_finish() virtual¶

do_load_start() virtual¶

do_playlist_added(source) virtual¶

Parameters:	source (`RB.Source`) –

do_playlist_created(source) virtual¶

Parameters:	source (`RB.Source`) –

Signal Details¶

RB.PlaylistManager.signals.load_finish(playlist_manager)¶

Signal Name:	`load-finish`
Flags:	`RUN_LAST`
Parameters:	playlist_manager (`RB.PlaylistManager`) – The object which received the signal

Emitted when the playlist manager finishes loading the user’s playlist file.

RB.PlaylistManager.signals.load_start(playlist_manager)¶

Signal Name:	`load-start`
Flags:	`RUN_LAST`
Parameters:	playlist_manager (`RB.PlaylistManager`) – The object which received the signal

Emitted when the playlist manager starts loading the user’s playlist file.

RB.PlaylistManager.signals.playlist_added(playlist_manager, source)¶

Signal Name:	`playlist-added`
Flags:	`RUN_LAST`
Parameters:	playlist_manager (`RB.PlaylistManager`) – The object which received the signal source (`GObject.Object`) – the new `RB.Source`

Emitted when a playlist is added, including when being loaded from the user’s playlist file.

RB.PlaylistManager.signals.playlist_created(playlist_manager, source)¶

Signal Name:	`playlist-created`
Flags:	`RUN_LAST`
Parameters:	playlist_manager (`RB.PlaylistManager`) – The object which received the signal source (`GObject.Object`) – the newly created playlist `RB.Source`

Emitted when a new playlist is created.

Property Details¶

RB.PlaylistManager.props.playlists_file¶

Name:	`playlists-file`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

playlists file

RB.PlaylistManager.props.shell¶

Name:	`shell`
Type:	`RB.Shell`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

RB.Shell object

RB.PlaylistManager.props.source¶

Name:	`source`
Type:	`RB.Source`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

RB.Source object