Grl.Media¶

Subclasses:: None

Methods¶

Inherited:: Grl.Data (36), GObject.Object (37)
Structs:: GObject.ObjectClass (5)

class	`audio_new` ()
class	`container_new` ()
class	`image_new` ()
class	`new` ()
class	`unserialize` (serial)
class	`video_new` ()
	`add_artist` (artist)
	`add_author` (author)
	`add_director` (director)
	`add_external_player` (player)
	`add_external_url` (url)
	`add_genre` (genre)
	`add_keyword` (keyword)
	`add_lyrics` (lyrics)
	`add_mb_artist_id` (mb_artist_id)
	`add_performer` (performer)
	`add_producer` (producer)
	`add_region_data` (region, publication_date, certificate)
	`add_thumbnail` (thumbnail)
	`add_thumbnail_binary` (thumbnail, size)
	`add_url_data` (url, mime, bitrate, framerate, width, height)
	`get_album` ()
	`get_album_artist` ()
	`get_album_disc_number` ()
	`get_artist` ()
	`get_artist_nth` (index)
	`get_author` ()
	`get_author_nth` (index)
	`get_bitrate` ()
	`get_camera_model` ()
	`get_certificate` ()
	`get_childcount` ()
	`get_composer` ()
	`get_composer_nth` (index)
	`get_creation_date` ()
	`get_description` ()
	`get_director` ()
	`get_director_nth` (index)
	`get_duration` ()
	`get_episode` ()
	`get_episode_title` ()
	`get_exposure_time` ()
	`get_external_url` ()
	`get_external_url_nth` (index)
	`get_favourite` ()
	`get_flash_used` ()
	`get_framerate` ()
	`get_genre` ()
	`get_genre_nth` (index)
	`get_height` ()
	`get_id` ()
	`get_iso_speed` ()
	`get_keyword` ()
	`get_keyword_nth` (index)
	`get_last_played` ()
	`get_last_position` ()
	`get_license` ()
	`get_lyrics` ()
	`get_lyrics_nth` (index)
	`get_mb_album_id` ()
	`get_mb_artist_id` ()
	`get_mb_artist_id_nth` (index)
	`get_mb_recording_id` ()
	`get_mb_release_group_id` ()
	`get_mb_release_id` ()
	`get_mb_track_id` ()
	`get_media_type` ()
	`get_mime` ()
	`get_modification_date` ()
	`get_orientation` ()
	`get_original_title` ()
	`get_performer` ()
	`get_performer_nth` (index)
	`get_play_count` ()
	`get_player` ()
	`get_player_nth` (index)
	`get_producer` ()
	`get_producer_nth` (index)
	`get_publication_date` ()
	`get_rating` ()
	`get_region` ()
	`get_region_data` ()
	`get_region_data_nth` (index)
	`get_season` ()
	`get_show` ()
	`get_site` ()
	`get_size` ()
	`get_source` ()
	`get_start_time` ()
	`get_studio` ()
	`get_thumbnail` ()
	`get_thumbnail_binary` (size)
	`get_thumbnail_binary_nth` (size, index)
	`get_thumbnail_nth` (index)
	`get_title` ()
	`get_track_number` ()
	`get_url` ()
	`get_url_data` (framerate, width, height)
	`get_url_data_nth` (index, framerate, width, height)
	`get_width` ()
	`is_audio` ()
	`is_container` ()
	`is_image` ()
	`is_video` ()
	`serialize` ()
	`set_album` (album)
	`set_album_artist` (album_artist)
	`set_album_disc_number` (disc_number)
	`set_artist` (artist)
	`set_author` (author)
	`set_bitrate` (bitrate)
	`set_camera_model` (camera_model)
	`set_certificate` (certificate)
	`set_childcount` (childcount)
	`set_composer` (composer)
	`set_creation_date` (creation_date)
	`set_description` (description)
	`set_director` (director)
	`set_duration` (duration)
	`set_episode` (episode)
	`set_episode_title` (episode_title)
	`set_exposure_time` (exposure_time)
	`set_external_player` (player)
	`set_external_url` (url)
	`set_favourite` (favourite)
	`set_flash_used` (flash_used)
	`set_framerate` (framerate)
	`set_genre` (genre)
	`set_height` (height)
	`set_id` (id)
	`set_iso_speed` (iso_speed)
	`set_keyword` (keyword)
	`set_last_played` (last_played)
	`set_last_position` (last_position)
	`set_license` (license)
	`set_lyrics` (lyrics)
	`set_mb_album_id` (mb_album_id)
	`set_mb_artist_id` (mb_artist_id)
	`set_mb_recording_id` (mb_recording_id)
	`set_mb_release_group_id` (mb_release_group_id)
	`set_mb_release_id` (mb_release_id)
	`set_mb_track_id` (mb_track_id)
	`set_mime` (mime)
	`set_modification_date` (modification_date)
	`set_orientation` (orientation)
	`set_original_title` (original_title)
	`set_performer` (performer)
	`set_play_count` (play_count)
	`set_producer` (producer)
	`set_publication_date` (date)
	`set_rating` (rating, max)
	`set_region` (region)
	`set_region_data` (region, publication_date, certificate)
	`set_season` (season)
	`set_show` (show)
	`set_site` (site)
	`set_size` (size)
	`set_source` (source)
	`set_studio` (studio)
	`set_thumbnail` (thumbnail)
	`set_thumbnail_binary` (thumbnail, size)
	`set_title` (title)
	`set_track_number` (track_number)
	`set_url` (url)
	`set_url_data` (url, mime, bitrate, framerate, width, height)
	`set_width` (width)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

