User interface API

Release:0.8.1
exception flacmanager.FLACManagerError(message, context_hint=None, cause=None)[source]

Bases: Exception

The type of exception raised when FLACManager operations fail.

Parameters:
  • message (str) – error message for logging or display
  • context_hint – describes the error context
  • cause (Exception) – the exception that caused this error

The optional context_hint is not part of the message, and may take any type or form. Exception handlers that catch FLACManagerError may choose to do something with the context hint, or may ignore it.

The optional cause is the (caught) exception that caused this FLACManagerError.

class flacmanager.FLACManager[source]

Bases: tkinter.Tk

The FLACManager GUI application.

USER_AGENT = 'FLACManager/0.8.1 Python/3.5.3'

Any HTTP(S) request issued by FLACManager uses this value for the HTTP User-Agent header value.

disk

The disk device node for the inserted CD-DA disc.

mountpoint

The file system mount point for the inserted CD-DA disc.

toc

The CD-DA disc’s TOC (table-of-contents).

reset()[source]

(Re)Initialize the FLACManager GUI.

has_required_config

Whether or not required configuration settings have been specified.

edit_required_config()[source]

Open a flacmanager.ini editor to allow the user to provide required configuration settings.

check_for_disc()[source]

Spawn the DiscCheck thread.

aggregate_metadata()[source]

Spawn the MetadataAggregator thread.

rip_and_tag()[source]

Create tagged FLAC and MP3 files of all included tracks.

persist_metadata_snapshot(showinfo=True)[source]

Serialize the current metadata field values to JSON.

Parameters:showinfo (bool) – whether or not to display a messagebox with the persisted metadata file path
eject_disc()[source]

Eject the current CD-DA disc and update the UI.

edit_aggregation_config()[source]

Open the configuration editor dialog.

edit_organization_config()[source]

Open the configuration editor dialog.

edit_flac_encoding_config()[source]

Open the configuration editor dialog.

edit_vorbis_comments_config()[source]

Open the configuration editor dialog.

edit_flac_organization_config()[source]

Open the configuration editor dialog.

edit_mp3_encoding_config()[source]

Open the configuration editor dialog.

edit_id3v2_tags_config()[source]

Open the configuration editor dialog.

edit_mp3_organization_config()[source]

Open the configuration editor dialog.

edit_ui_config()[source]

Open the configuration editor dialog.

edit_logging_config()[source]

Open the configuration editor dialog.

show_about()[source]

Open the application description dialog.

show_prerequisites()[source]

Open the prerequisites information dialog.

show_license()[source]

Open the copyright/license dialog.

exit()[source]

Quit the FLACManager application.