# libtmux.Window.new_window

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

```
libtmux.Window.new_window(
    self,
    window_name: str | None = None,
    start_directory: None = None,
    attach: bool = False,
    window_index: str = "",
    window_shell: str | None = None,
    environment: dict[str, str] | None = None,
    direction: WindowDirection | None = None,
) -> Window
```

Create new window respective of current window's position.

## Examples

```python
>>> window_initial = session.new_window(window_name='Example')
>>> window_initial
Window(@... 2:Example, Session($1 libtmux_...))
>>> window_initial.window_index
'2'
```

```python
>>> window_before = window_initial.new_window(
... window_name='Window before', direction=WindowDirection.Before)
>>> window_initial.refresh()
>>> window_before
Window(@... 2:Window before, Session($1 libtmux_...))
>>> window_initial
Window(@... 3:Example, Session($1 libtmux_...))
```

```python
>>> window_after = window_initial.new_window(
... window_name='Window after', direction=WindowDirection.After)
>>> window_initial.refresh()
>>> window_after.refresh()
>>> window_after
Window(@... 4:Window after, Session($1 libtmux_...))
>>> window_initial
Window(@... 3:Example, Session($1 libtmux_...))
>>> window_before
Window(@... 2:Window before, Session($1 libtmux_...))
```

## Parameters

- `window_name` (`str | None`)
- `start_directory` (`None`)
- `attach` (`bool`)
- `window_index` (`str`)
- `window_shell` (`str | None`)
- `environment` (`dict[str, str] | None`)
- `direction` (`WindowDirection | None`)