## YTConverter™
<p align="center">
<img src="https://img.shields.io/badge/Version-4.0.0-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/pypi/dm/ytconverter?label=PyPI%20Downloads&color=blue&logo=pypi" />
<img src="https://static.pepy.tech/badge/ytconverter?left_color=black&right_color=brightgreen" />
<a href="https://pypi.org/project/ytconverter">
<img src="https://badge.fury.io/py/ytconverter.svg" alt="PyPI version" />
</a>
</p>
---
`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.
---
---
Check the screenshots below👇
<!--- <p align="centre">
<img src="https://github.com/user-attachments/assets/3f50727f-0927-4b3b-82fa-729c346e66d1" width="600" height ="500" />
</p> --->
---
## Requirements
- Python 3.x
- Required Python libraries (listed in `standalone/requirements.txt`)
- ffmpeg & yt-dlp binary
## Install pypi Package (For Any)
---
- You can clone the repository or manually install `ffmpeg` by following no.2 commands 👇
1. Clone the repository and auto-setup the required binaries by running `install.sh`
```bash
git clone https://github.com/kaifcodec/ytconverter.git
cd ytconverter/standalone/
./install.sh
```
- Or else you can manually install `ffmpeg` by following below commands and ignore the repository cloning.
<!--- 1. Or manually instll ffmpeg
```bash
sudo apt install ffmpeg # For Linux
```
```bash
pkg install ffmpeg # For Termux
```
- After installing ffmpeg binary follow the below instructions
```bash
./standalone/install.sh # Only for Linux-like & Termux users
``` --->
2. If `install.sh` fails try installing ffmpeg manually by following below commands
```bash
sudo apt install ffmpeg # For Linux
```
```bash
pkg install ffmpeg # For Termux
```
3. After completion of setup install ytconverter pypi package and run
```bash
pip install ytconverter
ytconverter -S
```
- ⚠️ You need to manually install ffmpeg for windows or you can try `standalone/install.bat`
---
- ⚠️ However usage of standalone ytconverter.py is recommended⚠️
- Pypi package still in beta, Follow the below process 👇👇
---
### Installation For Linux (Ubuntu/Debian/Fedora/Arch):
1. Install Python:
```bash
sudo apt update && sudo apt install python3 python3-pip -y # For Debian/Ubuntu
sudo dnf install python3 python3-pip # For Fedora
sudo pacman -S python python-pip # For Arch
```
2. Install Git and Curl:
```bash
sudo apt install git -y # Debian/Ubuntu
```
3. Clone the repository:
```bash
git clone https://github.com/kaifcodec/ytconverter.git
cd ytconverter/standalone/
```
4. Install required Python libraries:
```bash
pip3 install -r requirements.txt
```
## Installation (Termux/Linux-distros)
```bash
# Update Termux and install Python
pkg update -y && pkg upgrade -y && pkg install python
# Install Git and Curl
pkg install git
# Clone the repository
git clone https://github.com/kaifcodec/ytconverter.git
# Grant storage permission
termux-setup-storage
# Navigate to the project directory
cd ytconverter/standalone/
# Install dependencies
pip install -r requirements.txt
```
## Installation (Windows)
1. Download or clone the repository:
```powershell
git clone https://github.com/kaifcodec/ytconverter.git
cd ytconverter/standalone/
2. Open Command Prompt and run the installer batch file `ytconverter/standalone/` directory:
```powershell
install.bat
```
3. After installation move installed yt-dlp.exe and ffmpeg binaries to your `PATH` directory, so that the script can access it globally.
4. After installation, start the program:
```powershell
python3 ytconverter.py
```
## Usage
1. Run the main script to start the conversion process:
```bash
python3 ytconverter.py
```
2. Follow the on-screen instructions to input the YouTube URL and choose the desired output format.
## Update In Linux & Termux (Recommended frequently)
1. To update the `ytconverter` repository, run:
```bash
./standalone/update.sh # It also keeps your yt-dlp up-to-date
```
2. To update the `ytconverter` binary just simply run the below command on your terminal:
```bash
ytconverter -U
```
## Tested on
- Linux
- Termux
- Ubuntu
- MacOs
- Windows 10/11
---
## Screenshots
<p align= "left">
<img src="https://github.com/user-attachments/assets/c67be3ec-ac46-4370-b64c-d95dfc4d988f" width="600" height="600"/>
</p>
<p align="left">
<img src= "https://github.com/user-attachments/assets/8e9d00ce-b698-4b1f-8870-badd5d274442" width="600" height="600"/>
</p>
---
## 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.
## Disclaimer ⚠⚠
- **We do ask you for your Name and Contact information at the beginning of the tool for update-related notices, but if you don't want to disclose those creds, you can leave those fields blank**
- **We also collect some basic information about the usage statistics and the user's Public IP, but we assure you that this data is not kept more than 48 hours**
- **We respect your privacy. Any basic info this tool collects (like usage data) is handled securely and never shared. No creepy tracking—just good software.**
- _Thank you 🌹🌹_ _Keep supporting ❤❤_
---
## 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).
---
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/ba/db/cd1623c79a37a6c43c5d1d40d0cf48fbbf133f7cd134b03e9d862631b70b/ytconverter-4.0.1.3.tar.gz",
"platform": null,
"description": "## YTConverter\u2122\n<p align=\"center\">\n <img src=\"https://img.shields.io/badge/Version-4.0.0-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/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 <a href=\"https://pypi.org/project/ytconverter\">\n <img src=\"https://badge.fury.io/py/ytconverter.svg\" alt=\"PyPI version\" />\n </a>\n</p>\n\n---\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\nCheck the screenshots below\ud83d\udc47\n\n\n<!--- <p align=\"centre\">\n \n <img src=\"https://github.com/user-attachments/assets/3f50727f-0927-4b3b-82fa-729c346e66d1\" width=\"600\" height =\"500\" />\n</p> --->\n\n---\n\n## Requirements\n- Python 3.x\n- Required Python libraries (listed in `standalone/requirements.txt`)\n- ffmpeg & yt-dlp binary\n\n## Install pypi Package (For Any)\n---\n- You can clone the repository or manually install `ffmpeg` by following no.2 commands \ud83d\udc47 \n1. Clone the repository and auto-setup the required binaries by running `install.sh`\n\n ```bash\n git clone https://github.com/kaifcodec/ytconverter.git\n cd ytconverter/standalone/\n ./install.sh\n ```\n- Or else you can manually install `ffmpeg` by following below commands and ignore the repository cloning.\n<!--- 1. Or manually instll ffmpeg\n ```bash\n sudo apt install ffmpeg # For Linux\n ```\n ```bash\n pkg install ffmpeg # For Termux\n ``` \n- After installing ffmpeg binary follow the below instructions\n ```bash\n ./standalone/install.sh # Only for Linux-like & Termux users\n ``` --->\n 2. If `install.sh` fails try installing ffmpeg manually by following below commands\n\n ```bash\n sudo apt install ffmpeg # For Linux\n ```\n ```bash\n pkg install ffmpeg # For Termux\n ```\n3. After completion of setup install ytconverter pypi package and run\n\n ```bash\n pip install ytconverter\n ytconverter -S\n ```\n- \u26a0\ufe0f You need to manually install ffmpeg for windows or you can try `standalone/install.bat`\n\n--- \n- \u26a0\ufe0f However usage of standalone ytconverter.py is recommended\u26a0\ufe0f\n- Pypi package still in beta, Follow the below process \ud83d\udc47\ud83d\udc47\n---\n### Installation For Linux (Ubuntu/Debian/Fedora/Arch):\n1. Install Python:\n ```bash\n sudo apt update && sudo apt install python3 python3-pip -y # For Debian/Ubuntu\n \n sudo dnf install python3 python3-pip # For Fedora\n \n sudo pacman -S python python-pip # For Arch\n ```\n2. Install Git and Curl:\n ```bash\n sudo apt install git -y # Debian/Ubuntu\n ```\n3. Clone the repository:\n ```bash\n git clone https://github.com/kaifcodec/ytconverter.git\n cd ytconverter/standalone/\n ```\n4. Install required Python libraries:\n ```bash\n pip3 install -r requirements.txt\n ```\n## Installation (Termux/Linux-distros)\n```bash\n# Update Termux and install Python\npkg update -y && pkg upgrade -y && pkg install python\n\n# Install Git and Curl\npkg install git\n\n# Clone the repository\ngit clone https://github.com/kaifcodec/ytconverter.git\n\n# Grant storage permission\ntermux-setup-storage\n\n# Navigate to the project directory\ncd ytconverter/standalone/\n\n# Install dependencies\npip install -r requirements.txt\n```\n\n## Installation (Windows)\n\n1. Download or clone the repository:\n\n ```powershell\n git clone https://github.com/kaifcodec/ytconverter.git\n cd ytconverter/standalone/\n2. Open Command Prompt and run the installer batch file `ytconverter/standalone/` directory:\n```powershell\ninstall.bat\n```\n3. After installation move installed yt-dlp.exe and ffmpeg binaries to your `PATH` directory, so that the script can access it globally.\n\n4. After installation, start the program:\n```powershell\npython3 ytconverter.py\n```\n## Usage\n1. Run the main script to start the conversion process:\n ```bash\n python3 ytconverter.py\n ```\n2. Follow the on-screen instructions to input the YouTube URL and choose the desired output format.\n\n## Update In Linux & Termux (Recommended frequently)\n1. To update the `ytconverter` repository, run:\n ```bash\n ./standalone/update.sh # It also keeps your yt-dlp up-to-date \n ```\n2. To update the `ytconverter` binary just simply run the below command on your terminal:\n ```bash\n ytconverter -U\n ```\n## Tested on\n- Linux\n- Termux\n- Ubuntu\n- MacOs\n- Windows 10/11\n\n---\n## Screenshots\n<p align= \"left\">\n <img src=\"https://github.com/user-attachments/assets/c67be3ec-ac46-4370-b64c-d95dfc4d988f\" width=\"600\" height=\"600\"/>\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\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## Disclaimer \u26a0\u26a0\n - **We do ask you for your Name and Contact information at the beginning of the tool for update-related notices, but if you don't want to disclose those creds, you can leave those fields blank**\n - **We also collect some basic information about the usage statistics and the user's Public IP, but we assure you that this data is not kept more than 48 hours**\n - **We respect your privacy. Any basic info this tool collects (like usage data) is handled securely and never shared. No creepy tracking\u2014just good software.**\n - _Thank you \ud83c\udf39\ud83c\udf39_ _Keep supporting \u2764\u2764_\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\n---\n",
"bugtrack_url": null,
"license": null,
"summary": "Terminal-based YouTube video/audio downloader using yt-dlp and ffmpeg",
"version": "4.0.1.3",
"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": "f4bdf669318fce67186580d05262b8b7ff0ed8b90ff09797867ea0db7896c805",
"md5": "4fcab17193376915dba531db943dfedc",
"sha256": "35c63628d6252c36e31d1be726edb2936e5f014ecc24335c98422da7cf2da4cb"
},
"downloads": -1,
"filename": "ytconverter-4.0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4fcab17193376915dba531db943dfedc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 20762,
"upload_time": "2025-08-01T17:12:20",
"upload_time_iso_8601": "2025-08-01T17:12:20.539278Z",
"url": "https://files.pythonhosted.org/packages/f4/bd/f669318fce67186580d05262b8b7ff0ed8b90ff09797867ea0db7896c805/ytconverter-4.0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "badbcd1623c79a37a6c43c5d1d40d0cf48fbbf133f7cd134b03e9d862631b70b",
"md5": "d132cd266fdb6bd6ff8f2f8b8359ecd5",
"sha256": "814e41d20d63110bd6fa56e79cb40ef6b5e1dc10e181bbf76735a5c5cec58682"
},
"downloads": -1,
"filename": "ytconverter-4.0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "d132cd266fdb6bd6ff8f2f8b8359ecd5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 15698,
"upload_time": "2025-08-01T17:12:23",
"upload_time_iso_8601": "2025-08-01T17:12:23.549213Z",
"url": "https://files.pythonhosted.org/packages/ba/db/cd1623c79a37a6c43c5d1d40d0cf48fbbf133f7cd134b03e9d862631b70b/ytconverter-4.0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-01 17:12:23",
"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
