Skip to content

retlehs/ansimotd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ansimotd

Website X Bluesky

Display random ANSI art in your terminal as a message of the day. For a browser version, visit ansimotd.com.

  • Selects a random ANSI art file with valid SAUCE metadata
  • Ensures art fits your terminal width
  • Converts ANSI color codes to 24-bit true-color escape sequences using exact VGA RGB values, so art displays accurately regardless of your terminal's color scheme
  • Art sourced from 16colo.rs

Example MOTD

Installation

macOS

brew tap retlehs/tap
brew install retlehs/tap/ansimotd

Ubuntu/Debian

curl -fsSL https://apt.ansimotd.com/install.sh | sudo sh

Go

go install github.com/retlehs/ansimotd@latest

Download art

ansimotd ships without any art — you need to download at least one pack before it can display anything. A good starting point:

ansimotd download 1996
ansimotd download 1997
ansimotd download 1998
ansimotd download 1999

Shell integration

Add to your shell RC file (.bashrc, .zshrc, etc.) to display a random piece of art each time you open a terminal:

ansimotd

Usage

# Display a random ANSI art file
ansimotd

# Display a specific file
ansimotd display --file /path/to/art.ans

Targeted downloads

# Filter by group
ansimotd download 1996 --group ice

# Download a specific pack
ansimotd download 1999 --pack bmbook20

Other commands

# Print the path of the last displayed file
ansimotd last

# Print version
ansimotd --version

Configuration

Environment variable Description Default
ANSIMOTD_DIR Root directory for all ansimotd data $XDG_CONFIG_HOME/ansimotd or ~/.config/ansimotd

All paths derive from the root:

Path Purpose
$ROOT/art/ Downloaded art packs
$ROOT/last Path to the last displayed file

Credits

Based on zsh-ansimotd by yuhonas, with significant modifications including accurate VGA color rendering, SAUCE-aware line wrapping, and the 16colo.rs download client.

About

Display random ANSI art in your terminal as a MOTD

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages