mango

mangowm/mango

Fork 0

mirror of https://github.com/mangowm/mango.git synced 2026-05-02 14:27:27 -07:00

Table of Contents

Configuration File

Sub-Configuration
Validate Configuration

Environment Variables
Autostart

Example Setup

Configuration File

mangowm uses a simple configuration file format. By default, it looks for a configuration file in ~/.config/mango/.

Locate Default Config

A fallback configuration is provided at /etc/mango/config.conf. You can use this as a reference.
Create User Config

Copy the default config to your local config directory to start customizing.
```
mkdir -p ~/.config/mango
cp /etc/mango/config.conf ~/.config/mango/config.conf
```
Launch with Custom Config (Optional)

If you prefer to keep your config elsewhere, you can launch mango with the -c flag.
```
mango -c /path/to/your_config.conf
```

Sub-Configuration

To keep your configuration organized, you can split it into multiple files and include them using the source keyword.

# Import keybindings from a separate file
source=~/.config/mango/bind.conf

# Relative paths work too
source=./theme.conf

# Optional: ignore if file doesn't exist (useful for shared configs)
source-optional=~/.config/mango/optional.conf

Validate Configuration

You can check your configuration for errors without starting mangowm:

mango -c /path/to/config.conf -p

Use with source-optional for shared configs across different setups.

Environment Variables

You can define environment variables directly within your config file. These are set before the window manager fully initializes.

Warning: Environment variables defined here will be reset every time you reload the configuration.

env=QT_IM_MODULES,wayland;fcitx
env=XMODIFIERS,@im=fcitx

Autostart

mangowm can automatically run commands or scripts upon startup. There are two modes for execution:

Command	Behavior	Usage Case
`exec-once`	Runs only once when mangowm starts.	Status bars, Wallpapers, Notification daemons
`exec`	Runs every time the config is reloaded.	Scripts that need to refresh settings

Example Setup

# Start the status bar once
exec-once=waybar

# Set wallpaper
exec-once=swaybg -i ~/.config/mango/wallpaper/room.png

# Reload a custom script on config change
exec=bash ~/.config/mango/reload-settings.sh

Configuration File

Sub-Configuration

Validate Configuration

Environment Variables

Autostart

Example Setup

General

Bindings

Configuration

Visuals

Window Management