Skip to main content

Annotations2Sub

Convert Youtube Annotations to subtitles.

License GPLv3 Test codecov Version Python version

Click here to view the full document. 点击我查看中文自述.


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:

pip install Annotations2Sub

Convert Annotations:

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.

Acknowledgments: omarroth, Nirbheek Chauhan, Zhenye Wei, Invidious, Isaac, Eva, Internet Archive, Gemini 1.5 Pro, Rain Shimotsuki, tripflag, KeksusGSPB, XNX.ROmania.

Metadata

Release files for Annotations2Sub 2.25.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Annotations2Sub 2.25.0
File Size Uploaded
annotations2sub-2.25.0.tar.gz 81.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for Annotations2Sub 2.25.0
File Interpreter ABI Platform
annotations2sub-2.25.0-py3-none-any.whl Python 3 none any Details

Total release size: 167.2 kB

Release files / annotations2sub-2.25.0.tar.gz

Download URL annotations2sub-2.25.0.tar.gz
Size 81.8 kB
Tags Source
SHA-256 checksum
How to use checksums
da3650ec1ae952cf1a754467bc00864e98e3e77b373f2fb1fbe04797419906e3
BLAKE2b-256 checksum
How to use checksums
dc7ecd605182ec930c320fef98d9c74d26cef460fd4a298d61ec9fe24f6d4a62
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 11, 2026.

Transparency log

Release files / annotations2sub-2.25.0-py3-none-any.whl

Download URL annotations2sub-2.25.0-py3-none-any.whl
Size 85.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
14ee1f399b78813fe2ef8071c21e9d2da3cb4de98fbf16a2e4f9d661212952b6
BLAKE2b-256 checksum
How to use checksums
b278f3dc56edc4d304879054eb92a6ac7c8812b167f244795ad75d1e886e96bd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 11, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

2.25.0 This release

2 release files

2.24.0

2 release files

2.23.0

2 release files

2.22.0

2 release files

2.20.0

2 release files

2.17.0

2 release files

2.15.1

2 release files

2.15.0

2 release files

2.13.0

2 release files

2.9.0

2 release files

2.8.0

2 release files

2.7.0

2 release files

2.6.0

2 release files

2.5.0

2 release files

2.3.0

2 release files

2.2.0

2 release files

2.1.0

2 release files

2.0.0

2 release files

0.1.52

2 release files

0.1.37

2 release files

0.1.36

2 release files

0.1.35

2 release files

0.1.34

2 release files

0.1.33

2 release files

0.1.17

2 release files

0.1.16

2 release files

0.1.13

2 release files

0.1.11

3 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page