npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

avpull

v0.4.1

Published

Download audio/video from YouTube, convert directly to your chosen format (mp3, wav, mp4, etc.)

Downloads

914

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

caya8205caya8205

Keywords

youtubedownloaderconverteraudiovideomp3mp4cliffmpegyoutubei

Readme

 █████╗  ██╗   ██╗ ██████╗  ██╗   ██╗ ██╗      ██╗     
██╔══██╗ ██║   ██║ ██╔══██╗ ██║   ██║ ██║      ██║     
███████║ ██║   ██║ ██████╔╝ ██║   ██║ ██║      ██║     
██╔══██║ ╚██╗ ██╔╝ ██╔═══╝  ██║   ██║ ██║      ██║     
██║  ██║  ╚████╔╝  ██║      ╚██████╔╝ ███████╗ ███████╗
╚═╝  ╚═╝   ╚═══╝   ╚═╝       ╚═════╝  ╚══════╝ ╚══════╝

npm Node.js Bun youtubei.js FFmpeg License

Download audio/video from YouTube and convert directly to your chosen format — mp3, wav, mp4, etc. No sketchy third-party downloader sites, no external binaries (yt-dlp, etc.), just Node.js.

Perfect for: soundboards, sound effects, BGM for editing, or saving video clips.

Quick Start

# Install globally
npm install -g avpull

# Download and convert
avpull "https://youtu.be/VIDEO_ID" -f mp3 -q 320

Installation

Option 1: One-line Install (Windows)

powershell -ExecutionPolicy Bypass -c "irm https://caya8205-2.github.io/avpull/install.ps1 | iex"

This downloads and installs from the latest GitHub Release.

Option 2: npm

npm install -g avpull

Option 3: Build from Source

git clone https://github.com/caya8205-2/avpull.git
cd avpull
bun install
bun run build

Requirements: Node.js 18+ • ffmpeg is bundled via ffmpeg-static

Usage

Basic Download

# Single URL, default mp3 192kbps, saved to ./avpull/
avpull "https://youtu.be/VIDEO_ID"

Custom Format & Quality

# Audio formats
avpull "https://youtu.be/VIDEO_ID" -f wav
avpull "https://youtu.be/VIDEO_ID" -f mp3 -q 320

# Video download
avpull "https://youtu.be/VIDEO_ID" -f mp4 -q 1080

Batch Download

# Multiple URLs at once
avpull url1 url2 url3 -f opus

# From a text file (one URL per line)
avpull -b urls.txt -f mp3

urls.txt example:

https://youtu.be/VIDEO_1
https://youtu.be/VIDEO_2
# lines starting with # are ignored

Custom Output

# Custom filename & output folder
avpull "https://youtu.be/VIDEO_ID" -n "my-song" -o ./downloads -f wav -q 320

Interactive Mode

# No arguments? Interactive prompts will guide you
avpull

Options

| Flag | Description | |---|---| | -f, --format <format> | Output format: mp3, wav, m4a, opus, flac, aac, ogg (audio) or mp4, webm, mkv (video). Default: mp3 | | -q, --quality <n> | Audio: bitrate in kbps (128, 192, 320, etc). Video: resolution (480, 720, 1080) or best. | | -o, --output <dir> | Output folder. Default: avpull | | -n, --name <name> | Custom filename (without extension). Only applies when using a single URL. | | -b, --batch <file> | Read URL list from a text file (one URL per line). | | -h, --help | Display help information. |

Technical Details

Architecture

  • YouTube API: Uses youtubei.js (not yt-dlp) — pure JavaScript, no external binary dependencies.
  • Media Processing: FFmpeg bundled via ffmpeg-static — no manual installation required.
  • Video Quality: Uses YouTube's progressive streams (video+audio combined), typically maxing out at 720p-1080p. For true 4K (requires muxing separate adaptive streams), let me know.
  • Audio Conversion: Fast remux (-c copy) when source codec is compatible; otherwise re-encodes.

Tech Stack

  • Runtime: Node.js 18+ / Bun 1.0+
  • CLI Framework: Commander.js
  • YouTube Client: youtubei.js
  • Media Processing: FFmpeg (bundled)
  • Colors: picocolors

Development

Local Setup (npm link)

cd avpull
npm install
npm link
avpull --help

Build Binary

bun run build
# Output: dist/avpull.exe (Windows)

Release Build

bun run release
# Builds binary + copies ffmpeg to dist/

License

MIT License — see LICENSE for details.