Name	Type	Flags	Short Description
`media-type`	`Grl.MediaType`	r/w/c	Type of media

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent	`Grl.Data`	r

Class Details¶

class Grl.Media(**kwargs)¶

Bases:: Grl.Data
Abstract:: No
Structure:: Grl.MediaClass

classmethod audio_new()¶

Returns:: a newly-allocated media audio.
Return type:: Grl.Media

Creates a new media audio object.

New in version 0.1.4.

classmethod container_new()¶

Returns:: a newly-allocated media container.
Return type:: Grl.Media

Creates a new media container object.

New in version 0.3.0.

classmethod image_new()¶

Returns:: a newly-allocated media image.
Return type:: Grl.Media

Creates a new media image object.

New in version 0.1.4.

classmethod new()¶

Returns:: a newly-allocated data media.
Return type:: Grl.Media

Creates a new data media object.

classmethod unserialize(serial)¶

Parameters:: serial (str) – a serialized media
Returns:: the Grl.Media from the serial
Return type:: Grl.Media

Unserializes a Grl.Media.

New in version 0.1.6.

classmethod video_new()¶

Returns:: a newly-allocated media video.
Return type:: Grl.Media

Creates a new media video object.

New in version 0.1.4.

add_artist(artist)¶

Parameters:: artist (str) – an audio’s artist

Adds a new artist to self.

New in version 0.3.0.

add_author(author)¶

Parameters:: author (str) – an author for self

Adds a new author to self.

New in version 0.1.10.

add_director(director)¶

Parameters:: director (str) – director of the movie

Adds the director of the media

New in version 0.3.0.

add_external_player(player)¶

Parameters:: player (str) – an external player for self

Adds a new external player to self.

New in version 0.1.10.

add_external_url(url)¶

Parameters:: url (str) – an external url for self

Adds a new external url to self.

New in version 0.1.10.

add_genre(genre)¶

Parameters:: genre (str) – an audio’s genre

Adds a new genre to self.

New in version 0.3.0.

add_keyword(keyword)¶

Parameters:: keyword (str) – a keyword describing the media

Adds the keyword describing the self.

New in version 0.2.3.

add_lyrics(lyrics)¶

Parameters:: lyrics (str) – an audio’s lyrics

Adds a new lyrics to self.

New in version 0.3.0.

add_mb_artist_id(mb_artist_id)¶

Parameters:: mb_artist_id (str) – a MusicBrainz artist identifier

Adds a new MusicBrainz artist id to self.

