Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

documentation: layouts

Open
#873 1 comment 9 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
45/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Domain
documentation

Research direction

Start by locating the documentation for tmux layouts and compare it with the layout descriptions in the issue, including even-horizontal, even-vertical, main-horizontal, main-vertical, and tiled. Done means the available layouts and their behavior are documented and easy to find.

Written by the indexing model from the issue text.

Description

documentation

Is it me, or are the available layouts not documented? Hard to find at least it seems.

man tmux says:

The following layouts are supported:

 even-horizontal
         Panes are spread out evenly from left to right across the window.

 even-vertical
         Panes are spread evenly from top to bottom.

 main-horizontal
         A large (main) pane is shown at the top of the window and the remaining panes are spread
         from left to right in the leftover space at the bottom.  Use the main-pane-height window
         option to specify the height of the top pane.

 main-vertical
         Similar to main-horizontal but the large pane is placed on the left and the others spread
         from top to bottom along the right.  See the main-pane-width window option.

 tiled   Panes are spread out as evenly as possible over the window in both rows and columns.
Dominant language
Python
Stars
4.6k
Forks
247
PR merge metrics
No merged PRs in 30d

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from tmux-python/tmuxp

All issues in tmux-python/tmuxp

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.