Skip to content

About

Pixel cherry blossoms for cliamp: petals pile up in drifts, beats make them jump

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

hanami

Pixel cherry blossoms for cliamp. Petals fall and pile up into drifts, and the music moves them.

hanami visualizer

  • Petals and whole blossoms drift down at an angle and tumble as they fall. Near ones are bigger and brighter than far ones.
  • Fallen petals pile up into soft drifts, and the wind piles them higher in a few spots. The drifts slowly melt, so they never bury the screen.
  • The crest of the drifts glows with the spectrum: bass on the left, treble on the right.
  • On a beat, the drifts jump, a handful of petals is torn from the sky, and a gust of wind blows. Louder music brings a denser fall.
  • Each terminal cell holds 2×4 solid pixels, drawn with Unicode 16 octants, so the pixels are almost square.

Install

cliamp plugins install niteover/cliamp-plugin-hanami

Press v in cliamp until you reach hanami. You can also select it from the Ctrl+V picker, or set it as the default in ~/.config/cliamp/config.toml:

visualizer = "hanami"

Press V for full screen, where it looks best.

Configuration

All settings are optional. Add the ones you need to ~/.config/cliamp/config.toml:

[plugins.hanami]
# colours (these are the defaults)
far   = "#c45c90"   # distant petals
mid   = "#ec74a6"   # middle petals
near  = "#ff9fc2"   # near petals, light crest
flash = "#ff4d6d"   # petals torn loose by a beat, glowing crest
pile  = "#e0435f"   # tint of fallen petals, blossom centres

# "octant" (default, 2x4 pixels per cell) or "quadrant" (2x2, works almost everywhere)
glyphs = "octant"

Terminal support

hanami needs true colour and a terminal that can draw Unicode 16 octants (U+1CD00–U+1CDE5). Some terminals draw these block characters themselves. In others, your font must contain them.

  • Tested in foot, which draws octants natively.
  • If you see empty boxes or question marks instead of petals, set glyphs = "quadrant". It uses the classic 2×2 quadrant blocks (▘▝▖▗▚▞), which almost every terminal and font has. Petals look chunkier, but nothing else changes.

Performance

cliamp gives a visualizer 50 ms per frame. hanami usually needs 5–25 ms. In a huge full-screen terminal, such as 4K with a small font, it thins out the petals until frames fit again.

License

MIT

About

Pixel cherry blossoms for cliamp: petals pile up in drifts, beats make them jump

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages