Skip to main content

libasslite

libasslite is a small PyO3 wrapper around the public libass rendering API. It owns the native library, renderer, and track handles and returns copied immutable image layers; no native pointer escapes into Python.

The wheel contains only the wrapper. It loads the parity-tested libass 0.17.1–0.17.5 range from the host at runtime, so applications can use the same system library as mpv. Set LIBASSLITE_LIBRARY or pass library_path= when automatic discovery cannot find it. The separately licensed libasslite-bundle package supplies a self-contained 0.17.5 runtime when installed; an explicit path still wins, and LIBASSLITE_BUNDLE=0 returns to system discovery.

from pathlib import Path

import libasslite

renderer = libasslite.AssRenderer(
    ass_bytes,
    fonts=[("subtitle-font.ttf", font_bytes)],
    library_path=Path("/opt/homebrew/lib/libass.dylib"),
)
result = renderer.render(
    timestamp_ms=1_500,
    frame_size=(1920, 1080),
    storage_size=(1920, 1080),
)
renderer.close()

AssRenderResult.layers preserves libass list order. Each layer contains a tightly packed bytes bitmap (width * height), placement, 0xRRGGBBAA color, and public image type. Rendering releases Python and is serialized per renderer, making one renderer safe to use from background workers.

Installing libass

  • macOS: brew install libass
  • Debian/Ubuntu: install the runtime package providing libass.so.9 (currently libass9)
  • Windows: vcpkg install libass:x64-windows, then point LIBASSLITE_LIBRARY at the produced DLL

An existing mpv installation may already contain a usable library. Pass its exact DLL path rather than copying it elsewhere; adjacent runtime dependencies must remain discoverable by the operating system.

Scope

The package deliberately exposes only in-memory ASS loading, memory fonts, frame/storage geometry, rendering, change detection, and copied image layers. It does not parse token spans, control mpv, schedule work, cache geometry, or bundle fonts/libass.

Licensing

libasslite is MIT. Its wheels do not distribute libass, FriBidi, HarfBuzz, FreeType, or a font provider; the dynamically loaded system installation keeps its own license and deployment obligations. See NOTICE.

Metadata

Release files for libasslite 0.1.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 libasslite 0.1.0
File Size Uploaded
libasslite-0.1.0.tar.gz 17.0 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for libasslite 0.1.0
File
libasslite-0.1.0-cp315-abi3.abi3t-win_amd64.whl CPython 3.15 abi3, abi3t Windows x86-64 Details
libasslite-0.1.0-cp315-abi3.abi3t-manylinux_2_28_x86_64.whl CPython 3.15 abi3, abi3t Linux glibc 2.28+ x86-64 Details
libasslite-0.1.0-cp315-abi3.abi3t-manylinux_2_28_aarch64.whl CPython 3.15 abi3, abi3t Linux glibc 2.28+ ARM64 Details
libasslite-0.1.0-cp315-abi3.abi3t-macosx_11_0_arm64.whl CPython 3.15 abi3, abi3t macOS 11.0+ ARM64 Details
libasslite-0.1.0-cp314-cp314t-win_amd64.whl CPython 3.14 CPython 3.14 free-threading Windows x86-64 Details
libasslite-0.1.0-cp314-cp314t-manylinux_2_28_x86_64.whl CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64 Details
libasslite-0.1.0-cp314-cp314t-manylinux_2_28_aarch64.whl CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ ARM64 Details
libasslite-0.1.0-cp314-cp314t-macosx_11_0_arm64.whl CPython 3.14 CPython 3.14 free-threading macOS 11.0+ ARM64 Details
libasslite-0.1.0-cp313-abi3-win_amd64.whl CPython 3.13 abi3 Windows x86-64 Details
libasslite-0.1.0-cp313-abi3-manylinux_2_28_x86_64.whl CPython 3.13 abi3 Linux glibc 2.28+ x86-64 Details
libasslite-0.1.0-cp313-abi3-manylinux_2_28_aarch64.whl CPython 3.13 abi3 Linux glibc 2.28+ ARM64 Details
libasslite-0.1.0-cp313-abi3-macosx_11_0_arm64.whl CPython 3.13 abi3 macOS 11.0+ ARM64 Details

