mangowm/mango
0
0
Fork 0
mirror of https://github.com/mangowm/mango.git synced 2026-05-02 14:27:27 -07:00
Code Issues Packages Projects Releases Wiki Activity
Page: scratchpad
Pages
Home animations basics effects faq input installation ipc keys layouts miscellaneous monitors mouse gestures overview quick start rules scratchpad status bar theming xdg portals
Clone
1
scratchpad
github-actions[bot] edited this page 2026-03-13 11:22:08 +00:00
Table of Contents

mangowm supports two types of scratchpads: the standard pool (Sway-like) and named scratchpads.

Standard Scratchpad

Any window can be sent to the "scratchpad" pile, which hides it. You can then cycle through them.

Keybindings:

# Send current window to scratchpad
bind=SUPER,i,minimized

# Toggle (show/hide) the scratchpad
bind=ALT,z,toggle_scratchpad

# Retrieve window from scratchpad (restore)
bind=SUPER+SHIFT,i,restore_minimized

Named Scratchpad

Named scratchpads are bound to specific keys and applications. When triggered, mangowm will either launch the app (if not running) or toggle its visibility.

1. Define the Window Rule

You must identify the app using a unique appid or title and mark it as a named scratchpad. The application must support setting a custom appid or title at launch. Common examples:

  • st -c my-appid — sets the appid
  • kitty -T my-title — sets the window title
  • foot --app-id my-appid — sets the appid

Use none as a placeholder when you only want to match by one field.

# Match by appid
windowrule=isnamedscratchpad:1,width:1280,height:800,appid:st-yazi

# Match by title
windowrule=isnamedscratchpad:1,width:1000,height:700,title:kitty-scratch

2. Bind the Toggle Key

Format: bind=MOD,KEY,toggle_named_scratchpad,appid,title,command

Use none for whichever field you are not matching on.

# Match by appid: launch 'st' with class 'st-yazi' running 'yazi'
bind=alt,h,toggle_named_scratchpad,st-yazi,none,st -c st-yazi -e yazi

# Match by title: launch 'kitty' with window title 'kitty-scratch'
bind=alt,k,toggle_named_scratchpad,none,kitty-scratch,kitty -T kitty-scratch

Appearance

You can customize the size of scratchpad windows relative to the screen.

scratchpad_width_ratio=0.8
scratchpad_height_ratio=0.9
scratchpadcolor=0x516c93ff

General

Bindings

Configuration

Visuals

Window Management