Makes watching Twitch from Linux a bit less painful. Uses rofi to pick streamers from your followlist(or you just input a streamer name in rofi), which launches the stream in your favorite video player using streamlink.
NEWEST VLC VERSION(3.0.4-0) does NOT WORK WITH TWITCH, downgrade to 3.0.3 or set up a different default video playyer
A simple app to display Live channels through Rofi. My attempt at giving back to the open source community. Disclaimer: the app is not as cool as the name is.
VLC 3.0.4-0 should work again! :)
MACOS USERS REFER TO THE MACOS BRANCH. Brave users that trust I haven't pushed a completely broken script use test branch. Everyone else, stick to master.
You're welcome to open up an issue, or just ask me. It's safe to assume you know my Discord if you know Theatron. Make sure the issue is with Theatron. It is important to know that Theatron only takes care of the picking the streamer/video/quality. Everything after that is up to streamlink and your video player.
Here's a demo:
Currently all we have is a file. If you have streamlink + rofi, add a file called oauth in the project root folder. Run it with//whateve.
Let's assume you're using Arch Linux.
The easiest way to install the dependencies is:
sudo pacman -S streamlink rofi jq
After you're done installing or during(if you have bad internet),visit:
Get the oauth key and remove the oauth: bit in front of it.
Since this is still in early beta, we'll assume you installed using git.
- Visit your repository location
- Create a new file called
oauththis is the file name always. Put in your oauth key without the oauth: bit! This is very important if you want a follow list - run simplewatch`
- Hopefully, you did everything right, so it showed you a bunch of streamers you follow that are online, their viewers and their best possible quality! Look at ## Configuration for more
- Pick a streamer in your rofi menu using arrow keys,search bar + enter or clicking.
- Pick a quality(be careful, idly choosing 720p60 even if a streamer's maximum quality is 480p will not work. Ask streamlink. The safest is to use best/worst. That always works.
- Streamlink takes over.
- Tell me about bugs! This is a small, duo project and I appreciate any sort of bug reports, feature requests or even pull requests!
This script contains 2 main parts. A notification script(runs in the background and would only notify you when a streamer is coming online) and the simplewatch script. That is the script that shows you the streamers you are following that are currently online. Simplewatch needs its own config, while pollingservice can be edited once(in the script itself) and then run with a "once" positional parameter or a number that serves as the interval at which polling is executed.
sh pollingservice once
Runs the script once, and displays the notification
sh pollingservice 5
Runs the script and checks every 5 seconds about who's online. The positional argument value of 300 would mean 5 minutes of wait time between each check.
If you installed this through git, they have the example configs already. Make sure to edit them to your liking.
If you don't know how Rofi works:
Use arrows or type into the search bar. You can type in a string that is NOT ON THE LIST. This is very important. So let's say you don't even follow "Imaqtpie", but you know he's on at this time, and want to watch. Simply type :
Imaqtpie into the search bar and press enter. Hopefully streamlink will load up the video too.
-v
Outputs the version of the main script(notification script probably will not be updated a lot if at all, so it doesnt need versioning for now).
-p
This enters private mode. This will not query your followed streams, but will make you pick from a list of streamers, specified in your config. Use the notification service to know who's live. Adding separate functionality no the main script might make it a bit too bloated and hard to read.
sh streamlink -p
Should popout chat no matter what your config says.
The repo contains an example configuration. The comments should explain everything. Just like the oauth file this needs to be in the same directory as the script.
In case you ever change your default configuration, this is an example of it:
#dont ask for quality, always just run the best one, always worst might be implemented if anyone asks
always_best=false
#The default player used by streamlink with the latest breakage of VLC we can't rely on it anymore :(
player="mpv"
#if this is on, every time you pick a streamer, you will get vod menu after you pick a streamer, the first entry should still be the live stream
vod_mode=true
# How many vods(filtered by recency) to show
vod_mode_limit="25"
#if true, opens up a browser window with the chat popup mode of the picked streamer, does so not knowingly if the stream loaded or not
popup_chat=false
Notifications are a separate script, that can be used without the main Theatron application OR A LOGIN. The script simply checks for a select few streamers you specify inside the notifconf file and queries on a set interval(also specified by your config file)
If there is any type of request, I can add a way to check without a config file with login, but most people only have notifications for the very few streamers they watch, so my thought process was that it was way easier to type them in.
Make an issue if you want this implemented
Or I will implement it when I get bored.
Notifications script mostly only relies on jq and curl. After that it sends a "notify-send" that is then taken care of by a notification daemon.
Most of my users(me) are using some sort of hotkey daemon on a window manager. So you'd just trigger something like:
bindsym mod4+Shift+t bash ~/Documents/dev/Theatron/simplewatch on i3.
But if you want to launch it from a Terminal, this is how you'd go about it:
Add this to your ~/.zshrc or ~/.bashrc or wheverever you set PATH:
export PATH=$PATH:~/PATH/TO/THEATRON/scripts/
After that, make sure you have the necessary permissions to run the scripts. So chown and chmod it so it's owned by the user and executable by the user. I won't be going in depth on how to do this, since it's much better to go reading up on this on your own, you will be using this a lot.
Launch one of the scripts like:
simplewatch
The shebang will take care of it launching with bash.
Authentication for clipping capabilities is a bit more complicated. What you're going to need is a token that gives you editing clip privileges. But here is how you obtain the token(and put it into your oauth file):
If you already have an oauth file and have just decided you want clipping privileges, what you should do is: - delete your existing oauth - run simplewatch again
This bit applies to both your first time running the program and when you changed your mind about clips:
- running simplewatch opens up your browser, opening an authentication link
- log in, or if you weren't asked to log in and were redirected to the gitlab page, proceed to the next stage
- this is the tricky part, **COPY THE TOKEN VALUE FROM THE URL** (This might change if I get a website or something, bear with me)
TL;DR: https://gitlab.com/davidv171/Theatron#access_token=XXX&scope=clips%3Aedit&token_type=bearer
Put the XXX into your oauth file.
After that run clipit with bash. This should trigger your browser with the opened up clip editor. You should know the drill after that.
-
Extensibility, modularity, basically let the user decide on every part of the program
-
Usability without oauth! This will probably be implemented in python
-
Let user decide on output