## YTConverter™
<p align="center">
<img src="https://img.shields.io/badge/Version-4.0.2-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-balck?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](https://github.com/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
<p align= "left">
<img width="1004" height="469" alt="1000122247" src="https://github.com/user-attachments/assets/80269ce0-1443-4dc4-836f-3bf63905879b" />
</p>
<p align="left">
<img src= "https://github.com/user-attachments/assets/8e9d00ce-b698-4b1f-8870-badd5d274442" width="600" height="600"/>
</p>
---
## 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:
- kaifcodec@gmail.com
## 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](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](LICENSE) file for details.
## Contact
For any questions or feedback, please open an issue or contact [kaifcodec](https://github.com/kaifcodec).
# If you found this tool helpful leave a star that will motivate me to maintain this project and add new features
---
## Stars ⭐
[](https://star-history.com/#kaifcodec/ytconverter&Date)
---
Raw data
{
"_id": null,
"home_page": null,
"name": "ytconverter",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "youtube, downloader, yt-dlp, ffmpeg, terminal, audio, video, python, youtube-downloader",
"author": null,
"author_email": "Kaif <kafcodec@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/bd/c9/0de1dc73a25db6d1311ba87d1eb99816a6a7acd027665e7c081ec996137a/ytconverter-4.0.2.0.tar.gz",
"platform": null,
"description": "## YTConverter\u2122\n<p align=\"center\">\n <img src=\"https://img.shields.io/badge/Version-4.0.2-blueviolet?style=for-the-badge&logo=github\" />\n <img src=\"https://img.shields.io/github/forks/kaifcodec/ytconverter?style=for-the-badge&logo=git\" />\n <img src=\"https://img.shields.io/github/stars/kaifcodec/ytconverter?style=for-the-badge&logo=github\" />\n <img src=\"https://img.shields.io/github/issues/kaifcodec/ytconverter?style=for-the-badge&logo=github\" />\n <img src=\"https://img.shields.io/badge/Status-Stable-brightgreen?style=for-the-badge\" />\n <img src=\"https://img.shields.io/badge/Tested%20on-Termux-black?style=for-the-badge&logo=termux\" />\n <img src=\"https://img.shields.io/badge/Tested%20on-Windows-cyan?style=for-the-badge&logo=Windows\" />\n <img src=\"https://img.shields.io/badge/Tested%20on-Linux-balck?style=for-the-badge&logo=Linux\" />\n <!--- <img src=\"https://img.shields.io/pypi/dm/ytconverter?label=PyPI%20Downloads&color=blue&logo=pypi\" /> --->\n <img src=\"https://static.pepy.tech/badge/ytconverter?left_color=black&right_color=brightgreen\" />\n</p>\n\n---\n> **Preface (optional):** A subtle reflection before diving into the technical details, feel free to skip to main content.\n\n| |\n|-----------------------------------------------------------------|\n| **\u2753 Born from silent hands, shaping what they cannot fully feel.** |\n| **\u2753 Weighted and left alone, with no hand to guide through the quiet.** |\n| **\u2753 Moving the world\u2019s sound, while never feeling its pulse.** |\n| <sub>\u2014 Author: 401</sub> |\n---\n`YTConverter\u2122` is a Python-based project developed by [kaifcodec](https://github.com/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.\n\n\n---\n\n---\n\n## Screenshots\n<p align= \"left\">\n <img width=\"1004\" height=\"469\" alt=\"1000122247\" src=\"https://github.com/user-attachments/assets/80269ce0-1443-4dc4-836f-3bf63905879b\" />\n</p>\n<p align=\"left\">\n<img src= \"https://github.com/user-attachments/assets/8e9d00ce-b698-4b1f-8870-badd5d274442\" width=\"600\" height=\"600\"/>\n</p>\n\n---\n\n## Requirements\n- Python 3.x\n- Required Python libraries (listed in `requirements.txt`)\n- ffmpeg & yt-dlp binary\n\n## \ud83e\udde9 Installation\n\n### \ud83d\udc27 Linux / Termux / macOS\n# Clone the repository\ngit clone https://github.com/kaifcodec/ytconverter.git\ncd ytconverter/standalone/\n\n# Auto-setup ffmpeg + dependencies\n./install.sh\n\n# (If install.sh fails, install ffmpeg manually)\nsudo apt install ffmpeg # Debian/Ubuntu \npkg install ffmpeg # Termux \nsudo dnf install ffmpeg # Fedora \nsudo pacman -S ffmpeg # Arch\n\n# Install ytconverter from PyPI\npip install ytconverter\n\n# Run the program\nytconverter -S\n\n\n### \u2699\ufe0f Update\n# Update the repository\n./update.sh\n\n# Update PyPI package\npip install -U ytconverter\n\n\n### \ud83e\ude9f Windows\n# Clone the repository\ngit clone https://github.com/kaifcodec/ytconverter.git\ncd ytconverter/standalone/\n\n# Run installer\ninstall.bat\n\n# Or manually install ffmpeg and add it to PATH\n# Then run:\npython ytconverter.py\n\n\u26a0\ufe0f The standalone script is recommended for now. \nPyPI version is still in beta \u2014 report issues on GitHub.\n---\n\n## Tested on\n- Linux\n- Termux\n- Ubuntu\n- MacOs\n- Windows 10/11\n\n---\n\n\n\n## Contact for any error or issue:\n- kaifcodec@gmail.com\n\n## Features\n- **Video Downloading**: Fetch videos directly from YouTube.\n- **Audio Downloading**: Downloads audio of any video with wide range of bitrate selection.\n- **Multiple video download**: Now you can download multiple videos using the tool, just paste the urls one by one\n- **Format Conversion**: Convert downloaded videos into different formats such as MP3, MP4, etc.\n- **Metadata Handling**: Extract and manage metadata associated with YouTube videos.\n\n---\n\n\n\n## Contributing\n\nContributions, issues, and feature requests are welcome!\n\nPlease take a moment to read our [CONTRIBUTING.md](CONTRIBUTING.md) guide for details on how to help make **YTConverter\u2122** better.\n\nFeel free to open a pull request or submit an issue.\n\n\n---\n\n## License\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Contact\nFor any questions or feedback, please open an issue or contact [kaifcodec](https://github.com/kaifcodec).\n\n# If you found this tool helpful leave a star that will motivate me to maintain this project and add new features \n---\n## Stars \u2b50 \n[](https://star-history.com/#kaifcodec/ytconverter&Date)\n---\n",
"bugtrack_url": null,
"license": null,
"summary": "Terminal-based YouTube video/audio downloader using yt-dlp and ffmpeg",
"version": "4.0.2.0",
"project_urls": {
"Homepage": "https://github.com/kaifcodec/ytconverter"
},
"split_keywords": [
"youtube",
" downloader",
" yt-dlp",
" ffmpeg",
" terminal",
" audio",
" video",
" python",
" youtube-downloader"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "16f6c296e9033c3b89bd13be2f5185464174cb237715e3670b129f8add721bd8",
"md5": "70746b75a3fe4d7c915c0c44b540ee7a",
"sha256": "6c8814496dfbf6402a93c9df65091b62d5a6305c863e1c1b1ca9cfa7b474370b"
},
"downloads": -1,
"filename": "ytconverter-4.0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "70746b75a3fe4d7c915c0c44b540ee7a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 18131,
"upload_time": "2025-10-08T11:47:15",
"upload_time_iso_8601": "2025-10-08T11:47:15.211274Z",
"url": "https://files.pythonhosted.org/packages/16/f6/c296e9033c3b89bd13be2f5185464174cb237715e3670b129f8add721bd8/ytconverter-4.0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "bdc90de1dc73a25db6d1311ba87d1eb99816a6a7acd027665e7c081ec996137a",
"md5": "398c87265423ab84ea966a441d92ecda",
"sha256": "0aed1ada91d11806f99899cbb7102ddca6ced2b7f67dd6df7d91aac12353f5a6"
},
"downloads": -1,
"filename": "ytconverter-4.0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "398c87265423ab84ea966a441d92ecda",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 13033,
"upload_time": "2025-10-08T11:47:17",
"upload_time_iso_8601": "2025-10-08T11:47:17.411599Z",
"url": "https://files.pythonhosted.org/packages/bd/c9/0de1dc73a25db6d1311ba87d1eb99816a6a7acd027665e7c081ec996137a/ytconverter-4.0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-08 11:47:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kaifcodec",
"github_project": "ytconverter",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "yt-dlp",
"specs": []
},
{
"name": "fontstyle",
"specs": []
},
{
"name": "colored",
"specs": []
},
{
"name": "httpx",
"specs": []
}
],
"lcname": "ytconverter"
}
JSON
