{"id":13740742,"url":"https://github.com/2KAbhishek/tmux-tilit","last_synced_at":"2025-05-08T20:32:28.252Z","repository":{"id":100263517,"uuid":"572371577","full_name":"2KAbhishek/tmux-tilit","owner":"2KAbhishek","description":"Better tiling for tmux 🪟🪓","archived":false,"fork":false,"pushed_at":"2024-10-30T08:32:42.000Z","size":274,"stargazers_count":35,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-12T23:38:32.823Z","etag":null,"topics":["cli","linux","plugin","tiling","tmux","utility","wm"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/2KAbhishek.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"2kabhishek"}},"created_at":"2022-11-30T05:55:56.000Z","updated_at":"2024-11-11T23:10:27.000Z","dependencies_parsed_at":"2023-05-13T06:30:45.059Z","dependency_job_id":"4bbfa3b1-1cd3-40c2-ae74-7d2670f1cb84","html_url":"https://github.com/2KAbhishek/tmux-tilit","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"2KAbhishek/bare-minimum","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2KAbhishek%2Ftmux-tilit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2KAbhishek%2Ftmux-tilit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2KAbhishek%2Ftmux-tilit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2KAbhishek%2Ftmux-tilit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/2KAbhishek","download_url":"https://codeload.github.com/2KAbhishek/tmux-tilit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224765551,"owners_count":17366134,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","linux","plugin","tiling","tmux","utility","wm"],"created_at":"2024-08-03T04:00:51.795Z","updated_at":"2024-11-15T10:31:02.819Z","avatar_url":"https://github.com/2KAbhishek.png","language":"Shell","funding_links":["https://github.com/sponsors/2kabhishek"],"categories":["Plugins"],"sub_categories":[],"readme":"\u003cdiv align = \"center\"\u003e\n\n\u003ch1\u003e\u003ca href=\"https://2kabhishek.github.io/tmux-tilit\"\u003etmux-tilit\u003c/a\u003e\u003c/h1\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/tmux-tilit/blob/main/LICENSE\"\u003e\n\u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/2kabhishek/tmux-tilit?style=flat\u0026color=eee\u0026label=\"\u003e \u003c/a\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/tmux-tilit/graphs/contributors\"\u003e\n\u003cimg alt=\"People\" src=\"https://img.shields.io/github/contributors/2kabhishek/tmux-tilit?style=flat\u0026color=ffaaf2\u0026label=People\"\u003e \u003c/a\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/tmux-tilit/stargazers\"\u003e\n\u003cimg alt=\"Stars\" src=\"https://img.shields.io/github/stars/2kabhishek/tmux-tilit?style=flat\u0026color=98c379\u0026label=Stars\"\u003e\u003c/a\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/tmux-tilit/network/members\"\u003e\n\u003cimg alt=\"Forks\" src=\"https://img.shields.io/github/forks/2kabhishek/tmux-tilit?style=flat\u0026color=66a8e0\u0026label=Forks\"\u003e \u003c/a\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/tmux-tilit/watchers\"\u003e\n\u003cimg alt=\"Watches\" src=\"https://img.shields.io/github/watchers/2kabhishek/tmux-tilit?style=flat\u0026color=f5d08b\u0026label=Watches\"\u003e \u003c/a\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/tmux-tilit/pulse\"\u003e\n\u003cimg alt=\"Last Updated\" src=\"https://img.shields.io/github/last-commit/2kabhishek/tmux-tilit?style=flat\u0026color=e06c75\u0026label=\"\u003e \u003c/a\u003e\n\n\u003ch3\u003eBetter tiling for tmux 🪟🪓\u003c/h3\u003e\n\n\u003cfigure\u003e\n  \u003cimg src= \"images/screenshot.png\" alt=\"tmux-tilit Demo\"\u003e\n  \u003cbr/\u003e\n  \u003cfigcaption\u003etmux-tilit screenshot\u003c/figcaption\u003e\n\u003c/figure\u003e\n\n\u003c/div\u003e\n\n## What is this\n\ntmux-tilit brings tiling window manager features and intuitive keybindings to your tmux workflows, boosting your productivity like never before.\n\n## Prerequisites\n\nBefore you begin, ensure you have met the following requirements:\n\n- You have installed the latest version of `tmux (\u003e= 3.0)` and [`tpm`](https://github.com/tmux-plugins/tpm).\n\n## Installing tmux-tilit\n\nTo get tmux-tilit, add the following to your `tmux.conf`:\n\n```bash\nset -g @plugin '2kabhishek/tmux-tilit'\n```\n\n## Using tmux-tilit\n\n### Keybindings\n\nAll the configured keybindings can be found in the [keybinding manual here](./docs/keybindings.md).\n\n### Customizing tmux-tilit\n\n#### `easymode` for arrow key navigation\n\nTo navigate using arrow keys, you can enable easy mode with: `set -g @tilit-easymode 'on'`\n\nThe revised keybindings for the pane focus and movement then become:\n\n| Keybinding                                                          | Description              |\n| ------------------------------------------------------------------- | ------------------------ |\n| \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003e\u0026#8592;/\u0026#8595;/\u0026#8593;/\u0026#8594;\u003c/kbd\u003e         | Focus pane in direction  |\n| \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eShift + \u0026#8592;/\u0026#8595;/\u0026#8593;/\u0026#8594;\u003c/kbd\u003e | Move pane in direction   |\n| \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eh/j/k/l\u003c/kbd\u003e                                 | Resize pane in direction |\n\n#### `layout` for customizing default layout\n\nYou can set the default layout with `set -g @tilit-default 'layout'`, this will be used when creating new windows or panes.\n\nAvailable layouts are:\n\n- `main-vertical`\n- `main-horizontal`\n- `tiled`\n- `even-vertical`\n- `even-horizontal`\n\n#### `navigator` for integrating with vim/neovim\n\nTo setup navigation with neovim install [Navigator.nvim][4] and for vim use [vim-tmux-navigator][5]\n\nThen, in your `~/.tmux.conf` add:\n\n```bash\nset -g @tilit-navigator 'on'\n```\n\nThis will let you seamlessly navigate between vim/neovim splits and tmux panes with \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eh\u003c/kbd\u003e\u003ckbd\u003ej\u003c/kbd\u003e\u003ckbd\u003ek\u003c/kbd\u003e\u003ckbd\u003el\u003c/kbd\u003e.\n\n[4]: https://github.com/numToStr/Navigator.nvim\n[5]: https://github.com/christoomey/vim-tmux-navigator\n\n#### `prefix` for integrating with window managers\n\nIf your window manager uses \u003ckbd\u003eAlt\u003c/kbd\u003e as default modifier, it's recommended to switch to \u003ckbd\u003eSuper\u003c/kbd\u003e or \u003ckbd\u003eMeta\u003c/kbd\u003e for a smoother experience.\n\nIf you do not want to do that you can enable prefix mode and faster repeat-time in tmux:\n\n```bash\nset -g @tilit-prefix 'M-space'\nset -g repeat-time 1000\n```\n\nThis will let you hit \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eSpace\u003c/kbd\u003e and then a key to perform an action, repeat time lets you run more actions with a single prefix.\n\n#### `shiftnum` for working with international keyboards\n\nYou can set the `@tilit-shiftnum` option to match your keyboard layout:\n\n```bash\n# US Keyboard\nset -g @tilit-shiftnum '!@#$%^\u0026*()'\n# UK Keyboard\nset -g @tilit-shiftnum '!\"£$%^\u0026*()'\n```\n\n## How I built this\n\nMajor credits to [tmux-tilish](https://github.com/jabirali/tmux-tilish) for the inspiration\nI wanted to add some new commands and integrations, make the keybindings match better with tmux defaults.\n\n## Challenges faced\n\nMaking sure the keybindings work across different command line programs and environments was challenging.\n\n## What I learned\n\n- Learned more about the tmux api.\n\n## What's next\n\nYou tell me!\n\nHit the ⭐ button if you found this useful.\n\n### 🧰 Tooling\n\n- [dots2k](https://github.com/2kabhishek/dots2k) — Dev Environment\n- [nvim2k](https://github.com/2kabhishek/nvim2k) — Personalized Editor\n- [sway2k](https://github.com/2kabhishek/sway2k) — Desktop Environment\n- [qute2k](https://github.com/2kabhishek/qute2k) — Personalized Browser\n\n### 🔍 More Info\n\n- [tmux-tea](https://github.com/2kabhishek/tmux-tea) — Simple and powerful tmux session manager\n- [tmux2k](https://github.com/2kabhishek/tmux2k) — Makes your tmux statusbar pretty!\n\n\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/tmux-tilit\"\u003eSource\u003c/a\u003e | \u003ca href=\"https://2kabhishek.github.io/tmux-tilit\"\u003eWebsite\u003c/a\u003e\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2KAbhishek%2Ftmux-tilit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F2KAbhishek%2Ftmux-tilit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2KAbhishek%2Ftmux-tilit/lists"}