# Install yewtube with Homebrew, MacPorts, Nix, apt Terminal based YouTube player and downloader. Version 2.13.1 via Homebrew; verified 2026-06-17. ## Install ```sh sudo av install brew:yewtube ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install yewtube ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install yewtube ``` Evidence: MacPorts ports tree: net/yewtube/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Nix (92%): ```sh nix profile install nixpkgs#yewtube ``` Evidence: nixpkgs package indexes: pkgs/by-name/ye/yewtube/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Debian apt (92%): ```sh sudo apt install python3-yt ``` Evidence: Debian stable package indexes: python3-yt from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz ## Package facts - **Package key:** brew:yewtube - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2.13.1 - **Source summary:** Terminal based YouTube player and downloader - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-or-later - **Source archive:** - **Last updated:** 2026-06-17T14:44:17Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - yt (cli) - yt (alias) ## Dependencies - certifi - ffmpeg - mplayer - python@3.14 ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 2.13.1 - Package-manager updated: 2026-06-17 - Local data: ok - Upstream repository: https://github.com/mps-youtube/yewtube - info: No cached GitHub release or tag data was available. ## Project history and usage yewtube is the maintained terminal YouTube player and downloader descended from mps-youtube. The current README describes it as a fork of mps-youtube that runs as the yt command and no longer requires a YouTube API key. ### Project history The underlying repository lineage dates to February 2014, when mps-youtube was published as a terminal interface for searching, streaming, and downloading YouTube media. The yewtube README explicitly preserves that ancestry: yewtube is based on mps-youtube, and mps-youtube was based on the older mps terminal music program. The fork's public change log shows yewtube releases beginning with the inherited v0.2.x line in 2014 and continuing through a revived 2.x series. The 2022 releases are especially visible as the fork removed the old API-key workflow, restored download and playlist behavior, added mpris extras, and updated its playback/downloader plumbing. ### Adoption history yewtube's adoption is tied to command-line users who wanted a YouTube client that could search, queue, stream, download, and manage playlists without opening a browser. The GitHub project has thousands of stars and hundreds of forks, and the README documents installation through pip, pipx, and direct GitHub installs. The tool stayed relevant by tracking the unstable YouTube ecosystem through yt-dlp updates and compatibility fixes. Later releases in 2023-2026 include downloader bumps and maintenance fixes, which is exactly the kind of churn expected for a terminal video client. ### How it is used Users install yewtube with pip or pipx and run it as yt. Inside the terminal UI, slash-prefixed searches, playlist searches, local playlist saves, media downloads, comment browsing, and album matching are documented in the README. Playback depends on external players such as mpv, mplayer, or VLC. The README also documents optional mpv input binding integration, mpris support, and the inherited mps-youtube configuration directory at ~/.config/mps-youtube. ### Why package nerds care yewtube is a classic package-nerd artifact: a high-level terminal app whose usefulness depends on keeping a fast-moving web service usable from a stable local command. It also illustrates how package ecosystems preserve abandoned CLI workflows through forks, renamed packages, and compatibility releases. For media packages, yewtube sits between a downloader such as yt-dlp and a player such as mpv: it is the interactive TUI layer that lets users search, queue, and play from the shell. ### Timeline - 2014-02: mps-youtube repository created. - 2014-11: v0.2.x release line appears in the project change log. - 2022-03: v2.8.1 documents removal of API-key instructions and fixes around playlists, search, and playback. - 2023-08: v2.10.5 bumps yt-dlp. - 2026-03: v2.13.1 published on GitHub. ### Related projects - mps-youtube: direct predecessor and code lineage. - mps: older terminal music-search program that inspired mps-youtube. - yt-dlp: downloader backend tracked in yewtube maintenance releases. - mpv, mplayer, and VLC: external players used by yewtube. ### Sources - - - - ## Security Notes No matching local secret-handling manifest was found for yewtube. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.config/mps-youtube ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** yewtube - **Version Scheme:** 0 - **Revision:** 3 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - yewtube: normalized package name match | nixpkgs package indexes: pkgs/by-name/ye/yewtube/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - MacPorts - yewtube: normalized package name match | MacPorts ports tree: net/yewtube/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Debian apt - python3-yt - 4.4.0-2+b1: installed executable or alias match | Debian stable package indexes: python3-yt from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Framework for analyzing and visualizing simulation data (Python 3) | https://yt-project.org/ - Ubuntu apt - python3-yt - 4.3.0-1build1: installed executable or alias match | Ubuntu 24.04 LTS package indexes: python3-yt from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Framework for analyzing and visualizing simulation data (Python 3) | https://yt-project.org/ ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Media and graphics packages](https://www.automicvault.com/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata. - [ffmpeg](https://www.automicvault.com/pkg/brew/ffmpeg/) - Runtime dependency declared by Homebrew. - [mplayer](https://www.automicvault.com/pkg/brew/mplayer/) - Runtime dependency declared by Homebrew. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [movgrab](https://www.automicvault.com/pkg/brew/movgrab/) - Shares av.db curated category or tags: cli, media, video, video-downloader, youtube. - [mplayershell](https://www.automicvault.com/pkg/brew/mplayershell/) - Shares av.db curated category or tags: cli, media, media-player, video. - [nicovideo-dl](https://www.automicvault.com/pkg/brew/nicovideo-dl/) - Shares av.db curated category or tags: cli, media, video, video-downloader. - [streamlink](https://www.automicvault.com/pkg/brew/streamlink/) - Shares av.db curated category or tags: cli, media, media-player, video. - [svtplay-dl](https://www.automicvault.com/pkg/brew/svtplay-dl/) - Shares av.db curated category or tags: cli, media, video, video-downloader. - [ykdl](https://www.automicvault.com/pkg/brew/ykdl/) - Shares av.db curated category or tags: cli, media, video, video-downloader. - [yle-dl](https://www.automicvault.com/pkg/brew/yle-dl/) - Shares av.db curated category or tags: cli, media, video, video-downloader. - [animdl](https://www.automicvault.com/pkg/brew/animdl/) - Shares av.db curated category or tags: cli, media, video. ## Combined YAML source View the package source record on GitHub. [combined/yewtube.yml](https://github.com/automic-vault/db/blob/main/combined/yewtube.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph