# libtmux.Session.rename_session

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

tmux command: [`rename-session`](/en/tmux/latest/manual/rename-session/)

```
libtmux.Session.rename_session(
    self, new_name: str
) -> Session
```

Rename session and return new :class:`Session` object.

## Parameters

- `new_name` (`str`): new session name

## Raises

- [`exc.BadSessionName`](/en/py/stable/reference/libtmux-exc-badsessionname/)

## In other ports

### Rename a session

- Ruby: [`LibTmux::Session#rename`](/en/ruby/latest/reference/libtmux-session-rename/) (method)
- Lua: [`libtmux.Session:rename`](/en/lua/latest/reference/libtmux-session-rename/) (method)
- TypeScript: [`session.Session.rename`](/en/ts/latest/reference/session-session-rename/) (method)
- Rust: [`session.Session.rename`](/en/rs/latest/reference/session-session-rename/) (method)
- Go: [`tmux.Session.Rename`](/en/go/latest/reference/tmux-session-rename/) (method)
- Java: [`io.github.libtmux.Session.Session.rename`](/en/java/latest/reference/io-github-libtmux-session-session-rename/) (method)
- C#: [`LibTmux.Session.RenameAsync`](/en/csharp/latest/reference/libtmux-session-renameasync/) (method)
- C++: [`libtmux::Session::rename`](/en/cxx/latest/reference/libtmux-session-rename/) (method)
- Swift: [`Server.rename(_:to:)`](/en/swift/latest/reference/server-rename(_-to-)/) (method)