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