Paths and Files

Paths and Files

This page summarizes the paths UnixNotis uses at runtime.

Configuration

• Config: $XDG_CONFIG_HOME/unixnotis/config.toml
• Fallback: $HOME/.config/unixnotis/config.toml

Theme CSS

• $XDG_CONFIG_HOME/unixnotis/base.css (fallback: $HOME/.config/unixnotis/base.css)
• $XDG_CONFIG_HOME/unixnotis/panel.css (fallback: $HOME/.config/unixnotis/panel.css)
• $XDG_CONFIG_HOME/unixnotis/popup.css (fallback: $HOME/.config/unixnotis/popup.css)
• $XDG_CONFIG_HOME/unixnotis/widgets.css (fallback: $HOME/.config/unixnotis/widgets.css)
• $XDG_CONFIG_HOME/unixnotis/media.css (fallback: $HOME/.config/unixnotis/media.css)

Shareable presets

• Preset bundles are user-created .unixnotis files
• They can be stored anywhere, not only under the config root
• Typical usage:
  • noticenterctl preset export my-theme.unixnotis
  • noticenterctl preset inspect my-theme.unixnotis
  • noticenterctl preset import my-theme.unixnotis
• preset import may create dated Backup-* directories under the config root when local files are overwritten

Installer settings

• Installer config: $XDG_CONFIG_HOME/unixnotis/installer.toml
  • Fallback: $HOME/.config/unixnotis/installer.toml
  • Controls backup retention for reset/restore.
  • Default:
    • [backups] keep = 3

Backups (reset/restore)

• Backups live under: $XDG_CONFIG_HOME/unixnotis/Backup-YYYY-MM-DD
• Fallback: $HOME/.config/unixnotis/Backup-YYYY-MM-DD
• Multiple resets on the same day add a numeric suffix:
  • Backup-YYYY-MM-DD-001, Backup-YYYY-MM-DD-002, ...
• Old backups are pruned to the configured keep count.

State

• $XDG_STATE_HOME/unixnotis/state.json
• Fallback: $HOME/.local/state/unixnotis/state.json

Binaries (installer)

• $HOME/.local/bin/unixnotis-daemon
• $HOME/.local/bin/unixnotis-center
• $HOME/.local/bin/unixnotis-popups
• $HOME/.local/bin/noticenterctl

Systemd user unit

The installer manages the user service. Unit files are stored under:

• $XDG_CONFIG_HOME/systemd/user/
• Fallback: $HOME/.config/systemd/user/