New in version 0.3.0.

add_performer(performer)¶

Parameters:: performer (str) – an actor performing in the movie

Adds the actor performing in the movie.

New in version 0.3.0.

add_producer(producer)¶

Parameters:: producer (str) – producer of the movie

Adds the producer of the media.

New in version 0.3.0.

add_region_data(region, publication_date, certificate)¶

Parameters:

region (str) – the region’s ISO-3166-1 code
publication_date (GLib.DateTime) – the publication date
certificate (str) – the age certification

Adds regional publication and certification information for region.

New in version 0.2.3.

add_thumbnail(thumbnail)¶

Parameters:: thumbnail (str) – a thumbnail for self

Adds a new thumbnail to self.

New in version 0.1.10.

add_thumbnail_binary(thumbnail, size)¶

Parameters:

thumbnail (int) – a buffer containing the thumbnail for self
size (int) – size of buffer

Adds a new thumbnail to self.

New in version 0.1.10.

add_url_data(url, mime, bitrate, framerate, width, height)¶

Parameters:

url (str) – a media’s URL
mime (str) – th url mime type
bitrate (int) – the url bitrate, or -1 to ignore
framerate (float) – media framerate, or -1 to ignore
width (int) – media width, or -1 to ignore
height (int) – media height, or -1 to ignore

Sets all the keys related with the URL of a media resource and adds it to self (useful for resources with more than one URL).

New in version 0.3.0.

get_album()¶

Returns:: the album of the media
Return type:: str

New in version 0.3.0.

get_album_artist()¶

Returns:: the main artist of the album of the media
Return type:: str

New in version 0.3.1.

get_album_disc_number()¶

Returns:: the disc number of the media for multi-disc album sets.
Return type:: int

New in version 0.3.1.

get_artist()¶

Returns:: the artist of the media
Return type:: str

New in version 0.3.0.

get_artist_nth(index)¶

Parameters:: index (int) – element to retrieve, starting at 0
Returns:: the n-th artist of the media
Return type:: str

New in version 0.3.0.

get_author()¶

Returns:: the media’s author
Return type:: str

New in version 0.1.4.

get_author_nth(index)¶

Parameters:: index (int) – element to retrieve
Returns:: the n-th media’s author.
Return type:: str

New in version 0.1.10.

get_bitrate()¶

Returns:: the bitrate of the media
Return type:: int

New in version 0.3.0.

get_camera_model()¶

Returns:: model of camera used to take picture
Return type:: str

New in version 0.3.0.

get_certificate()¶

Returns:: the media’s age certification
Return type:: str

Returns the media’s first age certificate. This should usually be the media’s most relevant age certificate. Use Grl.Media.get_region_data_nth() to get other age certificates.

New in version 0.1.6.

get_childcount()¶

Returns:: number of children, or Grl.METADATA_KEY_CHILDCOUNT_UNKNOWN if unknown.
Return type:: int

Number of children of this container.

New in version 0.3.0.

get_composer()¶

Returns:: the composer of the media
Return type:: str

New in version 0.3.1.

get_composer_nth(index)¶

Parameters:: index (int) – element to retrieve, starting at 0
Returns:: the n-th composer of the media
Return type:: str

New in version 0.3.1.

get_creation_date()¶

Returns:: date when media was created (owned by self).
Return type:: GLib.DateTime

New in version 0.2.0.

get_description()¶

Returns:: the media’s description
Return type:: str

New in version 0.1.4.

get_director()¶

Returns:: the director of the movie (owned by self).
Return type:: str

New in version 0.3.0.

get_director_nth(index)¶

Parameters:: index (int) – element to retrieve
Returns:: the director of the movie (owned by self).
Return type:: str

New in version 0.3.0.

get_duration()¶

Returns:: the media’s duration in seconds
Return type:: int

New in version 0.1.4.

get_episode()¶

Returns:: the episode number of the media
Return type:: int

New in version 0.3.0.

get_episode_title()¶

Returns:: the title of the episode
Return type:: str

New in version 0.3.0.

get_exposure_time()¶

