diff options
Diffstat (limited to 'multimedia/straw-viewer/README')
-rw-r--r-- | multimedia/straw-viewer/README | 34 |
1 files changed, 21 insertions, 13 deletions
diff --git a/multimedia/straw-viewer/README b/multimedia/straw-viewer/README index b25df5614e..a4ba9509c0 100644 --- a/multimedia/straw-viewer/README +++ b/multimedia/straw-viewer/README @@ -1,7 +1,7 @@ straw-viewer (search and stream videos from youtube) straw-viewer is a lightweight application for searching and streaming -videos from YouTube, using the API of invidio.us. The project is in its +videos from YouTube, using the API of invidio.us[2]. The project is in its early development stages and some features are not implemented yet. straw-viewer is a fork of youtube-viewer that does not require a Google @@ -9,8 +9,9 @@ API key. Usage and user interface are identical to youtube-viewer. For playing videos, this uses mplayer, vlc, or mpv. However, the mplayer that ships with Slackware 14.2 has some issues with straw-viewer (or -actually with youtube: the audio stream cuts out randomly). Using vlc -or mpv is highly recommended. +actually with youtube: the audio stream cuts out randomly, and can be +fixed by pressing the left arrow usually). Using vlc or mpv is highly +recommended. Optional dependencies: @@ -27,17 +28,24 @@ Counting optional ones, straw-viewer has over 40 dependencies. To make life easier, there's a "straw-viewer.sqf" queue file included with this build, which includes everything listed above. -[1] A small caveat about youtube-dl: straw-viewer works without it, -though occasionally it'll choose a lower quality than is available -for some videos. However, if youtube-dl is present but outdated, -straw-viewer will fail to play videos at all! If you suspect this, -remove youtube-dl and try without it. - This build always includes the command-line client (straw-viewer). For the -GTK client (gtk-straw-viewer), install perl-Gtk3 and perl-File-ShareDir +GTK client (gtk-straw-viewer[3]), install perl-Gtk3 and perl-File-ShareDir before running this script. If you have them installed but don't want gtk-straw-viewer, you can set GTK=no in the script's environment. -To force gtk-straw-viewer to use your preferred terminal for downloading -with wget and watching in a terminal, set TERMINAL in the script's -environment (e.g. TERMINAL="xterm" or TERMINAL="urxvt"). +Notes: + +[1] A small caveat about youtube-dl: straw-viewer works without it, + though occasionally it'll choose a lower quality than is available + for some videos. However, if youtube-dl is present but outdated, + straw-viewer will fail to play videos at all! If you suspect this, + remove youtube-dl and try without it. + +[2] The default API host is https://invidio.us. If straw-viewer gives "Bad + gateway" or "Too many requests" errors, try changing the api_host in + ~/.config/straw-viewer/straw-viewer.conf or via the --api-host option. + A list of API hosts can be found at: https://instances.invidio.us/ + +[3] To force gtk-straw-viewer to use your preferred terminal for downloading + with wget and watching in a terminal, set TERMINAL in the script's + environment (e.g. TERMINAL="xterm" or TERMINAL="urxvt"). |