<page xmlns="http://projectmallard.org/1.0/"
type="guide"
id="youtube">
<info>
<link type="guide" xref="index#channels"/>
<link type="guide" xref="channels#list"/>
<link type="guide" xref="configuration#plugins"/>
<desc>Youtube music/video listings.</desc>
</info>
<title><media type="image" src="img/channel_youtube.png" /> Youtube</title>
<subtitle><link href="http://youtube.com/">//youtube.com/</link></subtitle>
<note style="bug"><p>This plugin is no longer supported or a default
channel. Due to exceeded quotas, it ceased working, and Youtube/Google
bothered me with inane requests for video recordings of how ST2 works
(instead of simply looking at the code or investigating their own logs).
Btw, the exceeded quota was unlikely due to regular ST2 usage. It's
more probable the builtin and plain-in-sight API key was reappropriated
otherwise. Hence, you would now have to
<link href="https://developers.google.com/youtube/v3/getting-started">get
your own key</link>, if you wanted to use this channel. Overall this
channel is not that interesting / worth the effort IMO.</p></note>
<p>Googles Youtube provides a quirky JSON API that makes browsing
channels and genres feasible. This beta plugin provides a little
overview, and usually retrieves recent video uploads.</p>
<p>VLC can directly play Youtube URLs. For other players one can use
<link href="http://youtube-dl.org/">youtube-dl</link> as wrapper.
For example <cmd>totem $(youtube-dl %srv)</cmd> as configured player
command.</p>
<p>Youtube-dl is preconfigured as "recording"/download tool for this channel
tab.</p>
<p>Of course you could also just invoke a specific YT video by
opening it in your web browser - click the station <key>home</key>
button simply.</p>
<section id="options">
<title>Channel options.</title>
<terms>
<item>
<title><code>🔠API key</code></title>
<p>You will have to aquire your own API key now, if you want to
test this plugin. Quite cumbersome, and not recommended, but see
<link href="https://developers.google.com/youtube/v3/getting-started">YouTube Data API Overview</link> </p>
</item>
<item>
<title><code>🔠Region</code></title>
<p>With the country dropdown you can predefine which mostPopular listings are returned.</p>
</item>
<item>
<title><code>🔠My Channels</code></title>
<p>You can edit the list of YT channel names to fetch some of your favourite artists/uploaders.
To apply this setting, and have new categories show up in the genre pane, use
<guiseq><gui>Channel</gui> <gui>Update category tree</gui></guiseq> first.</p>
<p>It's not an exact map, but utilizes the search function to find channels.</p>
</item>
<item>
<title><code>☑ Wadsworth constant</code></title>
<p>Only influences the video homepage link.</p>
</item>
</terms>
</section>
</page>