Qtile Bonsai

Visual Guide

Splits
A
```
spawn_split(program, "x")
```
A

B
```
spawn_split(program, "y")
```
A

B
Tabs
A
```
spawn_tab(program)
```
- 1
- 2
B
A

B

C
```
spawn_tab(program, new_level=True)
```
A

B

1

2

D
A

B

1

2

D
```
spawn_tab(program)
```
A

B

1

2

3

E
```
spawn_tab(program, level=1)
```
- 1
- 2
E
Merge to Subtab
A

B

C

D
```
merge_to_subtab("right")
```
A

B

1

2

C
```
merge_to_subtab("left")
```
A

1

2

C

D
```
merge_to_subtab("up")
```
1

2

C

B

D
A

B

C

1

2

E
```
merge_to_subtab("right")
```
A

B

1

2

3

C
Push In
A

B

C

D

E
```
push_in("right")
```
A

B

D

E

C
```
push_in("left")
```
A

C

B

D

E
Pull Out
A

B

C

D

E
```
pull_out()
```
A

B

C

E

D
```
pull_out(position="next")
```
A

B

C

D

E
A

B

C

D

E
```
pull_out()
```
A

B

E

C

D
A

B

1

2

D
```
pull_out()
```
A

B

D

C
Pull Out to Tab
A

B

C
```
pull_out_to_tab()
```
- 1
- 2
C
A

B

1

2

D

E
```
pull_out_to_tab()
```
A

B

1

2

3

E
A

B

1

2

3

E
```
pull_out_to_tab()
```
- 1
- 2
E
Merge Tabs
- 1
- 2
C

D
```
merge_tabs("previous", "x")
```
A

B

C

D
```
merge_tabs("previous", "y")
```
A

B

C

D
Container Select Mode
A

B

C
```
toggle_container_select_mode()
```
A

B

C
A

B

C

D
```
select_container_outer()
```
A

B

C

D
```
select_container_inner()
```
A

B

C

D
A

B

C

D
```
spawn_split(program, "x")
```
A

B

C

D

E
```
spawn_tab(program, new_level=True)
```
A

1

2

E
Focus nth Tab
- 1
- 2
- 3
A
```
focus_nth_tab(3)
```
- 1
- 2
- 3
C
- 1
- 2
A

B

1

2

3

C
```
focus_nth_tab(2) / focus_nth_tab(2, level=-1)
```
- 1
- 2
A

B

1

2

3

D
```
focus_nth_tab(2, level=1)
```
- 1
- 2
F
Focus nth Window
A

B

C
```
focus_nth_window(3)
```
A

B

C
- 1
- 2
B

C

D
```
focus_nth_window(3)
```
- 1
- 2
B

C

D
```
focus_nth_window(3, ignore_inactive_tabs_at_levels=[1])
```
- 1
- 2
B

C

D
- 1
- 2
A

B

1

2

3

E
```
focus_nth_window(3)
```
- 1
- 2
A

B

1

2

3

C
```
focus_nth_window(3, ignore_inactive_tabs_at_levels=[1,2])
```
- 1
- 2
A

B

1

2

3

E

Advanced Options for Container Selection

Applicable to merge_to_subtab(), push_in(), pull_out()

A
- B
- C
- D
- E

merge_to_subtab(
    "right",
    src_selection="mru_deepest",
    dest_selection="mru_deepest",
)

A
B
- D
- - 1
  - 2
  - C

merge_to_subtab(
    "right",
    src_selection="mru_deepest",
    dest_selection="mru_largest",
)

A
B
- 1
- 2
- C

merge_to_subtab(
    "right",
    src_selection="mru_largest",
    dest_selection="mru_deepest",
)

A
- D
- - 1
  - 2
  - B
  - C

merge_to_subtab(
    "right",
    src_selection="mru_largest",
    dest_selection="mru_largest",
)

A
- 1
- 2
- B
- C

- A
- B
- C
- D
- 1
- 2
- F
- G

merge_to_subtab(
    "right",
    dest_selection="mru_subtab_else_deepest",
)

- A
- B
D
- 1
- 2
- 3
- C

merge_to_subtab(
    "left",
    dest_selection="mru_subtab_else_deepest",
)

- A
- - 1
  - 2
  - C
D
- 1
- 2
- F
- G

- A
- B
- C
- D
- E
- - 1
  - 2
  - G

merge_to_subtab(
    "right",
    dest_selection="mru_subtab_else_largest",
)

- A
- B
D
- E
- - 1
  - 2
  - 3
  - C

merge_to_subtab(
    "left",
    dest_selection="mru_subtab_else_largest",
)

- 1
- 2
- C
D
- E
- - 1
  - 2
  - G