Metadata-Version: 2.1
Name: justsubs
Version: 0.1.1
Summary: Download subtitles from YouTube as plain text.
Home-page: https://github.com/epogrebnyak/justsubs
License: MIT
Author: Evgeny Pogrebnyak
Author-email: e.pogrebnyak@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: yt-dlp (>=2024.3.10,<2025.0.0)
Project-URL: Repository, https://github.com/epogrebnyak/justsubs
Description-Content-Type: text/markdown

# justsubs

Download subtitles from YouTube as plain text

Based on [gist by glasslion](https://gist.github.com/glasslion/b2fcad16bc8a9630dbd7a945ab5ebf5e).

2024-03-23: Tested on Windows, may fail on Linux.

## Install

```console
pip install justsubs
```

Latest:

```console
git clone https://github.com/epogrebnyak/justsubs.git
cd justsubs
pip install -e .
```

## Usage

### 1. List subtitle options

```python
from justsubs import Video

video = Video("KzWS7gJX5Z8")
video.list_subs()
```

From the output above you will need a language slug like
`en-uYU-mmqFLq8` as simple `en` might not work.

### 2. Download subtitles

```python
subs = Video("KzWS7gJX5Z8").subtitles(language="en-uYU-mmqFLq8")
subs.download()
```

### 3. Print as plain text

```python
print(subs.get_plain_text()[:500])
```

