Terminal-based YouTube video/audio downloader using yt-dlp and ffmpeg
Project description
YTConverter™
Preface (optional): A subtle reflection before diving into the technical details, feel free to skip to main content.
| ❓ Born from silent hands, shaping what they cannot fully feel. |
| ❓ Weighted and left alone, with no hand to guide through the quiet. |
| ❓ Moving the world’s sound, while never feeling its pulse. |
| — Author: 401 |
YTConverter™ is a Python-based project developed by kaifcodec designed to provide a robust tool for converting YouTube videos into various formats. This tool simplifies the process of downloading and converting videos from YouTube.
Screenshots
Requirements
- Python 3.x
- Required Python libraries (listed in
requirements.txt) - ffmpeg & yt-dlp binary
🧩 Installation
🐧 Linux / Termux / macOS
Clone the repository
git clone https://github.com/kaifcodec/ytconverter.git cd ytconverter/standalone/
Auto-setup ffmpeg + dependencies
./install.sh
(If install.sh fails, install ffmpeg manually)
sudo apt install ffmpeg # Debian/Ubuntu
pkg install ffmpeg # Termux
sudo dnf install ffmpeg # Fedora
sudo pacman -S ffmpeg # Arch
Install ytconverter from PyPI
pip install ytconverter
Run the program
ytconverter -S
⚙️ Update
Update the repository
./update.sh
Update PyPI package
pip install -U ytconverter
🪟 Windows
Clone the repository
git clone https://github.com/kaifcodec/ytconverter.git cd ytconverter/standalone/
Run installer
install.bat
Or manually install ffmpeg and add it to PATH
Then run:
python ytconverter.py
⚠️ The standalone script is recommended for now.
PyPI version is still in beta — report issues on GitHub.
Tested on
- Linux
- Termux
- Ubuntu
- MacOs
- Windows 10/11
Contact for any error or issue:
Features
- Video Downloading: Fetch videos directly from YouTube.
- Audio Downloading: Downloads audio of any video with wide range of bitrate selection.
- Multiple video download: Now you can download multiple videos using the tool, just paste the urls one by one
- Format Conversion: Convert downloaded videos into different formats such as MP3, MP4, etc.
- Metadata Handling: Extract and manage metadata associated with YouTube videos.
Contributing
Contributions, issues, and feature requests are welcome!
Please take a moment to read our CONTRIBUTING.md guide for details on how to help make YTConverter™ better.
Feel free to open a pull request or submit an issue.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Contact
For any questions or feedback, please open an issue or contact kaifcodec.
If you found this tool helpful leave a star that will motivate me to maintain this project and add new features
Stars ⭐
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ytconverter-4.0.2.1.tar.gz.
File metadata
- Download URL: ytconverter-4.0.2.1.tar.gz
- Upload date:
- Size: 12.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.31.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
af4d67dbd43ef1a4c9127dd40db3aa1405061fe69b2657b34e6a8cd76d2e53fd
|
|
| MD5 |
8d70ec07d0882b384e3e0bdf03b6f2a3
|
|
| BLAKE2b-256 |
23809ff0af4373b00a941cc571ddd1bf815c149b4ce5bed875b46aa922f1226d
|
File details
Details for the file ytconverter-4.0.2.1-py3-none-any.whl.
File metadata
- Download URL: ytconverter-4.0.2.1-py3-none-any.whl
- Upload date:
- Size: 18.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.31.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1b47dc9d276ac12208d619e4433fcfd473c0a098edae123d58100b85bfc2f0a5
|
|
| MD5 |
62403aeec0f8539f4df53612c426bb83
|
|
| BLAKE2b-256 |
9042557e38e338162a40687db06384e432b96aa4de1f811365158114f1cda087
|