bruhanimate

Composable terminal animations for Python

Run a built-in effect, combine layers, or animate snapshots from your own solver. One player handles timing, input, changed-cell rendering, and terminal cleanup. Requires Python 3.13 or newer.

from bruhanimate import play

play("snow", preset="light", fps=60, updates_per_second=30)

Press q, Escape, or Ctrl+C to quit and restore the terminal.

Start here

• New to the library? Follow Getting started to install and run a demo.

• Building your own animation? Read Core concepts for state, drawing, layers, and the animation lifecycle before diving into the API.

• Visualizing Advent of Code? Use Solver playback and Grid viewport to connect a snapshot generator to board drawing and interactive playback controls.

• Upgrading from 0.2.x? Follow Migrating to 1.0; v1 removes the old renderers.

• Contributing or publishing? Use Contributing and Release process.

Learn

• Getting started
• Discover effects, presets, and settings
• Water, smoke, cloth, and procedural worlds
• Seeded capture and recording
• SVG, PNG, GIF, and MP4 export
• Paths, pulses, and ripples
• Panels, layer clocks, and temporary overlays
• ASCII images, transitions, masks, and styling
• Animation sequences
• Core concepts

Guides and API

• Player and composition
  • Animation contract
  • Timing and composition
  • API
• Movable panels
  • Create a moving effect
  • Discovery and options
  • Clipping, motion, and stacking
  • Ownership, completion, and input
  • API
• Layouts and text widgets
  • A small dashboard
  • Typed layout options
  • Effects and panels in slots
  • Labels and dynamic text
  • Status bars
  • Ownership, completion, and limitations
  • API
• Keyboard bindings and focus
  • An interactive panel
  • Discovering keys and actions
  • Routing and explicit quit
  • Visibility, resize, and ownership
  • API
• Scrollable views and activity logs
  • A focused activity log
  • Log options and retention
  • Following and preserving your place
  • A larger animation canvas
  • Shared navigation and lifecycle
  • API
• Terminal resize
  • What survives
  • Panels and simulations
  • Custom animations
  • Backend behavior and limits
  • API
• Solver playback
  • Playback
• Grid viewport
  • GridViewport
  • draw_grid()
• Migrating to 1.0
• Bruheffect
  • Overview
  • Effects
• Terminal utilities
  • Bruherrors
  • Bruhffer
  • Bruhimage
  • Bruhscreen
  • Bruhtypes
  • Utils
• Demos
  • Overview
  • Available Demos

Project

• Contributing
• Rendering performance
• Native platform checks
• Release process
• Release 1.3.0