animpy 1.5.8

A simple terminal animation library

Animpy 🎬

Make cool terminal animations without the pain. Move text around, use RGB colors, play audio, and build actual animations. Works great on modern terminals.

Examples

• Particle simulation
• The zen of python
• Audio example
• Loading screen
• Tag game
• Collision example
• Player Controls
• Linear interpolation

Install

pip install animpy

Quick Start

import animpy

scene = animpy.Scene()
text = animpy.Text("Hello!", 10, 5, r=255, g=100, b=50)
scene.add(text)
scene.render()

How It Works

Text – Create animated text:

text = animpy.Text("Hi", 0, 0, r=255, g=0, b=0)
text.moveX(10)  # Move right
text.moveY(5)   # Move down
text.centerX()  # Center horizontally
text.change_rgb_values(0, 255, 0)  # Change color
text.collides_with(other_text)  # Check collision with another text
text.on_collide_callback(other_text, callback)  # Set a callback for when it collides with another text
text.width, text.height  # Get dimensions
text.type_out("Type me!", speed=0.05, scene=scene)  # Type effect
text.fall(velocity=2, floor=15)  # Falling effect
text.change_frame()  # Cycle through frames (if you used a list)

Group – Group multiple texts together:

group = animpy.Group(text1, text2, text3)
group.add(text4)  # Add another text to the group
group.remove(text2)  # Remove text2 from the group
group.position(5, 0)  # Move the entire group right by 5

Scene – Render everything:

scene = animpy.Scene()
scene.add(text1, text2, text3)
scene.remove(text2)  # Remove text2 from the scene
scene.render()
scene.set_bg_rgb(0, 0, 255)  # Set background color to blue
scene.clear()
scene.shake(intensity=2)  # Shake the scene
scene.dt  # Get time since last frame (for smooth movement)

Interactive Scene – Handle real-time input:

scene = animpy.Scene()
scene.add(text1, text2, text3)
scene.remove(text2)  # Remove text2 from the scene
scene.render()
scene.set_bg_rgb(0, 0, 255)  # Set background color to blue
scene.clear()
scene.shake(intensity=2)  # Shake the scene
scene.key_pressed("w")  # Check if 'w' is pressed
scene.dt  # Get time since last frame (for smooth movement)
scene.wall  # Get the x-coordinate of the right/left wall
scene.floor_ceiling  # Get the y-coordinate of the floor/ceiling

Audio – Play sounds:

audio = animpy.Audio()
audio.load("bg", "music.mp3")
audio.play("bg", loop=-1)
audio.stop_all()
audio.is_playing("track")

Animpy (extras) – Some extra methods for animations:

animpy.lerp(start, end, t)  # Linear interpolation between start and end

Support the project

Version History

v1.5.8

• Added exclusive floor, wall, and ceiling properties to InteractiveScene for better control over movement boundaries

v1.5.5

• Added new Group class for grouping multiple Text objects together and moving them as a unit
• Added collision detection method on_collide_callback to Text class for triggering callbacks when two Text objects collide

v1.5.1

• Added full guide to project folder

v1.5.0

• Added linear interpolation function lerp to animpy for smooth animations
• Added dt property to Scene for easy frame timing and smooth movement
• Added z-index support to Text for layering items in the scene
• Added scene shaking effect with shake method for dramatic animations

v1.4.5

• Added background color support to Scene with set_bg_rgb method

v1.4.1

• Added scene.remove method to remove items from the scene

v1.4.0

• Added three new examples to Github example folder
• Added new class InteractiveScene that allows for real-time keyboard input
• Added collision detection method collides_with to Text class

v1.3.8

• Added audio.is_playing() method to check if audio is currently playing
• Added two more examples to Github example folder

v1.3.5

• Added scene.clear method to clear the scene
• Added version history to README

Made with ❤️ by a human.