Install

curl -fsSL https://raw.githubusercontent.com/demirgitbuh/PacVideoDownloader/main/scripts/install.sh | bash

irm https://raw.githubusercontent.com/demirgitbuh/PacVideoDownloader/main/scripts/install.ps1 | iex

npm install -g pacvideodownloader

The npm package runs a postinstall step that downloads yt-dlp and ffmpeg into the package's own vendor/bin directory, so pacv can work even when those tools are not already on PATH.

PacVideoDownloader is a polished TypeScript terminal UI for yt-dlp, built for developers who want guided downloads without memorizing command flags. It installs as pacv and manages yt-dlp, ffmpeg, settings, history, and updates from a modern Ink interface.

Demo

+-------------------------------------+
|  PacVideoDownloader                 |
|  Minimal terminal video downloads   |
+-------------------------------------+

> * Download
  * History
  * Settings
  * Update
  * About
  * Quit

pacv https://example.com/video

> Format:    MP4 video
> Quality:   1080p
> Subtitles: None
> Output:    ~/Videos/PacVideo/%(title)s.%(ext)s

Downloading video
#############--------------- 42.0%

Features

• Dark monochrome Ink TUI with DemirArch AI orange accents.
• Guided video, audio, quality, subtitle, playlist, and confirmation flows.
• Direct URL mode with pacv <url>.
• Non-interactive update command with pacv update, backed by the npm latest release.
• Persistent settings at ~/.config/pacv/config.json on Unix and %APPDATA%\pacv\config.json on Windows.
• Download history with search, sorting, re-download, open-location, copy-url, and delete actions.
• Progress parsing from structured yt-dlp progress templates.
• Automatic dependency installation for Node.js, yt-dlp, and ffmpeg.

Screenshots

Screenshots and terminal GIFs will be added after the first tagged release.

Development

npm ci
npm run typecheck
npm run build
npm run dev

Run the built CLI:

node dist/cli.js
node dist/cli.js --version
node dist/cli.js update

For globally installed users, pacv update checks the npm registry and updates PacVideoDownloader with npm install -g pacvideodownloader@latest.

The project is ESM-only, TypeScript strict, and targets Node.js 20 or newer. Relative TypeScript imports use .js extensions so emitted files run directly under Node.

NPM Publishing

This repository is configured for both installer distribution and npm global installs. The npm package exposes the pacv command from dist/cli.js.

Check the package name:

npm view pacvideodownloader version

The package is configured with:

{
  "bin": {
    "pacv": "dist/cli.js"
  },
  "files": [
    "dist",
    "scripts/postinstall.cjs",
    "README.md",
    "LICENSE",
    "package.json"
  ],
  "scripts": {
    "build": "tsc",
    "dev": "tsx src/cli.tsx",
    "start": "node dist/cli.js",
    "typecheck": "tsc --noEmit",
    "postinstall": "node scripts/postinstall.cjs",
    "prepublishOnly": "npm run typecheck && npm run build"
  }
}

Publish:

npm login
npm whoami
npm ci
npm run typecheck
npm run build
npm pack --dry-run
npm publish --access public

If the version already exists on npm, bump package.json first:

npm version patch
npm publish --access public