Skip to content

[🚧 BETA] yt-dlp pseudo-graphical console interface (TUI) ✨

License

Notifications You must be signed in to change notification settings

NikitaBeloglazov/ytcon

Repository files navigation

✨ YTCON

License: Mozilla Public License 2.0 linting: pylint based on yt-dlp maintainer: NikitaBeloglazov

TUI for the yt-dlp utility, with support for many settings, some fixes, and multithreading

🚧 Currently in the BETA stage of development

⚠️ Please note, project is not dead, i'm still working in dev branches. Stable release coming soon

📘 Features:

  • yt-dlp features
  • Auto-updates feature
  • Multiple downloads at the same time
  • Clipboard auto-paste
  • "Special mode"
  • Shows the resolution of downloading videos, even in generic extractor
  • Beautiful, colorful and comfortable human UI

TODO:

  • Desktop notifications support
  • RPM packaging

and more..

🚀 Install

YTCON is avalible on PyPI 🎆 - https://pypi.org/project/ytcon/

▶️ Install it like a pip package in pipx (Recommended)

  • pipx install ytcon
  • pipx ensurepath

If pipx is not installed, install it with a system package manager - python3-pipx

Manual install

  • git clone https://github.com/NikitaBeloglazov/ytcon && cd ytcon
  • pip3 install -r requirements.txt
  • cd src/ytcon && python3 yt.py

💿 Support

•‎ 🟩 Linux - FULL SUPPORT

•‎ 🟩 Android - FULL SUPPORT in Termux with some tweaks

•‎ 🟩 MacOS - Works on macOS HighSierra 10.13

•‎ 🟩 BSD Systems - Works on FreeBSD / GhostBSD and OpenBSD / FuguIta

•‎ 🟥 Windows - Don't works, because Urwid don't support it. Related Issues: -1- and -2-. Maybe it will be fixed soon. Use WSL or Cygwin unstead.

🖼️ Screenshots

Main screen

Main screen image

Settings screen

Settings screen image

⚙️ Settings save file

The save file is located at ~/.config/ytcon

💬 Testing / Debug / Troubleshooting

  • See /tmp/debug.log and /tmp/info.log. They are cleared every new launch of the utility.
  • Try this same link with regular yt-dlp (yt-dlp [link])

Contribution / Issues

  • 🥼 Pull requests are welcome!
  • 🌈 Feel free to write Issues! The developer can answer you in the following languages: Ukrainian, English, Russian.
  • Don't forget to attach version (pip3 show ytcon) and error text :)
  • ⏩ To speed up the process write to maintainer