{"id":18458645,"url":"https://github.com/hetari/pyutube","last_synced_at":"2025-04-06T06:06:47.655Z","repository":{"id":225089097,"uuid":"764862030","full_name":"Hetari/pyutube","owner":"Hetari","description":"A simple user friendly command line tool to download YouTube videos and playlists with fewer steps.","archived":false,"fork":false,"pushed_at":"2025-02-15T20:50:46.000Z","size":763,"stargazers_count":63,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-30T05:03:57.083Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hetari.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-28T21:02:47.000Z","updated_at":"2025-03-22T23:20:20.000Z","dependencies_parsed_at":"2024-03-28T02:23:24.202Z","dependency_job_id":"0b18ae1d-cf28-44bb-9888-16a8ba0250f9","html_url":"https://github.com/Hetari/pyutube","commit_stats":null,"previous_names":["hetari/youtube-vide-downloader-cli-with-python","hetari/utube","hetari/youtube-vide-downloader-cli","hetari/pyutube"],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hetari%2Fpyutube","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hetari%2Fpyutube/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hetari%2Fpyutube/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hetari%2Fpyutube/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hetari","download_url":"https://codeload.github.com/Hetari/pyutube/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247441042,"owners_count":20939239,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2024-11-06T08:19:26.486Z","updated_at":"2025-04-06T06:06:47.632Z","avatar_url":"https://github.com/Hetari.png","language":"Python","readme":"# 📹 Pyutube - The Simplest YouTube Downloader CLI\n\n### Enjoying my project? Please show your appreciation by starring it on GitHub! ⭐\n\n\u003ca href=\"https://github.com/Hetari/pyutube\"\u003e\n  \u003cimg src=\"https://img.shields.io/pypi/v/pyutube.svg?style=flat\u0026label=Version\" alt=\"Version\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://pepy.tech/projects/pyutube\"\u003e\n  \u003cimg src=\"https://static.pepy.tech/badge/pyutube\" alt=\"Downloads\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://pepy.tech/projects/pyutube\"\u003e\n  \u003cimg src=\"https://static.pepy.tech/badge/pyutube/month\" alt=\"Downloads per Month\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://pepy.tech/projects/pyutube\"\u003e\n  \u003cimg src=\"https://static.pepy.tech/badge/pyutube/week\" alt=\"Downloads per Week\"\u003e\n\u003c/a\u003e\n\n\u003cbr /\u003e\n\u003cbr /\u003e\n\n\u003e [!NOTE] \u003e `Pyutube` is built on top of `pytubefix`, make sure to have the latest version of `pytubefix` by running:\n\u003e\n\u003e ```bash\n\u003e pip install --upgrade pytubefix\n\u003e ```\n\n\u003ca href=\"https://ibb.co/27wcFYN\"\u003e\n   \u003cimg src=\"https://i.ibb.co/MDbPg56/Screenshot-from-2024-04-08-21-38-02-transformed.png\" alt=\"Pyutube\" style=\"width: 100%;\"\u003e\n\u003c/a\u003e\n\n\u003e [!NOTE]\n\u003e Have **a new feature**? Please don't hesitate to [tell me](https://github.com/Hetari/pyutube/issues/new)!\n\n## 🤔 why `pyutube`?\n\nThis 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.\n\nWhile 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! 🔥\n\n## 🛠️ Installation\n\nGetting `Pyutube` up and running is a breeze! First, ensure you have [Python](https://www.python.org) installed. Just pop open your terminal and type:\n\n```bash\npython --version\n```\n\nIf 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.\n\nOnce you’re good to go, install `Pyutube` with a single command:\n\n```bash\npip install pyutube --break-system-packages\n```\n\nAnd just like that, you’re ready to download some awesome videos! 🎉\n\n## 📈 Upgrade\n\nStay in the loop with the latest features on [GitHub](https://github.com/Hetari/pyutube)! To upgrade your `Pyutube` tool, simply run:\n\n```bash\npip install --upgrade pyutube --break-system-packages\n```\n\nThen you’re all set to keep downloading from your `Terminal`! 🥳\n\n## 🦸 Quick Start\n\nGetting started with `Pyutube` is a piece of cake! Just use the following command style:\n\n```bash\npyutube \"YOUTUBE_LINK\" [PATH]\n```\n\n\u003e [!NOTE]\n\u003e The `[URL]` is \u003cspan style=\"color:red\"\u003e[Required]\u003c/span\u003e and it should be between `\"\"`\u003cbr/\u003e\n\u003e The `[PATH]` is optional—if you don’t specify one, it’ll save to your current terminal directory. Easy-peasy!\n\n## 👨‍💻 Usage\n\n#### Arguments\n\n| Arguments | Description                                                                                                          |\n| --------- | -------------------------------------------------------------------------------------------------------------------- |\n| `URL`     | The `URL` of the YouTube video. This argument is \u003cspan style=\"color:red\"\u003e[Required]\u003c/span\u003e.                          |\n| `PATH`    | The `path` to save the video. Defaults to the current working directory. \u003cspan style=\"color:green\"\u003e[Optional]\u003c/span\u003e |\n\n### Options\n\n| Option                                              | Description                            |\n| --------------------------------------------------- | -------------------------------------- |\n| `-v` \u003cspan style=\"color:cyan\"\u003eor\u003c/span\u003e `--version` | Displays the current version number.   |\n| `-a` \u003cspan style=\"color:cyan\"\u003eor\u003c/span\u003e `--audio`   | Download audio only, skipping prompts. |\n| `-f` \u003cspan style=\"color:cyan\"\u003eor\u003c/span\u003e `--footage` | Download video only, skipping prompts. |\n\n## 🕵️‍♂️ Examples\n\nFor 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. 🚀\n\n## 🥰 Contributing\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you want to change.\nplease follow the [contributing guidelines](https://github.com/Hetari/pyutube/blob/main/CONTRIBUTING.md)\n\n## 📎 License\n\nThis project is licensed under the [MIT License](https://github.com/Hetari/pyutube/blob/main/LICENSE.md).\n\n## 📸 Screenshots\n\n\u003c!-- for pypi only --\u003e\n\u003cdiv style=\"text-align: center;\"\u003e\n   \u003cp\u003eDownload video with specify the save location\u003c/p\u003e\n   \u003ca href=\"https://ibb.co/0JkdkQy\"\u003e\n      \u003cimg src=\"https://i.ibb.co/7yH6Hbt/image1.png\" alt=\"Download video with specify the save location\"\u003e\n   \u003c/a\u003e\n   \u003cp\u003eChose what type you want to download\u003c/p\u003e\n   \u003ca href=\"https://ibb.co/Kb6qjmg\"\u003e\n      \u003cimg src=\"https://i.ibb.co/sbjwvt4/image2.png\" alt=\"Chose what type you want to download\"\u003e\n   \u003c/a\u003e\n   \u003cp\u003eChose what what resolution you want to download(if the type is video)\u003c/p\u003e\n   \u003ca href=\"https://ibb.co/7ymCS79\"\u003e\n      \u003cimg src=\"https://i.ibb.co/h8z9gpq/image4.png\" alt=\"Chose what resolution you want to download\"\u003e\n   \u003c/a\u003e\n   \u003cp\u003eIf you download a playlist, you can choose what video you want to download, or even all of them\u003c/p\u003e\n   \u003ca href=\"https://ibb.co/0qwkQNm\"\u003e\n      \u003cimg src=\"https://i.ibb.co/1ZS3bV7/Screenshot-from-2024-04-11-16-42-29.png\" alt=\"If you download a playlist, you can choose what video you want to download, or even all of them\"/\u003e\n   \u003c/a\u003e\n\u003cbr /\u003e\u003cbr /\u003e\n \u003cp\u003eDo not know how to use it? just type \u003ccode\u003epyutube --help\u003c/code\u003e\u003c/p\u003e\n  \u003ca href=\"https://ibb.co/LhT6r3r\"\u003e\n      \u003cimg src=\"https://i.ibb.co/WprF0L0/image5.png\" alt=\"image5\"\u003e\n   \u003c/a\u003e\n\u003c/div\u003e\n\n## ⏳ Todo List\n\n- [x] **Notification System**\n- [x] **Auto Update package if new version available**\n- [x] **Support Optional Numbering for Downloaded Playlist Videos**\n- [ ] **Improve code health**\n- [ ] **Support downloading sounds (mp3 format not a audio/mp4)**\n- [ ] **Support Subtitles Download**\n- [ ] **Support setting for downloading folder**\n- [ ] **Download Thumbnails with Videos and Audio**\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhetari%2Fpyutube","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhetari%2Fpyutube","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhetari%2Fpyutube/lists"}