pipe-viewer searches and plays YouTube videos from Linux, according to its project description.
YouTube-Viewer
Search and play YouTube videos on Linux using youtube-viewer, according to its project description.

About YouTube-Viewer
YouTube-Viewer is a lightweight application for searching and playing videos from YouTube. It ships with two interfaces: a command-line client (youtube-viewer) and a GTK+ client (gtk-youtube-viewer). It is packaged for a number of Linux distributions, including Alpine, Arch, Fedora, FreeBSD, Gentoo, Slackware, Solus, Ubuntu/Linux Mint and Void Linux, and can also be installed on macOS through Homebrew. Building from source uses Perl's Build.PL, with a --gtk option to include the graphical interface.
Playing videos depends on yt-dlp or youtube-dl, and other Perl modules are needed for features such as local caching, readline history, faster JSON handling and fixed-width formatting. Logging in is optional and configured through ~/.config/youtube-viewer/api.json, where users set a YouTube API key and, for login, OAuth client ID and secret values from a Google Cloud project with the YouTube Data v3 API enabled. The related fork pipe-viewer parses the YouTube website directly and does not require an API key.
Key features
- Command-line interface for searching and playing YouTube videos
- Separate GTK+ graphical interface, gtk-youtube-viewer
- Packaged for many Linux distributions and installable via Homebrew on macOS
- Optional API key and OAuth login configured in ~/.config/youtube-viewer/api.json
- Optional Perl modules enable local cache, readline history and faster JSON parsing
- Requires yt-dlp or youtube-dl to play videos
- Open source, with package builds listed for many Linux distributions and macOS Homebrew
- Offers both command-line and GTK+ interfaces from the same project
- Optional modules add caching, readline history, faster JSON and fixed-width formatting
- Video playback depends on yt-dlp or youtube-dl being installed
- Logging in requires a Google Cloud project with the YouTube Data v3 API enabled and OAuth client credentials
- Installing from source requires running Perl Build.PL steps
YouTube-Viewer at a glance
- Category
- Software & Utilities › Linux Apps
- Type
- Open-source project
- Pricing
- Not confirmed. Check the site
- Platforms
- Linux
- Open source
- Yes · Source code
- Language
- English
- Last checked
- Oct 6, 2026 · Online when checked
- Listed
- Oct 5, 2026
YouTube-Viewer alternatives
Tools and sites you could use instead, ranked by how closely they match.
ytermusic plays YouTube Music from a terminal interface, with a text-based user interface described by its project.
zx helps write scripts in JavaScript with shell-command support, according to its project page.
Macfetch displays system information on macOS as a Neofetch alternative written in Rust.
Wike brings Wikipedia search and article reading to the GNOME desktop through a dedicated reader application.
DidYouMean corrects spelling from the command line when users are unsure how a word is written.
Popular in Linux Apps
Well-known listings from the same topic.
YouTube-Viewer FAQ
Does YouTube-Viewer require a YouTube API key?
How is YouTube-Viewer installed?
What is needed to play videos?
Tell us and an editor will check it.
Claim the listing and suggest updates yourself. An editor checks every claim first.











