Screensaver

SS-01 // SCREENSAVER

omfreebdy includes a screensaver powered by Terminal Text Effects (tte). It launches a fullscreen terminal that displays animated text art, triggered automatically after 2.5 minutes of idle time.

Screensaver running with tte effect

Screensaver running with tte effect

How It Works

The screensaver is a terminal application running tte (Terminal Text Effects) in a fullscreen Ghostty or Foot window. It displays the omfreebdy branding text with random animated effects that cycle continuously.

Idle Chain

After	Action
2.5 minutes	Screensaver starts (if not already locked)
5 minutes	Lock screen (hyprlock)
5.5 minutes	Display off (DPMS)

Any keypress or mouse movement dismisses the screensaver.

Available Effects

tte includes dozens of effects. The screensaver picks a random one each cycle:

Effect	Description
matrix	Matrix-style falling characters
rain	Characters rain down the screen
burn	Text burns away
fireworks	Characters explode like fireworks
decrypt	Text decryption animation
waves	Flowing wave patterns
beams	Laser beam effects
blackhole	Characters get pulled into a void
bubbles	Floating bubble animation
synthgrid	Retro synth grid

Run tte --help to see all available effects.

Configuration

The screensaver branding text is at ~/.config/omfreebdy/branding/screensaver.txt. Edit it to customize what’s displayed.

The idle timeout is configured in ~/.config/hypr/hypridle.conf.

Installation

tte is installed via pip:

pip install terminaltexteffects

Customization

To disable the screensaver while keeping the lock screen:

# The screensaver checks for this file
touch ~/.local/state/omfreebdy/toggles/screensaver-off

To force-start the screensaver:

screensaver-launch