Total release size: 2.7 MB

Release files / libasslite-0.1.0.tar.gz

Download URL libasslite-0.1.0.tar.gz
Size 17.0 kB
Tags Source
SHA-256 checksum
How to use checksums
aa0ce4f7158506ed8514275249e0e119179e5488661f1b3ffa7ecbf590eab8d1
BLAKE2b-256 checksum
How to use checksums
f4bfc2ad98d827f24b029f07c526b33e7d890c9bef31733b9781162a2cd8403e
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 Aug 16, 2026.

Transparency log

Release files / libasslite-0.1.0-cp315-abi3.abi3t-win_amd64.whl

Download URL libasslite-0.1.0-cp315-abi3.abi3t-win_amd64.whl
Size 157.1 kB
Tags CPython 3.15 Windows x86-64 abi3 abi3t
SHA-256 checksum
How to use checksums
d4f4ccfe133e54c81494549a421e6c772eb498d7a4e7e5717ae5d79d3a5ad122
BLAKE2b-256 checksum
How to use checksums
fe2fa8303b9d21bb7be692c3e63c2608ff4c4e4cefae5ac86db2f395376d4649
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 Aug 16, 2026.

Transparency log

Release files / libasslite-0.1.0-cp315-abi3.abi3t-manylinux_2_28_x86_64.whl

Download URL libasslite-0.1.0-cp315-abi3.abi3t-manylinux_2_28_x86_64.whl
Size 258.7 kB
Tags CPython 3.15 Linux glibc 2.28+ x86-64 abi3 abi3t
SHA-256 checksum
How to use checksums
2c4ee4a936120df84fbc58f0c9044f19f388997b4725944c54abcfae5a206c42
BLAKE2b-256 checksum
How to use checksums
837a3070cbb41241d7920c53093041f850e289b47a25ab02b54358b326126eb7
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 Aug 16, 2026.

Transparency log

Release files / libasslite-0.1.0-cp315-abi3.abi3t-manylinux_2_28_aarch64.whl

Download URL libasslite-0.1.0-cp315-abi3.abi3t-manylinux_2_28_aarch64.whl
Size 246.3 kB
Tags CPython 3.15 Linux glibc 2.28+ ARM64 abi3 abi3t
SHA-256 checksum
How to use checksums
458bf61639e36c7d79bce530a9d34a476aab3eaa216240ece8cd78e4f51a0c21
BLAKE2b-256 checksum
How to use checksums
e8c641695ac7271eb05f981d00a3c51768389cb1eddf9146ccb30ba0a2203c80
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 Aug 16, 2026.

Transparency log

Release files / libasslite-0.1.0-cp315-abi3.abi3t-macosx_11_0_arm64.whl

Download URL libasslite-0.1.0-cp315-abi3.abi3t-macosx_11_0_arm64.whl
Size 232.4 kB
Tags CPython 3.15 abi3 abi3t macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
174543d7d54a5e089eac7ac5261141ceed9e4eec0d1ee525cf3eb5cc1165acc5
BLAKE2b-256 checksum
How to use checksums
287ba887307c04b0fa1b4f89a6f7e142e2ee58e4449504e2cb1ebea539f2621e
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 Aug 16, 2026.

Transparency log

Release files / libasslite-0.1.0-cp314-cp314t-win_amd64.whl

Download URL libasslite-0.1.0-cp314-cp314t-win_amd64.whl
Size 153.0 kB
Tags CPython 3.14 CPython 3.14 free-threading Windows x86-64
SHA-256 checksum
How to use checksums
8a29ee53fd0fe6a0e217ab8c70a2d52d2a437f86350ea1d272782de5723a1d0d
BLAKE2b-256 checksum
How to use checksums
853f581fa50060052613ea5460fa4c45dd4f6e871d34fcb1db42674325c19da2
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 Aug 16, 2026.

Transparency log

Release files / libasslite-0.1.0-cp314-cp314t-manylinux_2_28_x86_64.whl

