Skip to content
Projects

unhappychoice/splashboard has 234 GitHub stars and 4 forks. GitHot measured +1 stars in 24 hours and +2 in 7 days. Last checked 2026-11-15 14:03 UTC. Last push 2026-11-15.

How these counts are measured

Measured star growth

in 24h
+1
in 7 days
+2
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

A customizable terminal splash screen with plugin-based data sources.

Developer Tools

README.md

Original

splashboard

crates.io release CI coverage license

A customizable terminal splash rendered on shell startup and on cd.
splashboard = splash + dashboard

Instead of a blinking cursor, every new shell shows a dashboard of the things you actually care about — greetings, git status, CI health, PRs, a contributions heatmap, the moon phase. The killer feature: a repo that ships ./.splashboard/dashboard.toml auto-reshapes the splash when you cd in, so different repos get different splashes for free.

Install

curl -fsSL https://raw.githubusercontent.com/unhappychoice/splashboard/main/install.sh | bash
Other install methods
# cargo
cargo install splashboard

# Homebrew (macOS / Linux)
brew install unhappychoice/tap/splashboard

# cargo-binstall (prebuilt binaries from GitHub Releases)
cargo binstall splashboard

# Nix flake
nix run github:unhappychoice/splashboard
nix profile install github:unhappychoice/splashboard

Prebuilt binaries for Linux (x86_64 / aarch64), macOS (x86_64 / aarch64), and Windows (x86_64) are also attached to each GitHub Release.

splashboard install then detects your shell, walks you through template / theme pickers, and wires your rc for you.

splashboard install

Prefer to own the rc edit yourself? Append one line that re-sources splashboard init <shell> on every shell start — upgrades to splashboard ship an updated init snippet automatically:

echo 'eval "$(splashboard init zsh)"'                              >> ~/.zshrc
echo 'eval "$(splashboard init bash)"'                             >> ~/.bashrc
echo 'splashboard init fish | source'                              >> ~/.config/fish/config.fish
echo 'Invoke-Expression (& splashboard init powershell | Out-String)' >> $PROFILE
splashboard init nushell | save --append ~/.config/nushell/config.nu

Docs

📖 https://splashboard.unhappychoice.com/

  • Getting started — install, wire your shell, render your first splash
  • Concepts — the mental model (Widget = Fetcher + Renderer + Layout slot)
  • Configuration — the full TOML schema
  • Presets & Themes — curated dashboards and palettes
  • Trust model — how per-directory configs are sandboxed
  • Watch mode — persistent foreground dashboard via splashboard watch
  • Reference — every fetcher and renderer with options and compatible shapes

Status

Usable day-to-day. Widget catalog tracked as a living roadmap in issue #41 — new fetchers and renderers land as PRs that tick the checkboxes.

License

ISC

Related

  • gitlogue — cinematic git history replay
  • gittype — CLI typing game from your source code
  • mdts — local Markdown tree server

Support

If you find this project useful, please consider:

Every bit of support helps. Thanks!