Music and podcasts¶
From "apiVersion": 8 (Kino 0.9.54) a plugin can offer audio next to (or instead of) video:
albums, playlists and tracks, podcasts, audiobooks and radio shows. This page is the short version;
every rule, with its exact values, is in the contract:
Music and podcasts.
The two kinds¶
kind |
What it is | One "episode" is |
|---|---|---|
"music" |
an album, a playlist or a single track | a track |
"podcast" |
a show, an audiobook or a radio program | an episode or a chapter |
An audio item goes in search, browse, home rows and your section like any other item. The
optional artist field (music and podcast only, at most 200 characters) is the artist, or the
host or author: the album or podcast page shows it under the title.
How it plays¶
- With the
episodescapability, Kino callsepisodes(ref)for everymusicandpodcastitem: the tracks of an album, the chapters of an audiobook, the episodes of a show, in your order. It must answer for each audio ref, even a single track (one entry): there is no per-item way to skip it. Each entry'srefgoes toresolve. - Without
episodes, the item's ownrefgoes straight toresolveand plays as one track. - The
Streamis a normal one: progressive audio (MP3, M4A, AAC, OGG) or an HLS/DASH manifest.
Before you declare 8¶
- An older Kino refuses an apiVersion 8 plugin ("Este plugin necesita una versión más nueva de
Kino"): declare 8 only when you return audio items or export
details. - Below apiVersion 8 a
musicorpodcastitem is dropped (with a line in the log); the rest of the answer stays. - From apiVersion 8,
detailsis a reserved export name: never export a helper calleddetails.
The reference audio plugin¶
Internet Archive Audio
(kinotvapp/kino-plugin-archive-audio, apiVersion 8): free music, live concerts, audiobooks and
old-time radio from archive.org. Its episodes answers for every album, audiobook and show (a single
78 rpm side included), and resolve offers each audio format as a labelled lazy copy. Start from it
for an audio plugin; see also Example plugins.
What the person gets in Kino 0.9.54 (square covers, the album or podcast page, the audio player, "Seguir escuchando", downloads and cast) is listed in the contract.