Download URL libasslite-0.1.0-cp314-cp314t-manylinux_2_28_x86_64.whl
Size 254.9 kB
Tags CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
f293f267a0d9310956bf9a7b0f0af5229a7f24a9bf88c1bc71484173e3e1ac86
BLAKE2b-256 checksum
How to use checksums
a1565dd8b8244f8bdfd23e7444b0529da87f313264f7c2b0eab1abcdafb5f8e4
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 Aug 16, 2026.

Transparency log

Release files / libasslite-0.1.0-cp314-cp314t-manylinux_2_28_aarch64.whl

Download URL libasslite-0.1.0-cp314-cp314t-manylinux_2_28_aarch64.whl
Size 244.7 kB
Tags CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
b0755fcf31813b99781e159bd72e5cd7dfe942ec3bd80dd4512f7ad5819039c7
BLAKE2b-256 checksum
How to use checksums
b07a29d669ee851fd1f84dad847a2a226af1be38110578c5bd09841011c80239
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 Aug 16, 2026.

Transparency log

Release files / libasslite-0.1.0-cp314-cp314t-macosx_11_0_arm64.whl

Download URL libasslite-0.1.0-cp314-cp314t-macosx_11_0_arm64.whl
Size 229.4 kB
Tags CPython 3.14 CPython 3.14 free-threading macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
4fc7b967afde398fbc0c90893973df7c45588066147e9c2b9f4ed474200e0d0c
BLAKE2b-256 checksum
How to use checksums
a5d29e13a06dc54fc526b9404807bba8fb763fb82ae4ae3c11fd58768f51a7ef
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 Aug 16, 2026.

Transparency log

Release files / libasslite-0.1.0-cp313-abi3-win_amd64.whl

Download URL libasslite-0.1.0-cp313-abi3-win_amd64.whl
Size 152.1 kB
Tags CPython 3.13 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
871bd470f48c1ff0c2c8964f5e115beec4723bbf229ca545cdfd92d32662c7a7
BLAKE2b-256 checksum
How to use checksums
0c4493bcff6c0d2ceaa65b4f0b71193d6a8e17c4a28471ab62e7ec68d0d07742
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 Aug 16, 2026.

Transparency log

Release files / libasslite-0.1.0-cp313-abi3-manylinux_2_28_x86_64.whl

Download URL libasslite-0.1.0-cp313-abi3-manylinux_2_28_x86_64.whl
Size 254.7 kB
Tags CPython 3.13 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
3b24bae6df398de8732f1f72cb9b59a7b78d8a25bfda854201938ab091f4cf4a
BLAKE2b-256 checksum
How to use checksums
8aa5e0d3e4d7f1d50d4b7eb3d88bb81c10e468d5fd4bc1f33156c02a91461f31
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 Aug 16, 2026.

Transparency log

Release files / libasslite-0.1.0-cp313-abi3-manylinux_2_28_aarch64.whl

Download URL libasslite-0.1.0-cp313-abi3-manylinux_2_28_aarch64.whl
Size 243.6 kB
Tags CPython 3.13 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
a757bcc86b102e6adca29c57873dd59d4729e5563e6ba4c2817581364b4e9414
BLAKE2b-256 checksum
How to use checksums
13e2db4418f6fc53f571acce0fbbad4e1bb83cb454fef99ccf89db5eaeafe2fa
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 Aug 16, 2026.

Transparency log

Release files / libasslite-0.1.0-cp313-abi3-macosx_11_0_arm64.whl

Download URL libasslite-0.1.0-cp313-abi3-macosx_11_0_arm64.whl
Size 228.2 kB
Tags CPython 3.13 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
d3abc1b271af0d7636e20f71e76c2dbd510db0e1087309f6c89473ea19fba5cd
BLAKE2b-256 checksum
How to use checksums
504c0f9d70d401d04eb5c10c74540b1a6a0a758b9548b4ffc614839a3edc2326
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 Aug 16, 2026.

Transparency log

Release history Release notifications | RSS feed

0.2.1

13 release files

0.2.0

13 release files

0.1.2

13 release files

This release

0.1.0 This release

13 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