Returns:: picture’s exposure time
Return type:: float

New in version 0.3.0.

get_external_url()¶

Returns:: URL of an external location where the user play the media.
Return type:: str

New in version 0.1.6.

get_external_url_nth(index)¶

Parameters:: index (int) – element to retrieve
Returns:: the n-th media’s external location where the user can play it.
Return type:: str

New in version 0.1.10.

get_favourite()¶

Returns:: whether the media is favourite or not
Return type:: bool

New in version 0.2.3.

get_flash_used()¶

Returns:

whether the flash was used.

See http://library.gnome.org/devel/ontology/unstable/nmm-classes.html#nmm-Flash

Return type:

str

New in version 0.3.0.

get_framerate()¶

Returns:: the framerate of the media
Return type:: float

New in version 0.3.0.

get_genre()¶

Returns:: the genre of the media
Return type:: str

New in version 0.3.0.

get_genre_nth(index)¶

Parameters:: index (int) – element to retrieve, starting at 0
Returns:: the n-th genre of the media
Return type:: str

New in version 0.3.0.

get_height()¶

Returns:: the height of the media
Return type:: int

New in version 0.3.0.

get_id()¶

Returns:: the media’s identifier
Return type:: str

New in version 0.1.4.

get_iso_speed()¶

Returns:: picture’s iso speed
Return type:: float

New in version 0.3.0.

get_keyword()¶

Returns:: the keyword describing the self (owned by self).
Return type:: str

New in version 0.2.3.

get_keyword_nth(index)¶

Parameters:: index (int) – element to retrieve
Returns:: the keyword describing the self (owned by self).
Return type:: str

New in version 0.2.3.

get_last_played()¶

Returns:: the media’s last played time
Return type:: GLib.DateTime

New in version 0.3.0.

get_last_position()¶

Returns:: the media’s last_played position (in seconds)
Return type:: int

New in version 0.1.4.

get_license()¶

Returns:: the license the media is under
Return type:: str

New in version 0.1.6.

get_lyrics()¶

Returns:: the lyrics of the media
Return type:: str

New in version 0.3.0.

get_lyrics_nth(index)¶

Parameters:: index (int) – element to retrieve, starting at 0
Returns:: the n-th lyrics of the media
Return type:: str

New in version 0.3.0.

get_mb_album_id()¶

Returns:: the MusicBrainz album identifier
Return type:: str

New in version 0.3.0.

Deprecated since version 0.3.8: in favor of more specific metadata-keys Grl.METADATA_KEY_MB_RELEASE_ID and Grl.METADATA_KEY_MB_RELEASE_GROUP_ID

get_mb_artist_id()¶

Returns:: the MusicBrainz artist identifier
Return type:: str

New in version 0.3.0.

get_mb_artist_id_nth(index)¶

Parameters:: index (int) – element to retrieve, starting at 0
Returns:: the n-th MusicBrainz artist identifier of the media
Return type:: str

New in version 0.3.0.

get_mb_recording_id()¶

Returns:: the MusicBrainz recording identifier
Return type:: str

New in version 0.3.0.

get_mb_release_group_id()¶

Returns:: the MusicBrainz release group identifier of the media
Return type:: str

New in version 0.3.8.

get_mb_release_id()¶

Returns:: the MusicBrainz release identifier of the media
Return type:: str

New in version 0.3.8.

get_mb_track_id()¶

Returns:: the MusicBrainz track identifier
Return type:: str

New in version 0.3.0.

get_media_type()¶

Returns:: media type
Return type:: Grl.MediaType

Gets the “media-type” property.

New in version 0.3.0.

get_mime()¶

Returns:: the media’s mime-type
Return type:: str

New in version 0.1.4.

get_modification_date()¶

Returns:: date when the media was last modified (owned by self).
Return type:: GLib.DateTime

New in version 0.2.0.

get_orientation()¶

Returns:: degrees clockwise orientation of the picture
Return type:: int

New in version 0.3.0.

get_original_title()¶

Returns:: the original, untranslated title of the movie (owned by self).
Return type:: str

New in version 0.3.0.

