# Quick Start

Get up and running with DWN in 5 minutes

## Essential Shortcuts

These are the most important shortcuts to know:

Shortcut | Action
--- | ---
`Ctrl+Alt+T` | Open terminal
`Super` or `Alt+F2` | Open application launcher (dmenu)
`Alt+F4` | Close focused window
`Alt+Tab` | Cycle through windows
`F1` - `F9` | Switch to workspace 1-9
`Super+Space` | Cycle layout mode
`Super+Backspace` | Quit DWN

## Your First Session

### 1. Launch Applications

Press `Super` (Windows key) to open the application launcher. Type the name of the application and press Enter.

### 2. Navigate Workspaces

DWN provides 9 virtual workspaces. Use `F1` through `F9` to switch between them. The panel at the top shows which workspaces have windows.

### 3. Manage Windows

By default, DWN uses a tiling layout where windows automatically arrange themselves. The first window takes the "master" area (left side), and subsequent windows stack on the right.

### 4. Move Windows Between Workspaces

Press `Shift+F1` through `Shift+F9` to move the focused window to a different workspace.

## Layout Modes

Press `Super+Space` to cycle through layout modes:

Tiling
Master-stack layout. First window on the left, others stacked on the right. Use `Super+H/L` to resize the master area.
Floating
Traditional floating windows. Drag title bars to move, drag edges to resize.
Monocle
All windows fullscreen, stacked. Use Alt+Tab to switch between them.

## Window Snapping

Use `Super+Arrow` keys to snap windows:

Shortcut | Action
--- | ---
`Super+Left` | Snap to left half (press twice for full width)
`Super+Right` | Snap to right half
`Super+Up` | Snap to top half
`Super+Down` | Snap to bottom half

Snapping is composable: `Super+Left` then `Super+Up` snaps to the top-left quarter.

## Window States

Shortcut | Action
--- | ---
`Alt+F9` | Minimize window
`Alt+F10` | Maximize window
`Alt+F11` | Fullscreen (no decorations)
`Super+F9` | Toggle floating mode

## Configuration

DWN reads configuration from `~/.config/dwn/config`. Create one from the example:

    mkdir -p ~/.config/dwn
    cp /etc/dwn/config.example ~/.config/dwn/config

Edit the file to customize terminal, launcher, colors, and more. See the Configuration page for details.

## Enable the API

To enable the WebSocket API for automation, add this to your config:

    [api]
    enabled = true
    port = 8777

Then you can control DWN programmatically. See API Overview.

## Next Steps

- Full keyboard shortcuts reference
- Configuration options
- AI integration setup
- API documentation