A ctypes API for rlottie, with additional functions for getting Pillow Image and animated sequences, as well as telegram animated stickers (tgs).
See example/example.py for example usage.
The functions mostly follow rlottie/inc/rlottie_capi.h
Documentations: https://rlottie-python.readthedocs.io/en/latest/
Note that rlottie is included in the wheel package, you need not install librlottie.
To install, run the following:
pip3 install rlottie-pythonPillow is optional dependency. It is required for render_pillow_frame(),
save_frame() and save_animation(). To also install Pillow, run:
pip3 install rlottie-python[full]Getting information about an lottie animation
from rlottie_python import LottieAnimation
anim = LottieAnimation.from_file("samples/sample.json")
frames = anim.lottie_animation_get_totalframe()
print(f"{frames = }")
width, height = anim.lottie_animation_get_size()
print(f"{width, height = }")
duration = anim.lottie_animation_get_duration()
print(f"{duration = }")
totalframe = anim.lottie_animation_get_totalframe()
print(f"{totalframe = }")
framerate = anim.lottie_animation_get_framerate()
print(f"{framerate = }")
render_tree = anim.lottie_animation_render_tree(0)
print(f"{render_tree.mMaskList.size = }")
mapped_frame = anim.lottie_animation_get_frame_at_pos(0)
print(f"{mapped_frame = }")Rendering and saving frame
from rlottie_python import LottieAnimation
from PIL import Image
anim = LottieAnimation.from_file("samples/sample.json")
# Method 1: Saving the frame to file directly
anim.save_frame("frame30.png", frame_num=30)
# Method 2: Getting Pillow Image
im = anim.render_pillow_frame(frame_num=40)
im.save("frame40.png")
# Method 3: Getting buffer
buffer = anim.lottie_animation_render(frame_num=50)
width, height = anim.lottie_animation_get_size()
im = Image.frombuffer("RGBA", (width, height), buffer, "raw", "BGRA")
im.save("frame50.png")Loading from JSON file, string of JSON, tgs; and rendering animation
from rlottie_python import LottieAnimation
# Loading from file
anim = LottieAnimation.from_file("samples/sample.json")
anim.save_animation("animation1.apng")
anim = LottieAnimation.from_tgs("samples/sample.tgs")
anim.save_animation("animation2.gif")
with open("samples/sample.json", encoding="utf-8") as f:
data = f.read()
anim = LottieAnimation.from_data(data=data)
anim.save_animation("animation3.webp")You may also load animation using with statement
from rlottie_python import LottieAnimation
with LottieAnimation.from_file("samples/sample.json") as anim:
anim.save_animation("animation4.apng")Notice, if you are running on Linux and want to use rlottie_python in main process
and child processes spawned by multiprocessing.Process, you may have to change
start method to spawn, or else deadlock may occur:
if __name__ == "__main__":
multiprocessing.set_start_method("spawn")The lottie (https://pypi.org/project/lottie/) python package is also capable of working with lottie files and telegram animated stickers (tgs). It is also able to support many input/output formats and vector graphics, without any dependency on extenral libraries such as librlottie. However some images it creates is broken (Example1 Example2). It seems librlottie is more stable in terms of rendering frames.
The pyrlottie (https://pypi.org/project/pyrlottie/) python package is also able to convert lottie and tgs files to webp/gif. However, it works by calling executables gif2webp and lottie2gif with subprocess, and it does not support macOS.
To build wheel, run the following:
git clone --recursive https://github.com/laggykiller/rlottie-python.git
cd rlottie-python
# To build wheel
python3 -m build .
# To install directly
pip3 install .To run tests:
pip install pytest
pytestTo lint:
pip install ruff mypy isort
mypy
isort .
ruff check
ruff format