Skip to content

DevMando/Naptrack

Repository files navigation

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

NuGet License: MIT .NET 10 Platform Made with

Grab audio and video from the web. Built originally to get lofi tracks offline for coding sessions.

Paste a link, pick MP3 or MP4, hit Download. That's it.

Naptrack Demo

Built with .NET 10 and RazorConsole.

Features

  • Download audio (MP3) or video (MP4) from YouTube, TikTok, Instagram, Facebook, and 1000+ sites
  • MP3/MP4 format toggle
  • Auto-downloads yt-dlp and ffmpeg on first run (no manual setup)
  • Native folder picker to change download location
  • Cross-platform: Windows, Linux, macOS
  • Keyboard-driven TUI with animated spinners

Installation

Option 1: .NET Tool (requires .NET 10 SDK)

dotnet tool install -g Naptrack

Then run from anywhere:

naptrack

Option 2: Standalone Binary (no dependencies)

Download the latest release for your platform from Releases. No .NET installation needed.

Or build it yourself:

# Windows
dotnet publish -r win-x64

# Linux
dotnet publish -r linux-x64

# macOS Intel
dotnet publish -r osx-x64

# macOS Apple Silicon
dotnet publish -r osx-arm64

The output is a single executable in bin/Release/net10.0/<runtime>/publish/.

Usage

  1. Launch naptrack
  2. Paste a URL (YouTube, TikTok, Instagram, Facebook, etc.)
  3. Select MP3 or MP4
  4. Press Enter or Tab to [ Download ] and press Enter
  5. File downloads to your configured folder

Keyboard Shortcuts

Key Action
Tab Navigate between elements
Enter Select / confirm
Esc Clear input and errors
Ctrl+V Paste (Windows)
Cmd+V Paste (macOS)
Ctrl+Shift+V Paste (Linux)

Configuration

  • Download folder: Click the folder path or use [ Change ] to open a folder picker
  • Settings are saved to:
    • Windows: %APPDATA%\Naptrack\config.json
    • Linux: ~/.config/Naptrack/config.json
    • macOS: ~/Library/Application Support/Naptrack/config.json

Dependencies

Naptrack automatically downloads these on first run if not found:

  • yt-dlp — media extraction from 1000+ sites
  • ffmpeg — audio/video format conversion

License

MIT

About

Grab audio and video from the web. A cross-platform TUI tool to download MP3/MP4 from YouTube, TikTok, Instagram, Facebook, and 1000+ sites.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors