Skip to content

Arabic Text Animator

Welcome to Arabic Text Animator, a Python library for creating beautiful Arabic text writing animations.

Features

  • 🎨 Create smooth writing animations for Arabic text
  • 🔠 Support for RTL text rendering
  • 📐 Flexible positioning and layout system
  • 🎯 Easy-to-use API
  • 🎬 Export to various video formats
  • 🖥️ Live preview during development
  • ⚙️ Command-line interface with preview and render options

Installation

pip install arabic-text-animator

Basic Usage

from arabic_animations.core.scene import Scene
from arabic_animations.core.text import Text
from arabic_animations.core.position import Position, Padding
from arabic_animations.core.color import Color, Colors, Style

# Create scene
scene = Scene(width=1920, height=1080)

# Create text with styling
text = Text(
    "بسم الله الرحمن الرحيم",
    position=Position.TOP,
    padding=Padding(top=50),
    style=Style(
        stroke_color=Color.from_hex("#B8860B"),
        fill_color=Color.from_hex("#FFD700"),
        stroke_width=3.0
    ),
    write_duration=2.0
)

scene.add(text)

Command Line Usage

# Preview animation
ata render my_animation.py --preview

# Render to video
ata render my_animation.py --output my_animation.mp4

Contributing

We welcome contributions! Check out our GitHub repository for:

  • Source code
  • Issue tracking
  • Feature requests
  • Pull requests

License

This project is licensed under the MIT License - see the LICENSE file for details.