# LibTmux::Pane#break_out

- **Module:** LibTmux
- **Package:** libtmux
- **Language:** Ruby
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-ruby/blob/da7b6191b9439e3c84fa1c9eeaa9168263ee7af4/gems/libtmux/lib/libtmux/operations.rb#L351
- **Page:** https://libtmux.org/en/ruby/v0.1.1/reference/libtmux-pane-break_out/

```
def break_out: (
  session: ::LibTmux::EntityRef,
  name: ::String,
  ?timeout: ::Numeric,
  ?cancel: untyped
) -> ::LibTmux::Window
```

Exact tmux 3.7 ignores -n on [break-pane](/en/tmux/latest/manual/break-pane/) and crashes without it, so the
name is applied again afterwards. Before 3.6 a sole pane's break prints
no ID, so the window is read back from the pane.

Behavior contract: Entity mutation.

## Parameters

- `session` (`::LibTmux::EntityRef`)
- `name` (`::String`)
- `timeout` (`::Numeric`)
- `cancel` (`untyped`)

## Raises

- [`ProtocolError`](/en/ruby/v0.1.1/reference/libtmux-protocolerror/)

## tmux command

The tmux commands behind `break_out`.

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

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_break_pane_entry`](/en/tmux/latest/reference/c-variable-cmd_break_pane_entry/) (attribute)
- [`cmd_break_pane_exec`](/en/tmux/latest/reference/c-function-cmd-break-pane-c-cmd_break_pane_exec/) (function)

## In other ports

Move a pane out into a window of its own

| Language | Equivalent |
| --- | --- |
| Python | [`libtmux.Pane.break_pane`](/en/py/latest/reference/libtmux-pane-break_pane/) (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.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) |

No equivalent is recorded in PowerShell, Julia, Elixir, Kotlin, Scala or F#.