Skip to main content

A terminal tool for browsing/streaming on

Project description


A simple terminal tool for browsing and watching streams on VLC Player using Livestreamer.


  • Python 3 (tested on version 3.4)
  • Livestreamer
  • VLC Player (sudo apt-get install vlc)


Using pip:

$ sudo pip3 install twitchy-term


Clone this repository:

$ git clone
$ cd twitchy-term
$ sudo python3 install


Simply run:

$ twitchy-term

It also takes an optional argument for streaming quality (default is best):

$ twitchy-term -q [quality]

Available qualities include:

  • best
  • high
  • medium
  • low
  • worst

Twitchy-Term offers the following pages of

  • Featured streams (from’s home page)
  • Browse top games (and top streams of each)
  • Search


/:Scroll up and down the current list of items
f:Featured streams
g:Top Games list
c:Change stream quality

In Top Games list

e:View top streams of current selected game

In pages where streams are listed

p:Play the selected stream in VLC player with current quality


Please see LICENSE.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

twitchy-term-1.0.1.tar.gz (7.8 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page