# CLI (command line interface)

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.

Open a terminal and call streamtuner2 help to get an overview over available commands.

## Examples

streamtuner2 play "station"

  This command looks through all channel plugins, and finds a station containing the mentioned title. In the shell you must put the station title in quotes, if it contains e.g. spaces. You can optionally specify a channelname before the station title.

streamtuner2 url [channel] "station"

  Just looks up the streaming URL for a given station. If no channel name is given, ST2 searches through all available channel plugins again.

streamtuner2 stream shoutcast "station"

  Prints available station data as JSON

streamtuner2 category internet_radio_org_uk "Pop"

  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.

streamtuner2 categories channel

  Fetches the current list of available categories/genres for a channel service.

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.