Metadata-Version: 2.1
Name: yazdl
Version: 0.1.0
Summary: Download zoom recordings.
Home-page: https://github.com/pvpscript/yazdl
Author: pvpscript
Project-URL: Bug Reports, https://github.com/pvpscript/yazdl/issues
Project-URL: Source, https://github.com/pvpscript/yazdl
Keywords: zoom,recording,downloader
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: certifi>=2024.2.2
Requires-Dist: charset-normalizer>=3.3.2
Requires-Dist: idna>=3.7
Requires-Dist: requests>=2.31.0
Requires-Dist: setuptools>=69.5.1
Requires-Dist: urllib3>=2.2.1
Requires-Dist: wheel>=0.43.0

# yazdl
> Yet Another zoomdl

Download zoom recordings

# Installation
This program can be installed manually, with the source code, using `pip` (in this case we'll be using `pipx` for separated virtual environments) or, in case you are on Windows, use the latest compiled release.

## Using pip
Simply type the following line into a terminal
```sh
pipx install yazdl
```

## Manually
In case you want to install it directly from the source, simply clone this repository and `cd` into it.

Then, run the following command:
```sh
pipx install .
```


# Usage
## Basic usage
```sh
yazdl recording-url.zoom.us/id1 recording-url.zoom.us/id2 ...
```

This will download all the recordings contained in the given URLs, whose content will be shared screen and speaker cam, if applicable.


## General usage
```sh
yazdl urls [options]
```

### Options
```sh
  -h, --help           show a help message and exit.
  --no-speaker, -k     Don't download the speaker screen.
  --no-screen, -c      Don't download the screen share.
  --subtitles, -s      Downloads the default subtitle for the meeting as srt.
  --transcription, -t  Downloads the meeting transcription as srt.
```

# Addendum
Just a few things I'd like to add, at least for now.

## DI
When I started writing this script, I decided to use DI in order to make something reusable, which, after a while I realized how much of a overkill this was for such a simple script. At the end, I didn't use [ABCs](https://docs.python.org/3/library/abc.html) and didn't write any tests, so it was a huge waste of time.

I'll eventually fix this mess and add a few tests, but for now, this project is not my top priority.

## YoutubeDL
After I was done with the downloader, I realized that the famous [youtubedl](https://github.com/ytdl-org/youtube-dl) already had a module that downloads zoom recordings, which consists in a very simple and straightforward code, with just a little over 60 lines and also contains proper testing as well, sooo...

But anyway, their script couldn't properly download th recordings that I had, so maybe thua is not that much useless after all?

The thing is, I will improve this script, eventually.

## Naming
At first, I picked the name **zoomdl** for this project, but, when uploading it to pypi test, I found out that, for no one's surprise, that there [already is a project named zoomdl](https://github.com/Battleman/zoomdl/), and it even turns out to be an archived project, seemingly because of the advent of the aforementioned `youtube-dl` project. So, my go to was to use the classic "_yet another_" naming convention.

Welp... My objective here is not to compete against them in anyway, after all, it's all open software. I don't want this project to be born archived, so I'll be improving it bit by bit, at least for a while.

# TODO
Replace `setup.py` and use [build](https://build.pypa.io/en/stable/) to build the package.

Password streams

Use ABC

Write tests lol
