# libtmux.Pane.break_pane

- **Module:** libtmux
- **Package:** libtmux
- **Language:** Python
- **Kind:** method
- **Source:** https://github.com/tmux-python/libtmux/blob/38e368c11117fb4aeb2f082d552cd4f210eae06a/src/libtmux/pane.py#L2422
- **Page:** https://libtmux.org/en/py/stable/reference/libtmux-pane-break_pane/

tmux command: [`break-pane`](/en/tmux/latest/manual/break-pane/)

```
libtmux.Pane.break_pane(
    self,
    detach: bool = True,
    window_name: str | None = None,
) -> Window
```

Break this pane out into a new window via [`$ tmux break-pane`](/en/tmux/latest/manual/break-pane/).

## Examples

```python
>>> pane_to_break = window.split(shell='sleep 1m')
>>> new_window = pane_to_break.break_pane(window_name='broken')
>>> new_window.window_name
'broken'
```

## Parameters

- `detach` (`bool`): Do not switch to the new window (``-d`` flag), default True.
- `window_name` (`str | None`): Name for the new window (``-n`` flag).

## Returns

:class:`Window`
    The newly created window containing the pane.

## In other ports

### Move a pane out into a window of its own

- Ruby: [`LibTmux::Pane#break_out`](/en/ruby/latest/reference/libtmux-pane-break_out/) (method)
- Lua: [`libtmux.Pane:break_out`](/en/lua/latest/reference/libtmux-pane-break_out/) (method)
- TypeScript: [`pane.Pane.breakOut`](/en/ts/latest/reference/pane-pane-breakout/) (method)
- Rust: [`pane.Pane.break_out`](/en/rs/latest/reference/pane-pane-break_out/) (method)
- Go: [`tmux.Pane.BreakPane`](/en/go/latest/reference/tmux-pane-breakpane/) (method)
- Java: [`io.github.libtmux.Pane.Pane.breakOut`](/en/java/latest/reference/io-github-libtmux-pane-pane-breakout/) (method)
- C#: [`LibTmux.Pane.BreakAsync`](/en/csharp/latest/reference/libtmux-pane-breakasync/) (method)
- C++: [`libtmux::Pane::break_out`](/en/cxx/latest/reference/libtmux-pane-break_out/) (method)
- Swift: [`Server.breakPane(_:from:named:)`](/en/swift/latest/reference/server-breakpane(_-from-named-)/) (method)