Profiles

What is a Profile?

A profile is a saved snapshot of your desktop configuration. It bundles settings for one or more tools (Rainmeter, YASB, GlazeWM, Zebar, Windhawk, Wallpaper) into a single named preset. Apply a profile to switch your entire desktop environment in one click.

The Dashboard

  • Header shows "My Profiles" with subtitle
  • Top-right buttons: Export, Import, Stop All
    • Stop All — Kills all managed tools and disables all Windhawk mods. Use this to return to a clean state.
  • Profile cards displayed in a grid
  • Empty state: "No profiles yet" with a prompt to create one

Profile Cards

Each card shows:

  • Profile name
  • Tool badges (icons for each configured tool)
  • Three action buttons:
    • Run — Applies the profile. Shows "Running..." while processing, "Done!" on success.
    • Edit — Opens the profile in the editor
    • Remove — Deletes the profile (no confirmation dialog)

Creating a New Profile

Click "New Profile" in the sidebar. The form includes:

Profile Name

Give your profile a descriptive name (e.g., "Work Setup", "Gaming Mode").

Wallpaper Image

Click "Select File" to choose a PNG or JPG image. This wallpaper is applied across all virtual desktops.

Enable Customization Tools

Toggle checkboxes for each tool you want to include. Only enabled tools will be configured when the profile is applied.

Tool Configuration (per tool)

Rainmeter — Select a layout from the dropdown (auto-detected from your Rainmeter layouts folder). If no layouts are detected, you can type the layout name manually.

YASB — Two text areas:

  • YAML config (config.yaml) — pre-filled with your current YASB config
  • CSS styles (styles.css) — pre-filled with your current YASB styles

GlazeWM — Text area for config.yaml, pre-filled with your current GlazeWM config.

Zebar — Text area for settings.json, pre-filled with your current Zebar settings.

Windhawk — Shows all installed Windhawk mods. For each mod:

  • Toggle to enable/disable
  • When enabled, a JSON settings editor appears (pre-filled with current settings)

Saving

Click "Add Profile" to save. You'll see a confirmation message.

Editing a Profile

Click the Edit button (pencil icon) on any profile card. The same form opens with all fields pre-populated. Make changes and click "Save Changes".

Applying a Profile

Click "Run" on any profile card. Kalam will:

  1. Write config files for each enabled tool
  2. Launch or restart tools as needed
  3. Kill tools that are NOT in the profile (if they're currently running)
  4. Set your wallpaper across all virtual desktops
  5. For Windhawk: write registry entries and restart the service

If the profile is already active, Kalam skips tools that are already in the correct state.

Deleting a Profile

Click the Remove button (trash icon) on any profile card. The profile is permanently deleted.