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. OR Click here to ask ChatGPT.

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.26.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.26.0
File Size Uploaded
annotations2sub-2.26.0.tar.gz 92.8 kB Details

Built distribution (wheel)

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

Total release size: 189.1 kB

Release files / annotations2sub-2.26.0.tar.gz

Download URL annotations2sub-2.26.0.tar.gz
Size 92.8 kB
Tags Source
SHA-256 checksum
How to use checksums
f26ac995955bcaa467d6a45006979833beaf06e134b63838cf76fbd523b83e64
BLAKE2b-256 checksum
How to use checksums
aa0f001ad739c05de9986d282aca315b1676cb003cdd129877878a762d97dbcb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Oct 5, 2026.

Transparency log

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

Download URL annotations2sub-2.26.0-py3-none-any.whl
Size 96.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b8ffc3d1c6e5c2f2809b81da4f9c50213e088a00e461c0ed7a93877f2b3027a4
BLAKE2b-256 checksum
How to use checksums
b1d7c255ef01bfdda76562b910fa2ce04012e3c30b5f06f54a6dc35bf50eee32
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Oct 5, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

2.26.0 This release

2 release files

2.25.0

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