jp1995 / kappa-launcher

Twitch launcher using Rofi
MIT License
27 stars 4 forks source link

alt text Kappa Launcher

Kappa Launcher is a simple bash script that uses rofi to display and launch your followed Twitch streams.

output

Features

Installation

Install using make

# Clone the repo
$ git clone https://github.com/jp1995/kappa-launcher

# Change your current directory to kappa-launcher
$ cd kappa-launcher

# Install it
$ sudo make install

AUR package

For Arch based distros, an AUR package is available at

yay -S kappa-launcher-git

When updating, you may get an error like the local download is not a clone of ... this repo. Github deprecated the protocol previously used in the source URL of the PKGBUILD, and so it had to be updated. Just do a cleanbuild. It's a one time thing.

Instructions

The binary (executable) is named kpl.

On first launch the script creates a configuration file in .config/kpl. You must then edit this file with your Twitch OAuth token. If you wish, you can also change various other options here.

Once you have done this, simply run the script again.

Requirements:

Optionally, you'll also need chatterino or chatty for the chat client and xdg-utils for the browser function.

Problems / to do

Using streamlink to get the possible quality values is slow. Getting this from the twitch API would be a lot better. However, this is currently not possible.

Additional info

I am not an actual programmer. This code could likely be written in a more clean, concise way. I welcome suggestions and constructive criticism.

i3 users can edit the launcher function to include some layout solution to further automatize the process. For example:

i3-msg "workspace number 3" &&
exec layout_manager.sh TWITCH
streamlink twitch.tv/...