diff options
Diffstat (limited to 'multimedia/straw-viewer/README')
| -rw-r--r-- | multimedia/straw-viewer/README | 46 |
1 files changed, 29 insertions, 17 deletions
diff --git a/multimedia/straw-viewer/README b/multimedia/straw-viewer/README index b25df5614e..aff15dfd6e 100644 --- a/multimedia/straw-viewer/README +++ b/multimedia/straw-viewer/README @@ -1,16 +1,18 @@ 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 -early development stages and some features are not implemented yet. +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 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 +29,27 @@ 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. +This build always includes the command-line client (straw-viewer). For +the 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. + +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. - -This build always includes the command-line client (straw-viewer). For the -GTK client (gtk-straw-viewer), 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"). + 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 http://invidious.snopyta.org. If you get + "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"). |