Metadata-Version: 2.4
Name: auto-yt-dlp
Version: 0.1.1.dev1
Summary: "A feature-rich command-line audio/video downloader" "...with a simple graphical interface".
Home-page: https://github.com/SubFabula/auto-yt-dlp
Author: SubFabula
License: This is free and unencumbered software released into the public domain.
        
        Anyone is free to copy, modify, publish, use, compile, sell, or
        distribute this software, either in source code form or as a compiled
        binary, for any purpose, commercial or non-commercial, and by any
        means.
        
        In jurisdictions that recognize copyright laws, the author or authors
        of this software dedicate any and all copyright interest in the
        software to the public domain. We make this dedication for the benefit
        of the public at large and to the detriment of our heirs and
        successors. We intend this dedication to be an overt act of
        relinquishment in perpetuity of all present and future rights to this
        software under copyright law.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
        IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
        OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
        ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
        OTHER DEALINGS IN THE SOFTWARE.
        
        For more information, please refer to <https://unlicense.org>
        
Project-URL: Source Code, https://github.com/SubFabula/auto-yt-dlp
Project-URL: Bug Tracker, https://github.com/SubFabula/auto-yt-dlp/issues
Project-URL: Q&A, https://github.com/SubFabula/auto-yt-dlp/discussions
Keywords: gui,media-downloader
Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: yt-dlp
Requires-Dist: pywebview
Requires-Dist: qtpy
Requires-Dist: PySide6>=6.10.0
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

<h1 align="center">Auto Youtube Audio/Video Downloader Plus</h1>
<p align="center"><em>"A feature-rich command-line audio/video downloader" "...with a simple graphical interface".</em></p>

<p align="center">
    <img src="https://raw.githubusercontent.com/SubFabula/auto-yt-dlp/main/applook.png" alt="Base Look" height="500px">
</p>

<p align="center">
    <a href="https://pypi.org/project/auto-yt-dlp/"><img src="https://img.shields.io/pypi/v/auto-yt-dlp?pypiBaseUrl=https%3A%2F%2Fpypi.org&logo=pypi&logoSize=auto&label=PyPi&labelColor=%23000000&color=GREEN" alt="PyPI Version"></a>
    <a href="https://test.pypi.org/project/auto-yt-dlp/"><img src="https://img.shields.io/pypi/v/auto-yt-dlp?pypiBaseUrl=https%3A%2F%2Ftest.pypi.org&logo=pypi&logoSize=auto&label=TestPyPi&labelColor=%23000000&color=%23f17e3f" alt="TestPyPi Version"></a>
    <a href="https://pypi.org/project/auto-yt-dlp/"><img src="https://img.shields.io/pypi/pyversions/auto-yt-dlp?pypiBaseUrl=https%3A%2F%2Fpypi.org&logo=python&logoSize=auto&label=Python%20Versions&labelColor=%23000000&color=%230c59d4" alt="PyPI Supported Versions"></a>
    <a href="https://pepy.tech/project/auto-yt-dlp"><img src="https://img.shields.io/pypi/dm/auto-yt-dlp?logoSize=auto&label=PyPi%20Installs&labelColor=%23000000&color=%230c59d4" alt="PyPi Installs Per Month"></a>
    <a href="https://github.com/SubFabula/auto-yt-dlp/releases/latest"><img src="https://img.shields.io/github/downloads/SubFabula/auto-yt-dlp/latest/total?logo=github&logoSize=auto&label=Standalone%20Downloads&labelColor=%23000000&color=%236406b2" alt="Standalone Installs Per Month"></a>
    <a href="https://pypi.org/project/auto-yt-dlp/"><img src="https://img.shields.io/pypi/l/auto-yt-dlp?pypiBaseUrl=https%3A%2F%2Fpypi.org&logo=Unlicense&logoSize=auto&label=License&labelColor=%23000000&color=%235c5c5c" alt="License"></a>
    <a href="https://pyinstaller.readthedocs.io/en/stable/requirements.html"><img src="https://img.shields.io/badge/platforms-Windows-lightgray?label=Platforms&labelColor=%23000000&color=%239f9f9f" alt="Supported Platforms"></a>
</p>

# Showcase
<p align="center">
    <img src="https://raw.githubusercontent.com/SubFabula/auto-yt-dlp/main/appshowcase.gif" alt="Simple Showcase" height="500px">
</p>

