<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>CLI (command line interface)</title>
<link rel="stylesheet" type="text/css" href="C.css">
<script type="text/javascript" src="jquery.js"></script><script type="text/javascript" src="jquery.syntax.js"></script><script type="text/javascript" src="yelp.js"></script>
</head>
<body><div class="page" role="main">
<div class="header"><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#advanced" title="Advanced topics">Advanced topics</a> » </div></div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">CLI (command line interface)</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Streamtuner2 is a graphical tool. But it also has a limited commandline interface,
which can be used to query station information. This is useful for interfacing with
other applications.</p>
<p class="p">Open a terminal and call <span class="code">streamtuner2 help</span> to get an overview over
available commands.</p>
<div class="terms"><div class="inner">
<div class="title title-terms"><h2><span class="title">Examples</span></h2></div>
<div class="region"><dl class="terms">
<dt class="terms"><span class="code">streamtuner2 play "station"</span></dt>
<dd class="terms"><p class="p">This command looks through all channel plugins, and finds a station containing the
mentioned title. You must put the station title in quotes in shell calls, if it contains
e.g. spaces. You can optionally specify a channelname before the station title.</p></dd>
<dt class="terms"><span class="code">streamtuner2 url [channel] "station"</span></dt>
<dd class="terms"><p class="p">Just looks up the streaming URL for a given station. If no channel name is given,
ST2 searches through all available channel plugins again.</p></dd>
<dt class="terms"><span class="code">streamtuner2 stream shoutcast "station"</span></dt>
<dd class="terms"><p class="p">Prints available station data as JSON</p></dd>
<dt class="terms"><span class="code">streamtuner2 category internet_radio_org_uk "Pop"</span></dt>
<dd class="terms"><p class="p">Loads fresh data from the specified channel service, and prints out JSON data for
the whole category. Note that the category name must have the excact case.</p></dd>
<dt class="terms"><span class="code">streamtuner2 categories channel</span></dt>
<dd class="terms"><p class="p">Fetches the current list of available categories/genres for a channel service.</p></dd>
</dl></div>
</div></div>
<p class="p">Specifying a channel name is often optional. If you add one, it should be all-lowercase.
You can also give a list, like "shoutcast,xiph" which would be searched then.</p>
<p class="p">GUI mode: There are also --gtk3 and --gtk2 command line options. Usually the right toolkit
is picked depending on Python version. But you can manually override this.</p>
</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#advanced" title="Advanced topics">Advanced topics</a></li></ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>