TransTerm
A terminal based YouTube video and playlist downloader (mp4, mp3, wav) and transcriber with a nice TUI interface.
PS. The transparency and retro term is proper of my KDE Plasma configuration
🌲🌲🌲🦌🌲🌲🌲🦌🌲🌲🌲
By utilizing TransTerm, you acknowledge that you have read, comprehended, and agreed to the terms set forth in the disclaimer at the bottom of this file.
Table of Contents
What is this
TransTerm is an highly experimental text based graphical user interface to act on YouTube videos.
Being text based, this program runs even in the terminal.
Latest changelog
Added experimental playlist folder support and playlist resume support. Please report any issues.
Features
- Download any youtube video at the highest resolution by default in mp4 format
- Is able to automatically convert the downloaded video both in mp3 or wav format
- Playlist support for the above features including automatically rename the files using the video title and the channel name
- Playlists organization in folders with resume support (aka check if files are already there with the same title and channel)
- Transcribe a ssingle downloaded video using either: • Google Audio to Text • Google Audio to Text + Silence detection • Sphynx CMU (processed offline locally)
Installation for Mac & Linux
git clone https://github.com/thecookingsenpai/transterm && cd transterm
sudo chmod +x install.sh
./install.sh
Troubleshooting
In some cases, where python3 environment is managed by the system and not by pip3, it is advisable to install the dependencies manually as you would do with your system. If you want to force the installation anyway, first run:
pip3 install -r requirements.txt --break-system-packages
The same general solution applies to any requirements problem. PLease note that using the above command is not recommended as it could break your python installation.
Installation for Window
git clone https://github.com/thecookingsenpai/transterm && cd transterm && pip3 install -r requirements.txt
Usage
python3 gui.py
Manual mode (aka debug)
You can edit the bottom part of term.py so that after the
if __name__ == "__main__":
condition you can write your own logic. Then, launch with:
python3 term.py
For convenience, a playlist example is already included (with the best playlist ever, I'd say).
Contributing
You are welcome and free to contribute to the project. To do that, you have a few ways:
- Add some kind of functionality and create a PR
- Search the lines marked with TODO and FIXME in the code for the most urgent things
- In any case, thank you!
License
MIT License
Disclaimer
Terms and Conditions:
TransTerm is a YouTube downloader and transcriber application developed for personal, non-commercial use. Users must ensure that their utilization of this tool complies with all relevant laws and regulations in their jurisdiction.
Appropriate Use:
Copyright Adherence:
Users must respect the copyrights and intellectual property rights of content creators. TransTerm should not be utilized to infringe upon copyrights or distribute content without proper authorization.
Personal Usage:
The application is intended for personal use, allowing users to download and transcribe YouTube videos for lawful purposes such as education, research, or similar activities. Commercial use or distribution of downloaded/transcribed content without authorization is strictly prohibited.
Third-Party Content:
Users are responsible for confirming that they possess the legal rights to download and transcribe any third-party content from YouTube. TransTerm does not endorse or encourage the unauthorized downloading or distribution of copyrighted materials.
Limitation of Responsibility:
The developers of TransTerm are not accountable for any misuse or illegal use of the tool. Users accept all associated risks with their use of the application and agree to comply with applicable laws and YouTube's terms of service.
Please Note: This disclaimer does not serve as legal advice. Users are encouraged to seek legal counsel if they have queries regarding the legality of their use of TransTerm in their specific jurisdiction.
By utilizing TransTerm, you acknowledge that you have read, comprehended, and agreed to the terms set forth in this disclaimer.