# Content
- [How to Install & Use](https://github.com/SubFabula/auto-yt-dlp?tab=readme-ov-file#how-to-install--use)
  1. [PyPi Installation](https://github.com/SubFabula/auto-yt-dlp/edit/main/README.md#1-pypi-installation)
  2. [Standalone (`.exe`) Downloading](https://github.com/SubFabula/auto-yt-dlp/edit/main/README.md#2-standalone-exe-downloading)
  3. [Github Download](https://github.com/SubFabula/auto-yt-dlp/edit/main/README.md#3-github-download)
- [Can i contribute to this?](https://github.com/SubFabula/auto-yt-dlp?tab=readme-ov-file#can-i-contribute-to-this)
- [Report an Issue!](https://github.com/SubFabula/auto-yt-dlp?tab=readme-ov-file#report-an-issue)
  - [Before Reporting...](https://github.com/SubFabula/auto-yt-dlp?tab=readme-ov-file#before-reporting)
- [Other Q&As](https://github.com/SubFabula/auto-yt-dlp/discussions/new/choose)

## How to Install & Use
### [1. PyPi Installation](https://pypi.org/project/auto-yt-dlp)
#### Requirements
- [`Python 3.10`](https://www.python.org/downloads) or higher

#### Installation & Usage
Run these commands in the command prompt/terminal:

1. Run `python -m pip install auto-yt-dlp` to install.
2. Run `python -m auto_yt_dlp` or just `autoytdlp`/`auto-yt-dlp`/`auto_yt_dlp` to start the app.

### 2. Standalone (`.exe`) Downloading
#### Requirements
- A working computer that can run `.exe` files ¯\\_\(ツ)\_/¯

#### Installation & Usage
You can head to the [releases](https://github.com/SubFabula/auto-yt-dlp/releases/latest) section and download the standalone version of the app!

Just put the `.exe` file wherever and double click on it to start it.

### 3. Github Download
#### Requirements
- [`Python 3.10`](https://www.python.org/downloads) or higher

#### Installation & Usage
Follow these steps to download and use the app.

1. Clone/download the repository.
2. Open command prompt/terminal and `cd` into the project's root folder.
3. Run `python -m pip install -r requirements.txt`
4. Run `python -m auto_yt_dlp` to run the application

## Can i contribute to this?
Yes, you can. (And also thanks, i really appreciate it :D)

How?

In whatever you think you can by adding any missing features (by [forking](https://github.com/SubFabula/auto-yt-dlp/fork) it), telling me any mistakes/errors an whatnot from the [issues](https://github.com/SubFabula/auto-yt-dlp/issues/new) (check the ["Report an Issue!"](https://github.com/SubFabula/auto-yt-dlp?tab=readme-ov-file#report-an-issue) title first!) or localizing it to your native language or to the ones you know (just make a fork and translate it. I will do the in-app language settings stuff later.)

## Report an Issue!
> [!NOTE]
> Logging is on by default. So, once you run the app, there will be an `auto_yt_dlp.log` file created in the app folder. If you have any errors or problems, provide the log file as well. Some errors might not have been saved to the log file, make sure to check the console and copy the errors from there too. <br>
> But, if you want to disable this, just go to the `config.py` file in the app folder. Open it, find `LOGGING` and change the `True` to `False`.

You can report any problems from right __[here](https://github.com/SubFabula/auto-yt-dlp/issues/new)__.

### Before Reporting...
> [!NOTE]
> If you get any errors in the Command Output in the app, it's probably something to do with [`yt-dlp`](https://github.com/yt-dlp/yt-dlp) or the way you wrote your `URL` or `Output Path`.

> [!IMPORTANT]
> If you are manually setting your path, don't forget to write the file name and extension at the end of the folder directory. <br>
> Example: `C:\Users\[USERNAME]\Desktop\[FILE_NAME].[FILE_EXTENSION]`<br>
> Another example: `C:\Users\myPC\Desktop\FunnyVideo.mp4`<br>
> <br>
> If you want to keep the audio/video's title and extention, just set the `Output Path` by browsing (the `Browse` button) or, you can just put `%(title)s.%(ext)s` where you would put your file name and extension.<br>
> <br>
> The app will automatically turn any `/` into `\` for the Output Directory since [`yt-dlp`](https://github.com/yt-dlp/yt-dlp) doesn't accept `Output Path`s with`/`.

# TODO
- [x] Make the app launch-able from CMD.
- [x] Make the app and CMD exit together.
- [x] Design the UI in a re-usable way.
- [x] Make the app input CMD codes and run it.
- [x] Upload to PyPi for others to be able to access it easily.
- [ ] Add every other option of [`yt-dlp`](https://github.com/yt-dlp/yt-dlp).
