Livestreamer

Usage | Settings | Troubleshooting

Livestreamer is a commandline program that can be used to watch streams in a player like VLC Player. It has to be downloaded and installed seperately from Chatty.

Usage

You can open the Livestreamer dialog that Chatty provides via Extra - Livestreamer, where you can directly run Livestreamer and change some settings.

Each time you open a stream via the dialog or a context menu, a tab is added to the dialog where the output of the Livestreamer process is redirected to. If you open a stream with the same stream name and quality you already have open in a tab whose process isn't currently running, then that tab will be reused.

The tab of a stream is automatically closed when you close the Video Player opened by Livestreamer, if the dialog isn't currently open. Otherwise you have to close it yourself by using the Close-button on the top right, which turns into an End process-button as long as the process is still running. The Retry-button can be used to re-run the last command of that tab (for example when it couldn't find the stream, but you want to retry now because you know it's come online).

Settings

The settings can be changed in the Livestreamer dialog.

• Enable context menu entry: Adds Livestreamer to all context menus that can be used to open streams (like User Context Menu, Channel Context Menu or Live Streams Context Menu).
• Show dialog when opening stream: Automatically open the Livestreamer Dialog when you open a stream out of the context menu.
• Context menu qualities: You can customize which quality options appear in the context menu. The options you enter here are directly given as a parameter to Livestreamer, except Select which tells Chatty you want to select a quality in the dialog. Seperate qualities by space or comma. Add a | (vertical bar) to add a seperator to the menu.
  
  Examples:
  • Best, High, Worst | Select
  • Source High Medium Low Mobile | Select
• Base command or commandline options: This is used to construct the command to run Livestreamer and is basicially the part before the URL and the quality. This should point to the Livestreamer program itself, including any commandline options you always want to have included. The default is just livestreamer, which should usually be sufficient if the program is correctly included in the systems PATH variable (or similiar), but it may also include the full path to Livestreamer. Surround the path or any other parameter with quotes if it contains spaces (e.g. "C:\My Programs\Livestreamer\livestreamer.exe").
  
  Examples:
  • "C:\My Programs\Livestreamer\livestreamer.exe" --player "C:\Program Files\MPC-HC\mpc-hc64.exe" (specify full path to Livestreamer and use a different player)
  • /usr/local/bin/livestreamer (this might work on Linux/Mac if it can't find Livestreamer without the full path)
• Use Authorization (Twitch Oauth Token): Supplies to Twitch Access Token that is used for Chatty to Livestreamer to authenticate you when watching a stream via Livestreamer (probably only necessary to be able to watch sub-only streams).

Troubleshooting

If you get an error like Error: java.io.IOException: Cannot run program "<...>": CreateProcess error=2 [..], then Chatty probably can't find Livestreamer on your system.

To solve this, first make sure that you actually have Livestreamer installed. You need to install it on you own, it does not come bundled with Chatty. If you are sure it is installed (and you maybe can run it from the commandline just fine), you may have to tell Chatty the full path to the Livestreamer executable for it to work by entering it in the Base command or commandline options field. See the Settings section above for examples and help on that.