README 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
  1. pipe-viewer (search and stream videos from youtube)
  2. pipe-viewer is a lightweight application for searching and streaming
  3. videos from YouTube. pipe-viewer is a fork of youtube-viewer that
  4. does not require a Google API key. Usage and user interface are
  5. identical to youtube-viewer.
  6. For playing videos, this uses mplayer, vlc, or mpv. However, the
  7. mplayer that ships with Slackware has some issues with pipe-viewer
  8. (or actually with youtube: the audio stream cuts out randomly, and
  9. can be fixed by pressing the left arrow usually).
  10. Optional dependencies:
  11. vlc and/or mpv - for playing videos. highly recommended.
  12. perl-Gtk3, perl-File-ShareDir - for gtk-pipe-viewer.
  13. perl-lwp-useragent-cached - for local cache support.
  14. perl-JSON-XS - for faster JSON deserialization.
  15. perl-Text-CharWidth, perl-Unicode-LineBreak - for better formatting
  16. in the terminal.
  17. yt-dlp or youtube-dl [1] - if this is present, pipe-viewer will use it
  18. to detect available formats for the video.
  19. Counting optional ones, pipe-viewer has over 40 dependencies. To make
  20. life easier, there's a "pipe-viewer.sqf" queue file included with this
  21. build, which includes everything listed above (except mpv and vlc).
  22. This build always includes the command-line client (pipe-viewer). For
  23. the GTK client (gtk-pipe-viewer[3]), install perl-Gtk3 and
  24. perl-File-ShareDir before running this script. If you have them
  25. installed but don't want gtk-pipe-viewer, you can set GTK=no in the
  26. script's environment.
  27. Notes:
  28. [1] A small caveat about yt-dlp and youtube-dl: pipe-viewer works
  29. without them, though occasionally it'll choose a lower quality
  30. than is available for some videos. However, if yt-dlp or
  31. youtube-dl are present but outdated, pipe-viewer will fail to
  32. play videos at all! If you suspect this, remove yt-dlp and/or
  33. youtube-dl and try without them.
  34. [3] To force gtk-pipe-viewer to use your preferred terminal for
  35. downloading with wget and watching in a terminal, set
  36. TERMINAL in the script's environment (e.g. TERMINAL="xterm" or
  37. TERMINAL="urxvt").