Skip to main content

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.


file_000000006dfc61fb9c9a2cb865da0157

Screenshots

1000122247


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 ⭐

Star History Chart

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ytconverter-4.0.2.3.tar.gz (14.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ytconverter-4.0.2.3-py3-none-any.whl (25.7 kB view details)

Uploaded Python 3

File details

Details for the file ytconverter-4.0.2.3.tar.gz.

File metadata

  • Download URL: ytconverter-4.0.2.3.tar.gz
  • Upload date:
  • Size: 14.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.31.0

File hashes

Hashes for ytconverter-4.0.2.3.tar.gz
Algorithm Hash digest
SHA256 8e6d441932216af6e1960d931ca44baf09b710c2b82275b5f54bbf65f4faeb13
MD5 a6178c4b11f95b9bcfa5a48f6f19d40c
BLAKE2b-256 91791363a79536d91e561a55e2dc9580ae1379aace50459f9232112f9ba50695

See more details on using hashes here.

File details

Details for the file ytconverter-4.0.2.3-py3-none-any.whl.

File metadata

  • Download URL: ytconverter-4.0.2.3-py3-none-any.whl
  • Upload date:
  • Size: 25.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.31.0

File hashes

Hashes for ytconverter-4.0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 965c9cf9c299f0ffa9ef87ce6f48dc78920554d0aedb3bfc9eda330dc8941cbd
MD5 3ff7f178df80996d3c7b3ef6b2812085
BLAKE2b-256 56abd7b0c152682a71e2bce350d430b6517a5067b8ccb0c0b0231bb8c9d853fb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page