Skip to main content

Scroll Art

Scroll art is moving ASCII art produced by stdout text printed from a loop, "animated" as the text scrolls up the terminal.

"Scroll art" was coined by Al Sweigart. The simplicity of scroll art means that it's useful as a programming project for beginners. Scroll art can be made in any programming language. This package contains a large collection of scroll art, as well as functions for creating your own scroll art. You can see examples of scroll art at https://scrollart.com

Quickstart

Install the scrollart package by running pip install scrollart and see which demos are available by running python -m scrollart --help.

For example, you can run python -m scrollart starfield or python -m scrollart ducklings.

Here's the output of the help text:

ScrollArt - Various animated scroll art displays

positional arguments:
  {starfield,stripeout,twists,tsuro,pipe_swap,skybursts,forth_and_back,moire,skulls_and_hearts,pac_wall,inchworm,connected_pipes,diagonal_sweep,earthworm_tunnels,towers_and_towers,any_size_diagonal_maze,thorns,triangle_hall,vertical_struts,hex_portals,toggler1,toggler2,tri_grid_scaffold,orbital_travels,snail_trail,password_cracker,dna,spike,zigzag,diamond_sky,ducklings,full_of_squares,in_and_out,matrix,sine_message,proton_stream,striped_triangles,math_func,cube_wall,bundfc}
                        The scroll art command to run

options:
  -h, --help            show this help message and exit

Available commands:
  starfield         - Animated starfield with pulsing density of stars
  stripeout         - Alternating fill/empty effect with block or random patterns  
  twists            - Vertical columns that twist around each other
  tsuro             - Infinite maze-like patterns using interconnected tiles
  pipe_swap         - Vertical pipes that occasionally swap positions
  skybursts         - Random firework-like bursts radiating from points
  forth_and_back    - Block that bounces back and forth with acceleration
  moire             - Overlapping circles with sine wave creating moire patterns
  skulls_and_hearts - Hearts floating over a background of skull patterns
  pac_wall          - Vertical columns of alternating characters and spaces
  inchworm          - Animated worm that stretches and bunches as it moves
  connected_pipes   - Network of connected pipes using box-drawing characters
  diagonal_sweep    - Diagonal sweep pattern that alternates between on and off
  earthworm_tunnels - Worms digging tunnels through dirt that grows back
  towers_and_towers - Animated tower construction with overlapping structures
  any_size_diagonal_maze - Diagonal maze pattern with random forward and back slashes
  thorns             - Random length thorn lines centered on screen
  triangle_hall      - Animated strut points creating triangular patterns
  vertical_struts    - Vertical struts with horizontal crossbeams at random positions
  hex_portals        - Hexagonal portals with optional interior patterns
  toggler1           - Moving togglers that flip characters between two states
  toggler2           - Paired togglers creating triangular wave patterns
  tri_grid_scaffold  - Triangular grid scaffolding with varying density
  orbital_travels    - Multiple characters orbiting in sine wave patterns
  snail_trail        - Animated snails leaving trails as they crawl across
  password_cracker   - Matrix-style password cracking animation
  dna                - Animated DNA double helix structure
  spike              - Growing and shrinking spike pattern using terminal width
  zigzag             - Simple zig zag animation that bounces left and right
  diamond_sky        - Falling diamonds of various sizes with random patterns
  ducklings          - Screensaver of many adorable ducklings
  full_of_squares    - Falling squares using Unicode box-drawing characters
  in_and_out         - Travelers moving in and out from screen edges with dynamic capacity
  matrix             - Matrix-style digital rain with falling streams of characters
  sine_message       - Message that oscillates horizontally using sine wave motion
  proton_stream      - Multiple streams that move while maintaining distance constraints
  striped_triangles  - Animated triangular patterns with changing density
  math_func          - Mathematical visualization using Unicode block characters
  cube_wall          - Wall of 3D cubes with random shading patterns
  bundfc             - Architectural waves inspired by Shanghai's Bund Financial Center

Release files for scrollart 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for scrollart 0.2.1
File Size Uploaded
scrollart-0.2.1.tar.gz 25.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for scrollart 0.2.1
File Interpreter ABI Platform
scrollart-0.2.1-py3-none-any.whl Python 3 none any Details

Total release size: 50.3 kB

Release files / scrollart-0.2.1.tar.gz

Download URL scrollart-0.2.1.tar.gz
Size 25.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c7df47d36a1176b2290288d2eb9c7c765cb31ed1b9e46faae97252f77ebd2404
BLAKE2b-256 checksum
How to use checksums
bf592054b408adc1e9d6d95aebada81bf3a1c60db6a5f152e3da2e9dea982d9c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Release files / scrollart-0.2.1-py3-none-any.whl

Download URL scrollart-0.2.1-py3-none-any.whl
Size 25.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b81656c8d4e3cf1c605eceea0939e6c1d9e2c28f8f8239ff0961182559f712d9
BLAKE2b-256 checksum
How to use checksums
6b019d6bfe0b9d57307981f26d36009f268779fe9313d7188c2d48288915c09a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Release history Release notifications | RSS feed

This release

0.2.1 This release

2 release files

0.2.0

2 release files

0.1.0

2 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