Skip to content

Scripts to view and open twitch streams from the command line

License

Notifications You must be signed in to change notification settings

rahulsalvi/twitcher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 

Repository files navigation

twitcher

Scripts to view and open Twitch.tv livestreams from the command line

Getting Started

Prerequisities

  • python 3
  • a valid Twitch.tv OAUTH token
  • Livestreamer command line utility
  • FZF (optional, for zsh plugin)

Installing

  1. Clone the repository:

    git clone https://github.com/rahulsalvi/twitcher.git "${TWITCHER_DIR:-$HOME}/.twitcher"
    
  2. Create an environment variable TWITCH_TOKEN with a Twitch.tv OAUTH token:

    export TWITCH_TOKEN=<your token>
    
  3. Add the following line to your .zshrc:

    [ -f "${TWITCHER_DIR:-$HOME}/.twitcher/twitcher.zsh" ] && source "${TWITCHER_DIR:-$HOME}/.twitcher/twitcher.zsh"
    

Usage

Use the keybind Alt-t to open an FZF window with your followed streams. Selecting a stream (or many) will open them using the Livestreamer utility

Configuration

There are several environment variables that control how twitcher behaves

TWITCHER_DIR - Set this to the location to where you cloned the project

TWITCH_TOKEN - The OAUTH token to use. Since this is linked to a Twitch.tv account, multiple can be used if desired

FZF_TWITCHER_OPTS - The options passed to FZF when opening twitcher

Notes

A Twitch.tv OAUTH token can be generated by registering your own Twitch.tv application or with this tool

Authors

License

This project is licensed under the MIT License - see the LICENSE file for details

Acknowledgments

About

Scripts to view and open twitch streams from the command line

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published