RB.ShellPreferences¶

The ‘general’ preferences page controls the set of browser views that are visible (artist and album; genre and artist; or genre, artist, and album), the columns that are visible, and the appearance of buttons in the main toolbar. The browser and column settings apply to all sources.

The ‘playback’ preferences page controls whether the crossfading player backend is used, and if enabled, the crossfade duration and network buffer size.

Currently, the library and podcast sources add pages to the notebook, for configuring the location and layout of the library and the podcast download location and update frequency.

classmethod new(views)¶

Parameters:: views ([RB.Source]) – list of sources to check for preferences pages
Returns:: the RB.ShellPreferences instance
Return type:: Gtk.Widget

Creates the RB.ShellPreferences instance, populating it with the preferences pages for the sources in the list.

add_widget(widget, location, expand, fill)¶

Parameters:

widget (Gtk.Widget) – the Gtk.Widget to insert into the preferences window
location (RB.ShellPrefsUILocation) – the location at which to insert the widget
expand (bool) – whether the widget should be given extra space
fill (bool) – whether the widget should fill all space allocated to it

Adds a widget to the preferences window. See Gtk.Box.pack_start for details on how the expand and fill parameters work. This function can be used to add widgets to the ‘general’ and ‘playback’ pages.

append_page(name, widget)¶

Parameters:

name (str) – name of the page to append
widget (Gtk.Widget) – the Gtk.Widget to use as the contents of the page

Appends a new page to the preferences dialog notebook.

remove_widget(widget, location)¶

Parameters:

widget (Gtk.Widget) – the Gtk.Widget to remove from the preferences window
location (RB.ShellPrefsUILocation) – the UI location to which the widget was originally added

Removes a widget added with RB.ShellPreferences.add_widget from the preferences window.