lullaby

README

lullaby

lullaby automatically minimizes windows hidden behind others.

Usage

1. Run lullaby.exe to see the icon in the system tray.
2. lullaby.yaml is created on the first run in the same directory (or %APPDATA%\lullaby\).
3. By default, it scans and minimizes hidden windows every 10 minutes.

Tray Menu

• Stop / Resume: Toggle minimization.
• Run (or double click on the tray icon): Trigger minimize immediately.
• Configure: Open lullaby.yaml in your text editor.
• Restart: Restart the application reloading its configuration.
• Exit: Quit the application.

Configuration (lullaby.yaml)

Item	Type	Default	Description
intervals	Duration	10m	Scan/minimization interval.
overlap_threshold	int	50	Overlap percentage to trigger minimization (1-100).
alpha_threshold	int	70	Alpha threshold (1-100) for a window to be considered "covering".
stay_behind_topmost	bool	true	If true, topmost windows do not considered "covering"".
exclude_titles	string[]	[]	List of substrings to exclude windows by title.
exclude_classes	string[]	[]	List of substrings to exclude windows by class name.
running	bool	true	Stop / Resume state.
log.file_name	string	lullaby.log	Log file name.
log.append	bool	false	Whether to append to or overwrite the log.
log.level	string	info	Log level (debug, info, warning, error).