Metadata-Version: 2.4
Name: Annotations2Sub
Version: 2.24.0
Summary: Convert Youtube Annotations to subtitles.
Author-email: 我如天翼 <wrtyis@outlook.com>
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/USED255/Annotations2Sub
Project-URL: Bug Tracker, https://github.com/USED255/Annotations2Sub/issues
Keywords: Youtube,Annotations,Subtitles,Converter
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
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: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Natural Language :: English
Classifier: Typing :: Typed
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Annotations2Sub

Convert Youtube Annotations to subtitles.

[![License GPLv3](https://img.shields.io/pypi/l/Annotations2Sub?color=1)](https://pypi.org/project/Annotations2Sub/)
[![Test](https://github.com/USED255/Annotations2Sub/actions/workflows/test.yml/badge.svg)](https://github.com/USED255/Annotations2Sub/actions/workflows/test.yml)
[![codecov](https://codecov.io/gh/USED255/Annotations2Sub/branch/master/graph/badge.svg?token=SSNQNEAXMP)](https://codecov.io/gh/USED255/Annotations2Sub)
[![Version](https://img.shields.io/pypi/v/Annotations2Sub)](https://pypi.org/project/Annotations2Sub)
[![Python version](https://img.shields.io/pypi/pyversions/Annotations2Sub)](https://pypi.org/project/Annotations2Sub)

---

Before you begin, please make sure you have Python, the YouTube annotations XML file, a video player, the corresponding video file, and any necessary background knowledge ready.

Installation:

```bash
pip install Annotations2Sub
```

Convert Annotations:

```bash
Annotations2Sub XXXXXXXXXXX.xml
```

Then use a video player to play the video with the output subtitle file.

---

YouTube Annotations was a feature launched by YouTube in 2008 that allowed video creators to add text, links, and interactive elements to their videos in order to enhance the viewing experience. YouTube removed this feature in 2019.

ASS (Advanced SubStation Alpha) is a common external subtitle format. Compared to other subtitle formats, it can set fonts, colors, positions, and even add images and effects to enhance your viewing experience.

This tool can help you convert YouTube annotations into ASS subtitle files, which you can then play or add to your videos. If you do not need this feature, it is recommended to use [AnnotationsRestored](https://github.com/isaackd/AnnotationsRestored).

Acknowledgments:
[omarroth](https://www.reddit.com/r/DataHoarder/comments/al7exa/youtube_annotation_archive_update_and_preview/),
[Nirbheek Chauhan](https://github.com/nirbheek/youtube-ass),
[Zhenye Wei](https://github.com/weizhenye/ASS/wiki/ASS-字幕格式规范),
[Invidious](https://invidious.io/),
[Isaac](https://github.com/isaackd/annotationlib),
[Eva](https://github.com/po5/assnotations),
[Internet Archive](https://archive.org/),
[Gemini 1.5 Pro](https://deepmind.google/models/gemini/pro/),
[Rain Shimotsuki](https://www.youtube.com/@rain_shimotsuki),
[KeksusGSPB](https://www.youtube.com/watch?v=c1iCjpxDxz4),
[XNX.ROmania](https://web.archive.org/web/20230227230532/https://www.youtube.com/watch?v=M2ryDEyyrXE).
