init - PoC

2025-10-27 20:12:00 +01:00 · 2025-10-27 20:12:00 +01:00 · 3484b45045
commit 3484b45045
146 changed files with 10657 additions and 0 deletions
--- a/items/2022-11-21_long_getting-started-with-tmux.md
+++ b/items/2022-11-21_long_getting-started-with-tmux.md
@ -0,0 +1,128 @@
+# Getting started with tmux
+
+Tmux is a terminal multiplexer. It allows you to work with multiple terminal sessions at once. 
+
+## Installation
+
+It is easy to install, and there are many guides already out there, so I won't cover it in this blog post. 
+
+## Tmux terminology
+
+So, let us start with the basics.
+
+`tmux server (programm) > session > window > pane`
+
+The tmux server starts after running tmux. You can work on the attached sessions or detach them so they run in the background. Every server can have multiple sessions, every session can have multiple windows, and we can split a window into multiple panes. The pane is a normal terminal window at the end.
+
+![tmux-overview](/images/blog/tmux-primer-1.png)
+
+There are a lot of use cases for it. Tmux makes is easy to separate projects in different windows or sessions.
+
+#### The prefix or lead and meta-key
+
+The default prefix (or sometimes called 'lead') is `CTRL` + `b` (or `C-b`) and it is usually the start of a tmux shortcut or to use a tmux command. When you see something like: `Prefix` + `c`, press `CTRL` + `b`, and then `c`. I prefer `CTRL` + `s` for example. I'll explain how to change it in the next section.
+
+As a side note: you'll find some shortcuts with an `M` in them. This is the `meta`-key. It is `ALT` for Linux, I think `CMD` in MacOS, and sometimes even `ESC`. The `meta`-key is rarely used, but worth looking it up.
+
+#### The config file
+
+You can temporarily change your tmux config by entering the setting:
+
+`Prefix` + `:set -g prefix C-s`
+
+This would change the `Prefix` as we described it before. If you want to make changes permanently, edit the config file. On Linux, the config file is usually in the home directory of the user `~/.tmux.conf`. If there is no config file, simply create it, and restart tmux - or reload it (will show in the end of this section). Just put `set -g prefix C-s` into the config file and tmux will use it after the restart.
+
+There are many ways to customize tmux. Some examples: Vim-like bindings for pane movements, enabling mouse support, setting keyboard shortcuts, and so on.
+
+The easiest way to reload the config file after changes is to use the following tmux command: `Prefix` + `:source-file ~/.tmux.conf` *(change the path accordingly)*. 
+
+## Working with panes
+
+As mentioned before, you can split a window in multiple panes. You can split the window vertically or horizontally as you wish and change it as much as you want. I won't cover everything in this post, but I'll show you the basics.
+
+Split horizontally:
+: `Prefix` + `%`
+
+Split vertically:
+: `Prefix` + `"`
+
+Move to another pane:
+: `Prefix` + `ARROW KEY`
+
+Convert the current pane into a new window:
+: `Prefix` + `!`
+
+Close current pane:
+: `Prefix` + `x`
+
+There are shortcuts for resizing, moving panes around, and so on, but those aren't that important for this primer.
+
+Side note: I just wrote a separate post about sending input to all panes within a window. Feel free to check it out [here](https://ittavern.com/tmux-synchronize-the-input-of-all-panes-within-a-window/).
+
+## Working with windows
+
+I prefer to separate my projects with windows instead of sessions, but that is my personal preference.
+
+Create a new window:
+: `Prefix` + `c`
+
+Rename current window:
+: `Prefix` + `,`
+
+Close current window:
+: `Prefix` + `&`
+
+Switch to next window:
+: `Prefix` + `n`
+
+Switch to previous window:
+: `Prefix` + `p`
+
+Switch to window by number:
+: `Prefix` + `0`-`9`
+
+## Working with sessions
+
+Let me start with a shortcut that I just learned recently.
+
+Overview:
+: `Prefix` + `w`
+
+This gives you a quick overview of all sessions and windows and lets you switch quickly.
+
+Show all sessions:
+: `tmux ls`
+: `Prefix` + `s`
+
+Create new session:
+: `tmux new -s new-session`
+: `:new -s new-session`
+
+Rename session:
+: `Prefix` + `$`
+
+Kill the session:
+: `:kill-session`
+
+Detach session (will be active in the background):
+: `Prefix` + `d`
+
+Close a session:
+: `tmux kill-session -t old-session`
+
+Attach session:
+: `tmux attach -t old-session`
+
+Move to next session:
+: `Prefix` + `)`
+
+Move to previous session:
+: `Prefix` + `(`
+
+# Conclusion
+
+This post hopefully will help you to get started with tmux. I'll cover more topics and features of tmux in the future.
+
+Any notes or questions? - Feel free to reach out.
+
+---