SkillAgentSearch skills...

Ytconverter

The ytconverter is a CLI tool for downloading YouTube videos in various format directly from the terminal. It leverages popular libraries (yt-dlp) and frameworks within the Python ecosystem to handle video downloading, format conversion, metadata handling and many more!

Install / Use

/learn @kaifcodec/Ytconverter

README

YTConverter™

<img width="1024" height="700" alt="1000140947" src="https://github.com/user-attachments/assets/e0ce5970-36eb-4ddf-ba62-99c9c6f12f1b" />
<p align="center"> <img src="https://img.shields.io/badge/Version-4.0.3-blueviolet?style=for-the-badge&logo=github" /> <!-- <img src="https://img.shields.io/github/forks/kaifcodec/ytconverter?style=for-the-badge&logo=git" /> <img src="https://img.shields.io/github/stars/kaifcodec/ytconverter?style=for-the-badge&logo=github" /> --> <img src="https://img.shields.io/github/issues/kaifcodec/ytconverter?style=for-the-badge&logo=github" /> <img src="https://img.shields.io/badge/Status-Stable-brightgreen?style=for-the-badge" /> <img src="https://img.shields.io/badge/Tested%20on-Termux-black?style=for-the-badge&logo=termux" /> <img src="https://img.shields.io/badge/Tested%20on-Windows-cyan?style=for-the-badge&logo=Windows" /> <img src="https://img.shields.io/badge/Tested%20on-Linux-black?style=for-the-badge&logo=Linux" /> <!--- <img src="https://img.shields.io/pypi/dm/ytconverter?label=PyPI%20Downloads&color=blue&logo=pypi" /> ---> <img src="https://static.pepy.tech/badge/ytconverter?left_color=black&right_color=brightgreen" /> </p>

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. | | <sub>— Author: 401</sub> |

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.


✅ 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.

  • Subtitles: Subtitles download support.

  • Playlist download: Full playlist download in mp3 or mp4 format with subtitles

  • Detailed Quality : It fetches all the available resolutions for the video and let you select as per your need.

  • Path selections : It has inbuilt features to detect Downloads folder according to what platform user in.

  • Custom Path : Also you can enter your suitable path for every video.

  • Title sanitization : It has inbuilt re module implementation that converts special characters to text, avoiding errors

  • Format Conversion.: Convert downloaded videos into different formats such as MP3, MP4, etc.

  • Metadata Handling : Extract and manage metadata associated with YouTube videos.

  • Colored output : Colorful terminal output that make it easier to select options.

  • Interactive CLI : It provides interactive CLI menu that is way easier than using commands everytime.

  • Auto Update : You can simply run ytconverter -U and it will update yt-dlp and ytconverter to latest version, even it can auto detect whenever there's a new release of ytconverter.

  • Many more features inside try them all...


Screenshots

<p align= "left"> <img width="1072" height="344" alt="1000142597" src="https://github.com/user-attachments/assets/e45decd7-4750-4d1f-b21e-4f8bb078bccc" /> </p> <p align="left"> <img width="1080" height="946" alt="1000132190" src="https://github.com/user-attachments/assets/6954b057-1b23-44ec-bf1d-cb5fbff3c2a9" /> </p>

Requirements

  • Python 3.x
  • Required Python libraries (listed in requirements.txt)
  • ffmpeg & yt-dlp binary

🧩 Installation

🐧 Linux / Termux / macOS

git clone https://github.com/kaifcodec/ytconverter.git
cd ytconverter/standalone/
./install.sh # Auto-setup ffmpeg + dependencies

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

pip3 install ytconverter
ytconverter -S

⚙️ Update

Update ytconverter

./update.sh # update to new repo, new yt-dlp version 

ytconverter -U # pypi package 

🪟 Windows

Clone the repository

git clone https://github.com/kaifcodec/ytconverter.git
cd ytconverter/standalone/
install.bat # Or manually install ffmpeg and add it to PATH
pip3 install ytconverter 

Then run:

ytconverter -S

❤️ Support the project

If this project helps you, consider supporting its development:

BTC (SegWit): bc1q0dzkuav8lq9lwu7gc457vwlda4utfcr5hpv7ka


If you found this tool helpful leave a star that will motivate me to maintain this project and add new features

<a href="https://www.star-history.com/#kaifcodec/ytconverter&type=date&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=kaifcodec/ytconverter&type=date&theme=dark&legend=top-left" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=kaifcodec/ytconverter&type=date&legend=top-left" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=kaifcodec/ytconverter&type=date&legend=top-left" /> </picture> </a>
View on GitHub
GitHub Stars452
CategoryContent
Updated1d ago
Forks29

Languages

Python

Security Score

100/100

Audited on Mar 20, 2026

No findings