Internet radio browser GUI for music/video streams from various directory services.

⌈⌋ ⎇ branch:  streamtuner2


Check-in [b0ca9793cb]

Overview
Comment:Explain in detail how to enable pluginmanager2 extension.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: b0ca9793cb05b8f891141456c391383db7c159fb
User & Date: mario on 2015-05-07 17:12:16
Other Links: manifest | tags
Context
2015-05-07
19:21
Step-tutorial for bookmarking a station. check-in: c159673973 user: mario tags: trunk
17:12
Explain in detail how to enable pluginmanager2 extension. check-in: b0ca9793cb user: mario tags: trunk
17:11
Additional project+help links for manual. check-in: 76cf990460 user: mario tags: trunk
Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Modified help/html/pluginmanager2.html from [cf765fbc67] to [8e973d6b44].

︙
16
17
18
19
20
21
22





23
24


25
26
27
28
29
30



31
32
33
34
35
36
37

16
17
18
19
20
21
22
23
24
25
26
27


28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45








+
+
+
+
+
-
-
+
+






+
+
+








<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Plugin Manager 2</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">For updating or installing new plugins (extra channels or
	features), there's a user plugin manager. It's available as
	feature extension itself.</p>
<div class="steps"><div class="inner"><div class="region"><ol class="steps">
<li class="steps"><p class="p">See the <span class="key"><kbd>F12</kbd></span> config dialog <span class="key"><kbd>🔌 Feature</kbd></span> section.</p></li>
<li class="steps"><p class="p">Enable the <span class="key"><kbd>⨯</kbd></span> Plugin Manager (listed near the end).</p></li>
<li class="steps"><p class="p">Restart streamtuner2 one last time for this change to take effect.</p></li>
</ol></div></div></div>
<p class="p">Once acticated (after a restart) it brings up a new <span class="key"><kbd>📦
	Add</kbd></span> tab in the configuration window.</p>
<p class="p">Once acticated it brings up a new <span class="key"><kbd>📦 Add</kbd></span> tab
	in the configuration window.</p>
<p class="p"><span class="media"><span class="media media-image"><img src="img/pluginmanager2.png" class="media media-inline" alt="Install dialog for user plugins"></span></span></p>
<p class="p">You can scan for available/new plugins there. And have them
	downloaded right away. New plugins are just downloaded, not
	implictly enabled. Reopen the config dialog to see them in the
	regular <span class="key"><kbd>📻 Channels</kbd></span> or <span class="key"><kbd>🔌 Feature</kbd></span> tabs, and
	then enable them.</p>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">Updated plugins will not be automatically loaded if they
	were enable already. That requires either a restart, or disabling +
	saving once, then reenabling them.</p></div></div></div></div>
<div class="links topiclinks"><div class="inner"><div class="region"><div class="linkdiv "><a class="linkdiv" href="configuration.html#plugins" title="Channel and feature plugins and settings"><span class="title">Channel and feature plugins and settings</span></a></div></div></div></div>
</div>
<div id="configuration" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Configuration</span></h2></div>
<div class="region"><div class="contents"><div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">Alternative download repositories may be configured. (Little
	practical value at the moment.)</p></li>
︙
57
58
59
60
61
62
63










64
65
66
67
68
69
70

65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88








+
+
+
+
+
+
+
+
+
+








<div class="note note-bug" title="Bug"><div class="inner"><div class="region"><div class="contents">
<p class="p">Currently system-installed core plugins take
	precedence over downloaded updates.</p>
<p class="p">And you'll have to take care to eventually refresh/delete outdated user plugins,
	whenever you install a newer Streamtuner2 version.</p>
</div></div></div></div>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h3 class="subtitle"><span class="subtitle">Disable user plugin loading</span></h3></div>
<div class="region"><div class="contents">
<p class="p">Since this is still rather experimental, you may disable all
	associated features by starting ST2 via:</p>
<div class="screen"><pre class="contents ">streamtuner2 -d <span class="input">pluginmanager2</span></pre></div>
<p class="p">That'll inhibit loading this extension plugin. (Also works
	with any other plugin id.)</p>
</div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul><li class="links "><a href="index.html#extra" title="Additional features">Additional features</a></li></ul></div>
</div></div></div>
︙

Modified help/pluginmanager2.page from [ada0b863a5] to [2d93aaf423].

︙
10
11
12
13
14
15
16






17
18


19
20
21
22
23
24
25
26
27




28
29
30
31
32
33
34

10
11
12
13
14
15
16
17
18
19
20
21
22


23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44








+
+
+
+
+
+
-
-
+
+









+
+
+
+









	<title>Plugin Manager 2</title>

	<p>For updating or installing new plugins (extra channels or
	features), there's a user plugin manager. It's available as
	feature extension itself.</p>
	
	<steps>
	 <item><p>See the <key>F12</key> config dialog <key>🔌 Feature</key> section.</p></item>
	 <item><p>Enable the <key>⨯</key> Plugin Manager (listed near the end).</p></item>
	 <item><p>Restart streamtuner2 one last time for this change to take effect.</p></item>
	</steps>
	
	<p>Once acticated (after a restart) it brings up a new <key>📦
	Add</key> tab in the configuration window.</p>
	<p>Once acticated it brings up a new <key>📦 Add</key> tab
	in the configuration window.</p>
	
	<p><media type="image" src="img/pluginmanager2.png"
	mime="image/png">Install dialog for user plugins</media></p>
	
	<p>You can scan for available/new plugins there. And have them
	downloaded right away. New plugins are just downloaded, not
	implictly enabled. Reopen the config dialog to see them in the
	regular <key>📻 Channels</key> or <key>🔌 Feature</key> tabs, and
	then enable them.</p>
	
	<note><p>Updated plugins will not be automatically loaded if they
	were enable already. That requires either a restart, or disabling +
	saving once, then reenabling them.</p></note>
	
	<section id="configuration">
	<title>Configuration</title>
	<list>
	<item><p>Alternative download repositories may be configured. (Little
	practical value at the moment.)</p></item>
	<item><p>And you can let the plugin manager handle autoactivation
︙
50
51
52
53
54
55
56
57










58

60
61
62
63
64
65
66

67
68
69
70
71
72
73
74
75
76
77








-
+
+
+
+
+
+
+
+
+
+


	<p>Downloaded plugins are stored in <file>~/.config/streamtuner2/plugins</file>.
	To remove them, delete the individual *.py files there manually.</p>
	<note style="bug"><p>Currently system-installed core plugins take
	precedence over downloaded updates.</p>
	<p>And you'll have to take care to eventually refresh/delete outdated user plugins,
	whenever you install a newer Streamtuner2 version.</p></note>
	</section>

	
	<section>
	<subtitle>Disable user plugin loading</subtitle>
	<p>Since this is still rather experimental, you may disable all
	associated features by starting ST2 via:</p>
	<screen>streamtuner2 -d <input>pluginmanager2</input></screen>
	<p>That'll inhibit loading this extension plugin. (Also works
	with any other plugin id.)</p>
	</section>

</page>