Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hetari/pyutube
A simple user friendly command line tool to download YouTube videos and playlists with fewer steps.
https://github.com/hetari/pyutube
cli cli-app console-application open-source pakage playlist-downloader python python-3 python3 pytube pytube-git pytube-libraries pytube-projects pytube3 pytubefix terminal typer-cli video-downloader youtube youtube-downloader
Last synced: 1 day ago
JSON representation
A simple user friendly command line tool to download YouTube videos and playlists with fewer steps.
- Host: GitHub
- URL: https://github.com/hetari/pyutube
- Owner: Hetari
- License: mit
- Created: 2024-02-28T21:02:47.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-02-12T18:23:52.000Z (9 days ago)
- Last Synced: 2025-02-12T18:36:42.646Z (9 days ago)
- Topics: cli, cli-app, console-application, open-source, pakage, playlist-downloader, python, python-3, python3, pytube, pytube-git, pytube-libraries, pytube-projects, pytube3, pytubefix, terminal, typer-cli, video-downloader, youtube, youtube-downloader
- Language: Python
- Homepage:
- Size: 734 KB
- Stars: 57
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 📹 Pyutube - The Simplest YouTube Downloader CLI
### Enjoying my project? Please show your appreciation by starring it on GitHub! ⭐
> [!NOTE] > `Pyutube` is built on top of `pytubefix`, make sure to have the latest version of `pytubefix` by running:
>
> ```bash
> pip install --upgrade pytubefix
> ```
> [!NOTE]
> Have **a new feature**? Please don't hesitate to [tell me](https://github.com/Hetari/pyutube/issues/new)!
## 🤔 why `pyutube`?
This command-line wizard lets you download YouTube videos or playlists straight from your `Terminal`, powered by [Pytubefix](https://pytubefix.readthedocs.io/). It works like a charm on Windows, Mac, and Linux, so you can rock it on any platform.
While other tools make you wade through a swamp of settings and configs, `Pyutube` keeps it simple. Just drop in your URL, and voilà! It’ll take you on a smooth ride to your favorite videos, no complex options needed—just fun downloading! 🔥
## 🛠️ Installation
Getting `Pyutube` up and running is a breeze! First, ensure you have [Python](https://www.python.org) installed. Just pop open your terminal and type:
```bash
python --version
```
If you see something like `Python 3.x`, you’re all set! If not, head over to [Python's downloads page](https://www.python.org/downloads/) to grab it.
Once you’re good to go, install `Pyutube` with a single command:
```bash
pip install pyutube --break-system-packages
```
And just like that, you’re ready to download some awesome videos! 🎉
## 📈 Upgrade
Stay in the loop with the latest features on [GitHub](https://github.com/Hetari/pyutube)! To upgrade your `Pyutube` tool, simply run:
```bash
pip install --upgrade pyutube --break-system-packages
```
Then you’re all set to keep downloading from your `Terminal`! 🥳
## 🦸 Quick Start
Getting started with `Pyutube` is a piece of cake! Just use the following command style:
```bash
pyutube "YOUTUBE_LINK" [PATH]
```
> [!NOTE]
> The `[URL]` is [Required] and it should be between `""`
> The `[PATH]` is optional—if you don’t specify one, it’ll save to your current terminal directory. Easy-peasy!
## 👨💻 Usage
#### Arguments
| Arguments | Description |
| --------- | -------------------------------------------------------------------------------------------------------------------- |
| `URL` | The `URL` of the YouTube video. This argument is [Required]. |
| `PATH` | The `path` to save the video. Defaults to the current working directory. [Optional] |
### Options
| Option | Description |
| --------------------------------------------------- | -------------------------------------- |
| `-v` or `--version` | Displays the current version number. |
| `-a` or `--audio` | Download audio only, skipping prompts. |
| `-f` or `--footage` | Download video only, skipping prompts. |
## 🕵️♂️ Examples
For lots of examples, check them out [here](https://github.com/Hetari/pyutube/blob/main/EXAMPLES.md)! Take a deep dive and discover all the ways to use Pyutube. 🚀
## 🥰 Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you want to change.
please follow the [contributing guidelines](https://github.com/Hetari/pyutube/blob/main/CONTRIBUTING.md)
## 📎 License
This project is licensed under the [MIT License](https://github.com/Hetari/pyutube/blob/main/LICENSE.md).
## 📸 Screenshots
Download video with specify the save location
Chose what type you want to download
Chose what what resolution you want to download(if the type is video)
If you download a playlist, you can choose what video you want to download, or even all of them
Do not know how to use it? just type pyutube --help
## ⏳ Todo List
- [x] **Notification System**
- [x] **Auto Update package if new version available**
- [x] **Support Optional Numbering for Downloaded Playlist Videos**
- [ ] **Improve code health**
- [ ] **Support downloading sounds (mp3 format not a audio/mp4)**
- [ ] **Support Subtitles Download**
- [ ] **Support setting for downloading folder**
- [ ] **Download Thumbnails with Videos and Audio**