JSPM

tunex-cli

0.9.11
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 375
  • Score
    100M100P100Q72048F
  • License MIT

Cross-platform CLI for downloading YouTube/Spotify content and managing local media — audio extraction, metadata tagging, and intelligent file matching via LLM inference.

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (tunex-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    tunex

    CI npm version License: MIT

    Cross-platform CLI for downloading YouTube/Spotify content, extracting audio, and managing music metadata.

    Use

    Without install,

    bunx tunex-cli

    or global install which allows you to use shorter tunex command.

    bun install tunex-cli -g
tunex

    Overview

    tunex is a cross-platform CLI utility for downloading YouTube and Spotify content, converting video to audio, extracting MP3s from local media, and managing music metadata. Built with Bun and designed to run anywhere with Docker — no ffmpeg or yt-dlp installation required.

    Features

    • YouTube Downloads: Extract audio (MP3) or download video (MP4)
    • Local Audio Extraction: Extract audio from any local video file
    • Playlist Support: Process entire YouTube playlists automatically
    • Parallel Processing: Configurable thread count (up to 4)
    • Cross-Platform: Works on Windows, macOS, and Linux via Docker

    Quick Start

    Interactive Mode

    bunx tunex-cli

    Direct CLI Mode

    bunx tunex-cli run bulk-audio-extract -i "./videos" -o "./audio"

    Commands

    Command Description
    bulk-audio-extract Extract audio from local video files
    yt-audio-only Download YouTube audio as MP3
    yt-video-mp4 Download YouTube video as MP4

    Configuration

    bunx tunex-cli config

    Interactive tool to view and set defaults for output directory, thread count, and log file path. Settings are saved to ~/.tunex/config.json.

    Config Precedence

    1. CLI flags (passed at runtime)
    2. Environment variables (.env.local > .env)
    3. Config file (~/.tunex/config.json)
    4. Factory defaults

    Dot Env Overrides

    Create a .env file in the project root:

    DEFAULT_OUTPUT_DIR=./output
DEFAULT_THREADS=2
LOG_FILE=./tunex.log

    Roadmap

    • Spotify integration (track/album/playlist download)
    • Automatic metadata tagging (artist, album, title)
    • LLM-powered file matching and organization