get_performer()¶

Returns:: the actor performing in the movie (owned by self).
Return type:: str

New in version 0.3.0.

get_performer_nth(index)¶

Parameters:: index (int) – element to retrieve
Returns:: the actor performing in the movie (owned by medi).
Return type:: str

New in version 0.3.0.

get_play_count()¶

Returns:: the media’s play count
Return type:: int

New in version 0.1.4.

get_player()¶

Returns:: URL of an external player object for this media
Return type:: str

New in version 0.1.6.

get_player_nth(index)¶

Parameters:: index (int) – element to retrieve
Returns:: the n-th media’s external player object.
Return type:: str

New in version 0.1.10.

get_producer()¶

Returns:: the producer of the movie (owned by self).
Return type:: str

New in version 0.3.0.

get_producer_nth(index)¶

Parameters:: index (int) – element to retrieve
Returns:: the producer of the movie (owned by self).
Return type:: str

New in version 0.3.0.

get_publication_date()¶

Returns:: the publication date of self (owned by self).
Return type:: GLib.DateTime

New in version 0.2.0.

get_rating()¶

Returns:: the media’s rating
Return type:: float

New in version 0.1.5.

get_region()¶

Returns:: the ISO-3166-1 of the region where the media was published (owned by self).
Return type:: str

New in version 0.2.3.

get_region_data()¶

Returns:

the ISO-3166-1 of the region where the media was published (owned by self).

publication_date:: the publication date, or None to ignore.
certificate:: the age certification, or None to ignore.

Return type:

(str, publication_date: GLib.DateTime, certificate: str)

Returns the media’s age certificate and publication date for the first region. This should usually be the media’s most relevant region. Use Grl.Media.get_region_data_nth() to get the age certificate and publication date for other regions.

New in version 0.2.3.

get_region_data_nth(index)¶

Parameters:

index (int) – element to retrieve

Returns:

the ISO-3166-1 of the region where the media was published (owned by self).

publication_date:: the publication date, or None to ignore.
certificate:: the age certification, or None to ignore.

Return type:

(str, publication_date: GLib.DateTime, certificate: str)

Returns the media’s age certificate and publication date for one region. Use Grl.Data.length() with Grl.METADATA_KEY_REGION to discover how many regions are available. For instance:

guint count = grl_data_length (GRL_DATA (media), GRL_METADATA_KEY_REGION);
guint i;
for (i = 0; i < count; ++i) {
  const GDateTime* publication_date = NULL;
  const gchar* certificate = NULL;
  const gchar* region =
    grl_media_get_region_data_nth (media, i,
      &publication_date, &certificate);
  ...
}

New in version 0.2.3.

get_season()¶

Returns:: the season number of the media
Return type:: int

New in version 0.3.0.

get_show()¶

Returns:: the show title of the media
Return type:: str

New in version 0.3.0.

get_site()¶

Returns:: the media’s site
Return type:: str

New in version 0.1.4.

get_size()¶

Returns:: the media’s size, in bytes or -1 if unknown.
Return type:: int

New in version 0.2.10.

get_source()¶

Returns:: the media’s source
Return type:: str

New in version 0.1.4.

get_start_time()¶

Returns:: the start time of the logical media resource inside the file containing it, in seconds.
Return type:: float

New in version 0.1.19.

get_studio()¶

Returns:: the studio the media is from
Return type:: str

New in version 0.1.6.

get_thumbnail()¶

Returns:: the media’s thumbnail URL
Return type:: str

New in version 0.1.4.

get_thumbnail_binary(size)¶

Parameters:: size (int) – pointer to storing the thumbnail buffer size
Returns:: the media’s thumbnail data and set size to the thumbnail buffer size
Return type:: int

New in version 0.1.9.

get_thumbnail_binary_nth(size, index)¶

Parameters:

size (int) – pointer to store the thumbnail buffer size
index (int) – element to retrieve

Returns:

the n-th media’s thumbnail binary and sets size to the thumbnail buffer size.

Return type:

int

New in version 0.1.10.

get_thumbnail_nth(index)¶

