{"_id":"@callmehutchingd/yt-downloader","_rev":"2-3ba6b8f21070c4df7fc630c7ef3f9c6e","name":"@callmehutchingd/yt-downloader","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@callmehutchingd/yt-downloader","version":"1.0.0","keywords":["youtube","downloader","mp3","mp4","audio","video","cli","youtube-downloader","yt-downloader","youtube-to-mp3","youtube-to-mp4","ffmpeg"],"author":{"url":"https://github.com/callmehutchingd","name":"Jonell Magallanes","email":"callmehutchingd@users.noreply.github.com"},"license":"MIT","_id":"@callmehutchingd/yt-downloader@1.0.0","maintainers":[{"name":"callmehutchingd","email":"jonellhutchinmagallanes@gmail.com"}],"homepage":"https://github.com/callmehutchingd/yt-downloader#readme","bugs":{"url":"https://github.com/callmehutchingd/yt-downloader/issues"},"bin":{"yt":"index.js","yt-downloader":"index.js"},"dist":{"shasum":"55dbb295b318a655ce7cc4b141df7700cf45549e","tarball":"https://registry.npmjs.org/@callmehutchingd/yt-downloader/-/yt-downloader-1.0.0.tgz","fileCount":3,"integrity":"sha512-DuziELj4Z7U45VyY4zY5lLsi6ZhmsGaKMzZILraw+/8NHTdBqCiUQgK3WL6Pfk6S9pHwzxR9Xj4cxGN1Q8fJ7w==","signatures":[{"sig":"MEQCIHwwnhVci8HK/SUhOEb66EPUly45yUrS43w6n44Kj649AiAIV0n0uHKzXgae59RI+E19bB28h1/eRmrNWap7z1TWVQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":40544},"main":"index.js","engines":{"node":">=14.0.0"},"scripts":{"postinstall":"echo 'YouTube Downloader CLI installed successfully! Run \"yt --help\" to get started.'","prepublishOnly":"echo 'Preparing to publish...'"},"_npmUser":{"name":"callmehutchingd","email":"jonellhutchinmagallanes@gmail.com"},"repository":{"url":"git+https://github.com/callmehutchingd/yt-downloader.git","type":"git"},"_npmVersion":"11.12.0","description":"A powerful YouTube video and audio downloader CLI with metadata extraction and conversion support","directories":{},"_nodeVersion":"20.20.2","dependencies":{"axios":"^1.6.0","chalk":"^4.1.2","commander":"^11.1.0","cli-progress":"^3.12.0","fluent-ffmpeg":"^2.1.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/yt-downloader_1.0.0_1781329827609_0.08746043555876892","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@callmehutchingd/yt-downloader","version":"1.0.1","description":"A powerful YouTube video and audio downloader CLI with metadata extraction and conversion support","main":"index.js","bin":{"yt":"index.js","yt-downloader":"index.js"},"scripts":{"prepublishOnly":"echo 'Preparing to publish...'","postinstall":"echo 'YouTube Downloader CLI installed successfully! Run \"yt --help\" to get started.'"},"keywords":["youtube","downloader","mp3","mp4","audio","video","cli","youtube-downloader","yt-downloader","youtube-to-mp3","youtube-to-mp4","ffmpeg"],"author":{"name":"Jonell Magallanes","email":"callmehutchingd@users.noreply.github.com","url":"https://github.com/callmehutchingd"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/callmehutchingd/yt-downloader.git"},"bugs":{"url":"https://github.com/callmehutchingd/yt-downloader/issues"},"homepage":"https://github.com/callmehutchingd/yt-downloader#readme","dependencies":{"axios":"^1.6.0","chalk":"^4.1.2","cli-progress":"^3.12.0","commander":"^11.1.0","fluent-ffmpeg":"^2.1.2"},"engines":{"node":">=14.0.0"},"publishConfig":{"access":"public"},"_id":"@callmehutchingd/yt-downloader@1.0.1","_nodeVersion":"20.20.2","_npmVersion":"11.12.0","dist":{"integrity":"sha512-HNOnjT6VIeVsCRkn2DladzgIu2L1zaErfba9/OACJpQanwDLTVDwhKgsbqnvYNSoSA392UgspDe4z2w76fw0ug==","shasum":"f487b6d5ba080f52f3effcd447191569b8e58c5c","tarball":"https://registry.npmjs.org/@callmehutchingd/yt-downloader/-/yt-downloader-1.0.1.tgz","fileCount":3,"unpackedSize":40562,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHRKXmzIAtODIdQpqTKbkC1B40oyr2AHJcHyRmxlRK0VAiBn9rp+tLlu/mBBaP8MRkTx0mWdxujLB+fEzjtJlnXnRg=="}]},"_npmUser":{"name":"callmehutchingd","email":"jonellhutchinmagallanes@gmail.com"},"directories":{},"maintainers":[{"name":"callmehutchingd","email":"jonellhutchinmagallanes@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/yt-downloader_1.0.1_1781330061993_0.27440551081072906"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-13T05:50:27.410Z","modified":"2026-06-13T05:54:22.255Z","1.0.0":"2026-06-13T05:50:27.772Z","1.0.1":"2026-06-13T05:54:22.148Z"},"bugs":{"url":"https://github.com/callmehutchingd/yt-downloader/issues"},"author":{"name":"Jonell Magallanes","email":"callmehutchingd@users.noreply.github.com","url":"https://github.com/callmehutchingd"},"license":"MIT","homepage":"https://github.com/callmehutchingd/yt-downloader#readme","keywords":["youtube","downloader","mp3","mp4","audio","video","cli","youtube-downloader","yt-downloader","youtube-to-mp3","youtube-to-mp4","ffmpeg"],"repository":{"type":"git","url":"git+https://github.com/callmehutchingd/yt-downloader.git"},"description":"A powerful YouTube video and audio downloader CLI with metadata extraction and conversion support","maintainers":[{"name":"callmehutchingd","email":"jonellhutchinmagallanes@gmail.com"}],"readme":"# 🎵 YouTube Downloader CLI\n\nA powerful command-line tool for downloading YouTube videos and audio with high quality, metadata extraction, and conversion support.\n\n[![npm version](https://badge.fury.io/js/%40hutchingd%2Fyt-downloader.svg)](https://www.npmjs.com/package/@hutchingd/yt-downloader)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node.js Version](https://img.shields.io/badge/node-%3E%3D14.0.0-brightgreen)](https://nodejs.org)\n\n## 📋 Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n- [Quick Start](#quick-start)\n- [Commands](#commands)\n- [Options](#options)\n- [Usage Examples](#usage-examples)\n- [Output Examples](#output-examples)\n- [Requirements](#requirements)\n- [Troubleshooting](#troubleshooting)\n- [Developer](#developer)\n- [License](#license)\n\n## ✨ Features\n\n- 🎵 Download MP3 audio with best quality\n- 🎬 Download MP4 video in highest available quality\n- 🔄 Convert audio to MP3 format using FFmpeg\n- 📊 Real-time progress bars with download speed\n- 📝 Accurate duration metadata extraction\n- 🎨 Professional CLI interface with box design\n- 🔗 Raw URL mode for direct download links\n- 📸 Thumbnail and artist metadata extraction\n- 💾 Custom save directory support\n- ⚡ Fast and efficient downloading\n\n## 📦 Installation\n\n### Global Installation (Recommended)\n\n```bash\nnpm install -g @callmehutchingd/yt-downloader\n```\n\nAfter installation, you can use the yt command anywhere:\n\n```bash\nyt --help\n```\n\nRun without Installation\n\nUsing npx (no installation required):\n\n```bash\nnpx @callmehutchingd/yt-downloader download -u \"YOUTUBE_URL\"\n```\n\nLocal Installation\n\nFor project-specific usage:\n\n```bash\nnpm install @callmehutchingd/yt-downloader\n```\n\nThen use in your project:\n\n```bash\nnpx yt download -u \"YOUTUBE_URL\"\n```\n\n🚀 Quick Start\n\nDownload your first YouTube video as MP3:\n\n```bash\nyt download -u \"https://www.youtube.com/watch?v=YOUR_VIDEO_ID\"\n```\n\nDownload as MP4 video:\n\n```bash\nyt download -u \"https://www.youtube.com/watch?v=YOUR_VIDEO_ID\" -t mp4\n```\n\nGet just the download URL without downloading:\n\n```bash\nyt download -u \"https://www.youtube.com/watch?v=YOUR_VIDEO_ID\" --raw=true\n```\n\n📖 Commands\n\nCommand Description Aliases\ndownload Download YouTube video or audio dl, get\nstatus Check current status and configuration st\nabout Show information about the application info\nhelp Display help information --help, -h\n\n⚙️ Options\n\nDownload Command Options\n\nOption Type Description Default Required\n-u, --url <url> string YouTube URL - Yes\n-t, --type <type> string Download type: mp3 or mp4 mp3 No\n-c, --convert <boolean> boolean Convert to MP3 (only for mp3 type) false No\n-s, --save <path> string Save directory path Current directory No\n--raw <boolean> boolean Return raw download URL without downloading false No\n\nGlobal Options\n\nOption Description\n-V, --version Output the version number\n-h, --help Display help for any command\n\n📝 Usage Examples\n\nBasic Audio Download\n\nDownload as MP3 (default):\n\n```bash\nyt download -u \"https://youtube.com/watch?v=SVIKVwvKyTk\"\n```\n\nDownload and Convert to MP3\n\nDownload audio and convert to MP3 format:\n\n```bash\nyt download -u \"https://youtube.com/watch?v=SVIKVwvKyTk\" -t mp3 -c true\n```\n\nDownload Video\n\nDownload as MP4 video in best quality:\n\n```bash\nyt download -u \"https://youtube.com/watch?v=SVIKVwvKyTk\" -t mp4\n```\n\nSave to Specific Directory\n\nDownload to custom location:\n\n```bash\nyt download -u \"https://youtube.com/watch?v=SVIKVwvKyTk\" -s ~/Music/Downloads\n```\n\n```bash\nyt download -u \"https://youtube.com/watch?v=SVIKVwvKyTk\" -t mp4 -s /home/user/Videos\n```\n\nGet Raw Download URL\n\nGet direct download link without downloading the file:\n\n```bash\nyt download -u \"https://youtube.com/watch?v=SVIKVwvKyTk\" --raw=true\n```\n\nFor MP4 raw URL:\n\n```bash\nyt download -u \"https://youtube.com/watch?v=SVIKVwvKyTk\" -t mp4 --raw=true\n```\n\nCombine Multiple Options\n\nDownload MP3, convert to MP3, and save to specific directory:\n\n```bash\nyt download -u \"https://youtube.com/watch?v=SVIKVwvKyTk\" -t mp3 -c true -s ./Downloads\n```\n\nSystem Commands\n\nCheck system status:\n\n```bash\nyt status\n```\n\nView about information:\n\n```bash\nyt about\n```\n\nDisplay help:\n\n```bash\nyt help\n```\n\n📊 Output Examples\n\nSuccessful Download Output\n\n```\n┌────────────────────────────────────────────────────────────┐\n│                     DOWNLOAD SUCCESS                       │\n├────────────────────────────────────────────────────────────┤\n│ Title: Mode Pesawat | Senam Kreasi untuk Anak Sekolah     │\n│ Artist: Genix Gabriel Official                             │\n│ Duration: 3:48                                             │\n│ Thumbnail: https://i.ytimg.com/vi/.../maxresdefault.jpg   │\n│ Size: 3.52 MB (3601.58 KB)                                 │\n│ Type: MP3                                                  │\n│ Location: /home/user/Mode_Pesawat.mp3                      │\n└────────────────────────────────────────────────────────────┘\n┌────────────────────────────────────────────────────────────┐\n│                                                            │\n│                  Developer: Jonell Magallanes              │\n│                                                            │\n└────────────────────────────────────────────────────────────┘\n```\n\nRaw URL Output\n\n```\n┌────────────────────────────────────────────────────────────┐\n│                     RAW DOWNLOAD URL                       │\n├────────────────────────────────────────────────────────────┤\n│ Title: Mode Pesawat | Senam Kreasi untuk Anak Sekolah     │\n│ Artist: Genix Gabriel Official                             │\n│ Duration: 3:48                                             │\n│ Download URL: https://example.com/download.mp4             │\n│ Format: m4a                                                │\n│ Type: MP3                                                  │\n└────────────────────────────────────────────────────────────┘\n```\n\nStatus Output\n\n```\n┌────────────────────────────────────────────────────────────┐\n│                      SYSTEM STATUS                         │\n├────────────────────────────────────────────────────────────┤\n│ YouTube Downloader CLI                                     │\n│ Version: 1.0.0                                             │\n│ Status: Online & Ready                                     │\n│                                                            │\n│ Save Directory: /home/user                                 │\n│ Supported Formats: MP3, MP4                                │\n│ Conversion Support: Yes (MP3)                              │\n│ Raw URL Mode: Available                                    │\n│                                                            │\n│ Features:                                                  │\n│    - High quality audio/video                              │\n│    - Progress bars with speed                              │\n│    - Metadata extraction                                   │\n│    - Batch download ready                                  │\n│    - FFmpeg integration                                    │\n└────────────────────────────────────────────────────────────┘\n```\n\n🔧 Requirements\n\nSystem Requirements\n\n· Node.js: Version 14.0.0 or higher\n· FFmpeg: Required for audio conversion\n· Disk Space: Minimum 100MB free space\n· RAM: 512MB minimum (1GB recommended)\n· Network: Stable internet connection\n\nInstalling FFmpeg\n\nUbuntu/Debian\n\n```bash\nsudo apt update\nsudo apt install ffmpeg\n```\n\nmacOS\n\n```bash\nbrew install ffmpeg\n```\n\nWindows\n\n1. Download from ffmpeg.org\n2. Extract to C:\\ffmpeg\n3. Add C:\\ffmpeg\\bin to system PATH\n4. Verify installation:\n\n```cmd\nffmpeg -version\n```\n\nCentOS/RHEL/Fedora\n\n```bash\nsudo yum install ffmpeg\n```\n\nAlpine Linux\n\n```bash\napk add ffmpeg\n```\n\n🛠️ Troubleshooting\n\nCommon Issues and Solutions\n\nIssue: \"FFmpeg not found\"\n\nSolution: Install FFmpeg on your system (see installation instructions above)\n\nIssue: \"Failed to get video metadata\"\n\nSolution:\n\n· Check your internet connection\n· Verify the YouTube URL is correct\n· Try again after a few minutes\n\nIssue: \"Permission denied\"\n\nSolution:\n\n· Use sudo for global installation\n· Or install locally without -g flag\n\nIssue: \"Download speed too slow\"\n\nSolution:\n\n· Check your internet connection\n· Try downloading at off-peak hours\n· Use --raw=true to get direct URL and use a download manager\n\nIssue: \"API Response: Not found\"\n\nSolution:\n\n· The video might be private or deleted\n· Try a different YouTube URL\n· Check if the video is available in your region\n\nIssue: \"Error: ENOENT\"\n\nSolution:\n\n· Ensure the save directory exists or create it\n· Check write permissions for the directory\n\nGetting Help\n\nIf you encounter any issues:\n\n1. Check the GitHub Issues page\n2. Run yt status to check system configuration\n3. Verify FFmpeg installation with ffmpeg -version\n4. Create a new issue with:\n   · Error message\n   · Command used\n   · System information (OS, Node.js version)\n   · Steps to reproduce\n\n📚 API Reference\n\nCommand Line Interface\n\nThe CLI uses commander.js for argument parsing. All commands support:\n\n· Short flags (e.g., -u)\n· Long flags (e.g., --url)\n· Boolean flags (e.g., --raw, -c)\n· Value parameters (e.g., -s ./path)\n\nExit Codes\n\nCode Meaning\n0 Success\n1 General error\n2 Missing required options\n3 Network/API error\n4 File system error\n\n🔒 Privacy & Security\n\n· No user data is collected or stored\n· All downloads are direct from YouTube servers\n· API endpoints are only used for metadata extraction\n· No logging or tracking of download history\n\n🤝 Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. Fork the repository\n2. Create a feature branch (git checkout -b feature/AmazingFeature)\n3. Commit your changes (git commit -m 'Add some AmazingFeature')\n4. Push to the branch (git push origin feature/AmazingFeature)\n5. Open a Pull Request\n\nDevelopment Setup\n\n```bash\ngit clone https://github.com/hutchingd/yt-downloader.git\ncd yt-downloader\nnpm install\nnpm link\nyt --help\n```\n\n📝 Changelog\n\nVersion 1.0.0 (2026-01-15)\n\n· Initial release\n· MP3 and MP4 download support\n· FFmpeg conversion support\n· Raw URL mode\n· Professional CLI interface with box design\n· Metadata extraction (title, artist, duration, thumbnail)\n· Real-time progress bars with speed indicator\n· Status and about commands\n· Comprehensive documentation\n\n👨‍💻 Developer\n\nJonell Hutchin Magallanes \n\n\n📄 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n```\nMIT License\n\nCopyright (c) 2026 Jonell Magallanes (hutchingd)\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions...\n\nFull license text in LICENSE file.\n```\n\n⭐ Support\n\nIf you find this tool useful, please:\n\n· Star the repository on GitHub\n· Share with others\n· Report issues and suggest features\n· Contribute to the codebase\n\n---\n\nMade with ❤️ by Jonell Magallanes\n\nFor more information, visit: https://github.com/hutchingd/yt-downloader","readmeFilename":"README.md"}