<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<title>Special extra/mini buttons</title>
<link rel="stylesheet" type="text/css" href="C.css">
<script type="text/javascript" src="highlight.pack.js"></script><script>
document.addEventListener('DOMContentLoaded', function() {
var matches = document.querySelectorAll('code.syntax')
for (var i = 0; i < matches.length; i++) {
hljs.highlightBlock(matches[i]);
}
}, false);</script><script type="text/javascript" src="yelp.js"></script>
</head>
<body><main><div class="page">
<header><div class="inner pagewide"><div class="trails" role="navigation"><div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » </div></div></div></header><article><div class="hgroup pagewide"><h1 class="title"><span class="title">Special extra/mini buttons</span></h1></div>
<div class="region">
<div class="contents pagewide">
<p class="p">Using the specbuttons plugin, you can define additional
shortcuts. This is meant as convenience - allows to start
other audio apps or system controls from within streamtuner2.</p>
<p class="p"><span class="media"><span class="media media-image"><img src="img/specbuttons.png" class="media media-inline" alt=""></span></span></p>
<p class="p">The settings list can be found with the plugin options in the
<span class="key"><kbd>🔌 Features</kbd></span> tab. It follows the layout of the player/recording
configuration. Except that it lists icons and their according
action commands:</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<tr>
<td><p class="p"><span class="em">Icon</span></p></td>
<td style="border-left-style: solid;"><p class="p"><span class="em">Cmd</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="app">volume-up</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">amixer sset Master 2%+</span></p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="app">gtk-media-forward</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">vlc next</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="app">mixer</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">pavucontrol</span></p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="app">database</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">./myscript "%url" "%title"</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="app">./import.png</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">audacity %pls</span></p></td>
</tr>
</table></div></div></div>
</div>
<section id="gtk-icons"><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">gtk-icons</span></h2></div>
<div class="region"><div class="contents pagewide"><p class="p">Note that the icon name can also be that of a Gtk-builtin icon. Their
names always start with "<span class="app">gtk-</span>" - for example "<span class="app">gtk-cancel</span>". You can
find a list of all available builtins under
<span class="link"><a href="http://www.pygtk.org/pygtk2reference/gtk-stock-items.html" title="http://www.pygtk.org/pygtk2reference/gtk-stock-items.html">http://www.pygtk.org/pygtk2reference/gtk-stock-items.html</a></span>.
They usually match your Gtk theme though.</p></div></div>
</div></section><section id="png-icons"><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">PNG icons</span></h2></div>
<div class="region"><div class="contents pagewide">
<p class="p">In case you enter something like "<span class="app">player</span>", the icon name will be
searched for and expanded to an absolute PNG filename. For example
"<span class="file">totem</span>" might become <span class="file">/usr/share/icons/HighContrast/16x16/apps/totem.png</span>.</p>
<p class="p">This won't always yield the exact icon / theme / or size you wanted. So it's
sometimes necessary to look up the complete path yourself.
So you might want search them manually <span class="cmd">locate /usr/shar/icons |
grep "volume"</span> to pick out a more fitting icon.</p>
<p class="p">You can also use png files located in your homedir or else.</p>
</div></div>
</div></section><section id="placeholders"><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">Commands</span></h2></div>
<div class="region"><div class="contents pagewide">
<p class="p">You can define any graphical or commandline application to be
invoked by your custom toolbar button. Foremost you want to invoke
audio controls of course, or start/stop players.</p>
<p class="p">For example <span class="cmd">amixer sset Master 1dB+</span> is likely to work
for all current distributions.</p>
<p class="p"><span class="link"><a href="config_apps.html#placeholders" title="URL placeholders">Placeholders</a></span>
like %title and %url or %pls and %m3u are supported for all commands
as well. So you can have additional play/record shortcuts.</p>
</div></div>
</div></section><section id="icon-rows"><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">icon rows</span></h2></div>
<div class="region"><div class="contents pagewide">
<p class="p">With the "number of rows" setting, more buttons can be packed together.
It looks okay with up to 3 rows - when using the large sized main toolbar.
The defined icon shortcuts will always be packed column-wise.</p>
<div class="note note-bug" title="Bug">
<svg width="24" height="24" version="1.1">
<path class="yelp-svg-fill" d="m7 8v7h0.0078a5 6.3027 0 0 0 3.9922 5.867v-6.867h2v6.871a5 6.3027 0 0 0 3.988-5.871h0.012v-7h-10z"></path>
<path class="yelp-svg-fill" d="m12 3a4 4 0 0 0-4 4h8a4 4 0 0 0-4-4z"></path>
<path class="yelp-svg-fill" d="m16 12h6v1h-6z"></path>
<path class="yelp-svg-fill" transform="rotate(-30)" d="m9.2045 16.361h6v1h-6z"></path>
<path class="yelp-svg-fill" transform="rotate(30)" d="m21.704 4.2894h6v1h-6z"></path>
<path class="yelp-svg-fill" d="m2 12h6v1h-6z"></path>
<path class="yelp-svg-fill" transform="rotate(30)" d="m5.5801 4.3612h6v1h-6z"></path>
<path class="yelp-svg-fill" transform="rotate(-30)" d="m-6.9199 16.289h6v1h-6z"></path>
</svg><div class="inner"><div class="region"><div class="contents"><p class="p">The icon list isn't ordered. So you cannot
define which button appears first. (Albeit the plugin config
definition can be changed from 'dict' to 'table' now, and the plugin
required just a little editing then.)</p></div></div></div>
</div>
</div></div>
</div></section><section class="links" role="navigation"><div class="inner">
<div class="hgroup pagewide"></div>
<div class="contents pagewide"><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>
</div></section>
</div>
<div class="clear"></div></article><footer><div class="inner pagewide"></div></footer>
</div></main></body>
</html>