Parameters:: index (int) – element to retrieve
Returns:: the n-th media’s thumbnail.
Return type:: str

New in version 0.1.10.

get_title()¶

Returns:: the media’s title
Return type:: str

New in version 0.1.4.

get_track_number()¶

Returns:: the track number of the media
Return type:: int

New in version 0.3.0.

get_url()¶

Returns:: the media’s URL
Return type:: str

New in version 0.1.4.

get_url_data(framerate, width, height)¶

Parameters:

framerate (float) – the url framerate, or None to ignore
width (int) – the url width, or None to ignore
height (int) – the url height, or None to ignore

Returns:

the media’s URL and its related properties.

mime:: the mime-type, or None to ignore.
bitrate:: the url bitrate, or None to ignore

Return type:

(str, mime: str, bitrate: int)

New in version 0.3.0.

get_url_data_nth(index, framerate, width, height)¶

Parameters:

index (int) – element to retrieve
framerate (float) – the url framerate, or None to ignore
width (int) – the url width, or None to ignore
height (int) – the url height, or None to ignore

Returns:

the n-th media’s URL and its related properties.

mime:: the mime-type, or None to ignore.
bitrate:: the url bitrate, or None to ignore

Return type:

(str, mime: str, bitrate: int)

New in version 0.3.0.

get_width()¶

Returns:: the width of the media
Return type:: int

New in version 0.3.0.

is_audio()¶

Returns:: True if self is an audio
Return type:: bool

Check if self is an audio

New in version 0.3.0.

is_container()¶

Returns:: True if self is a container
Return type:: bool

Check if self is a container

New in version 0.3.0.

is_image()¶

Returns:: True if self is an image
Return type:: bool

Check if self is an image

New in version 0.3.0.

is_video()¶

Returns:: True if self is a video
Return type:: bool

Check if self is a video

New in version 0.3.0.

serialize()¶

Returns:: serialized media
Return type:: str

Serializes a Grl.Media into a string. It does a basic serialization.

See grl_media_serialize_extended() to get more serialization approaches.

New in version 0.1.6.

set_album(album)¶

Parameters:: album (str) – the audio’s album

Set the album of the media

New in version 0.3.0.

set_album_artist(album_artist)¶

Parameters:: album_artist (str) – the audio’s album main artist

Set the main artist of the album of the media

New in version 0.3.1.

set_album_disc_number(disc_number)¶

Parameters:: disc_number (int) – the disc number within an album

Set the disc number of the media for multi-disc album sets.

New in version 0.3.1.

set_artist(artist)¶

Parameters:: artist (str) – the audio’s artist

Set the artist of the media

New in version 0.3.0.

set_author(author)¶

Parameters:: author (str) – the media’s author

Set the media’s author

New in version 0.1.4.

set_bitrate(bitrate)¶

Parameters:: bitrate (int) – the audio’s bitrate

Set the bitrate of the media

New in version 0.3.0.

set_camera_model(camera_model)¶

Parameters:: camera_model (str) – model of camera used to take picture

Set the camera_model of the media

New in version 0.3.0.

set_certificate(certificate)¶

Parameters:: certificate (str) – The age certificate of the media

Set the media’s first age certification. This should usually be the media’s most relevant age certificate. Use Grl.Media.set_region_data() to set other age certificates.

New in version 0.1.6.

set_childcount(childcount)¶

Parameters:: childcount (int) – number of children

Sets the number of children of this container. Use Grl.METADATA_KEY_CHILDCOUNT_UNKNOWN if it is unknown.

New in version 0.3.0.

set_composer(composer)¶

Parameters:: composer (str) – the audio’s composer

Set the composer of the media

New in version 0.3.1.

set_creation_date(creation_date)¶

Parameters:: creation_date (GLib.DateTime) – date when media was created

Set the creation_date of the media

New in version 0.2.0.

set_description(description)¶

Parameters:: description (str) – the description

Set the media’s description

New in version 0.1.4.

set_director(director)¶

Parameters:: director (str) – director of the movie

Sets the director of the media.

New in version 0.3.0.

set_duration(duration)¶

Parameters:: duration (int) – the duration in seconds

Set the media’s duration

New in version 0.1.4.

set_episode(episode)¶

Parameters:: episode (int) – the video’s episode

Sets the episode number of the media

New in version 0.3.0.

set_episode_title(episode_title)¶

Parameters:: episode_title (str) – the title of the episode

Sets the title of an media

New in version 0.3.0.

set_exposure_time(exposure_time)¶

Parameters:: exposure_time (float) – picture’s exposure time

Set the exposure_time of the media

New in version 0.3.0.

set_external_player(player)¶

Parameters:: player (str) – location of an external player for this media

Set the location of a player for the media (usually a flash player)

New in version 0.1.6.

set_external_url(url)¶

Parameters:: url (str) – external location where this media can be played.

Set an external location where users can play the media

New in version 0.1.6.

set_favourite(favourite)¶

Parameters:: favourite (bool) – whether the item is favourite or not

Set if the media is favourite or not

New in version 0.2.3.

set_flash_used(flash_used)¶

Parameters:: flash_used (str) – whether the flash was used

Set the flash_used of the media See http://library.gnome.org/devel/ontology/unstable/nmm-classes.html#nmm-Flash

New in version 0.3.0.

set_framerate(framerate)¶

Parameters:: framerate (float) – the video’s framerate

Set the framerate of the media

New in version 0.3.0.

set_genre(genre)¶

Parameters:: genre (str) – the audio’s genre

Set the genre of the media

New in version 0.3.0.

set_height(height)¶

Parameters:: height (int) – the video’s height

Set the height of the media

New in version 0.3.0.

set_id(id)¶

Parameters:: id (str) – the identifier of the media

Set the media identifier

New in version 0.1.4.

set_iso_speed(iso_speed)¶

Parameters:: iso_speed (float) – picture’s iso speed

Set the iso_speed of the media

New in version 0.3.0.

set_keyword(keyword)¶

Parameters:: keyword (str) – a keyword describing the media

Sets the keyword describing the self.

New in version 0.2.3.

set_last_played(last_played)¶

Parameters:: last_played (GLib.DateTime) – date when the media was last played

Set the media last played date

New in version 0.3.0.

set_last_position(last_position)¶

Parameters:: last_position (int) – second at which the media playback was interrupted

Set the media last played position

New in version 0.1.4.

set_license(license)¶

Parameters:: license (str) – The license of the media

Set the media license

New in version 0.1.6.

set_lyrics(lyrics)¶

Parameters:: lyrics (str) – the audio’s lyrics

Set the lyrics of the media

New in version 0.3.0.

set_mb_album_id(mb_album_id)¶

Parameters:: mb_album_id (str) – the MusicBrainz album identifier

Set the MusicBrainz album identifier of the media

New in version 0.3.0.

Deprecated since version 0.3.8: in favor of more specific metadata-keys Grl.METADATA_KEY_MB_RELEASE_ID and Grl.METADATA_KEY_MB_RELEASE_GROUP_ID

set_mb_artist_id(mb_artist_id)¶

Parameters:: mb_artist_id (str) – the MusicBrainz artist identifier

Set the MusicBrainz artist identifier of the media

New in version 0.3.0.

set_mb_recording_id(mb_recording_id)¶

Parameters:: mb_recording_id (str) – the MusicBrainz recording identifier

Set the MusicBrainz recording identifier of the media

New in version 0.3.0.

set_mb_release_group_id(mb_release_group_id)¶

Parameters:: mb_release_group_id (str) – Album group release identifier in MusicBrainz

Set the MusicBrainz Release Group identifier of the media

New in version 0.3.8.

set_mb_release_id(mb_release_id)¶

Parameters:: mb_release_id (str) – Album release identifier in MusicBrainz

Set the MusicBrainz release identifier of the media

New in version 0.3.8.

set_mb_track_id(mb_track_id)¶

Parameters:: mb_track_id (str) – the MusicBrainz track identifier

Set the MusicBrainz track identifier of the media

New in version 0.3.0.

set_mime(mime)¶

Parameters:: mime (str) – the mime type

Set the media’s mime-type

New in version 0.1.4.

set_modification_date(modification_date)¶

Parameters:: modification_date (GLib.DateTime) – date when the media was last modified

Set the modification date of the media

New in version 0.2.0.

set_orientation(orientation)¶

Parameters:: orientation (int) – degrees clockwise orientation of the picture

Set the orientation of the media

New in version 0.3.0.

set_original_title(original_title)¶

Parameters:: original_title (str) – original, untranslated title of the movie

Sets the original, untranslated title of the media.

New in version 0.3.0.

set_performer(performer)¶

Parameters:: performer (str) – an actor performing in the movie

Sets the actor performing in the movie.

New in version 0.3.0.

set_play_count(play_count)¶

Parameters:: play_count (int) – the play count

Set the media play count

New in version 0.1.4.

set_producer(producer)¶

Parameters:: producer (str) – producer of the movie

Sets the producer of the media.

New in version 0.3.0.

set_publication_date(date)¶

Parameters:: date (GLib.DateTime) – the date

Set the publication date of self.

New in version 0.2.0.

set_rating(rating, max)¶

Parameters:

rating (float) – a rating value
max (float) – maximum rating value

This method receives a rating and its scale and normalizes it on a scale from 0…5 to match the usual five-star rating.

New in version 0.1.5.

set_region(region)¶

Parameters:: region (str) – the region’s ISO-3166-1 code

Sets the region where self was published.

New in version 0.2.3.

set_region_data(region, publication_date, certificate)¶

Parameters:

region (str) – the region’s ISO-3166-1 code
publication_date (GLib.DateTime) – the publication date
certificate (str) – the age certification

Sets regional publication and certification information for region.

New in version 0.2.3.

set_season(season)¶

Parameters:: season (int) – the video’s season

Sets the season number of the media

New in version 0.3.0.

set_show(show)¶

Parameters:: show (str) – the video’s show name

Sets the show title of the media

New in version 0.3.0.

set_site(site)¶

Parameters:: site (str) – the site

Set the media’s site. A site is a website about the media such as a studio’s promotional website for a movie.

New in version 0.1.4.

set_size(size)¶

Parameters:: size (int) – the size in bytes

Set the size of the media

New in version 0.2.10.

set_source(source)¶

Parameters:: source (str) – the source

Set the media’s source

New in version 0.1.4.

set_studio(studio)¶

Parameters:: studio (str) – The studio the media is from

Set the media studio

New in version 0.1.6.

set_thumbnail(thumbnail)¶

Parameters:: thumbnail (str) – the thumbnail URL

Set the media’s thumbnail URL

New in version 0.1.4.

set_thumbnail_binary(thumbnail, size)¶

Parameters:

thumbnail (int) – thumbnail buffer
size (int) – thumbnail buffer size

Set the media’s binary thumbnail

New in version 0.1.9.

set_title(title)¶

Parameters:: title (str) – the title

Set the media’s title

New in version 0.1.4.

set_track_number(track_number)¶

Parameters:: track_number (int) – the audio’s track number

Set the track number of the media

New in version 0.3.0.

set_url(url)¶

Parameters:: url (str) – the media’s URL

Set the media’s URL

New in version 0.1.4.

set_url_data(url, mime, bitrate, framerate, width, height)¶

Parameters:

url (str) – the media’s URL
mime (str) – the url mime type
bitrate (int) – the url bitrate, or -1 to ignore
framerate (float) – media framerate, or -1 to ignore
width (int) – media width, or -1 to ignore
height (int) – media height, or -1 to ignore

Sets all the keys related with the URL of a media resource in one go.

New in version 0.3.0.

set_width(width)¶

Parameters:: width (int) – the video’s width

Set the width of the media

New in version 0.3.0.

Property Details¶

Grl.Media.props.media_type¶

Name:: media-type
Type:: Grl.MediaType
Default Value:: Grl.MediaType.UNKNOWN
Flags:: READABLE, WRITABLE, CONSTRUCT

Type of media