https://github.com/Airblader/i3 Skip to content Toggle navigation Sign up * Product + Actions Automate any workflow + Packages Host and manage packages + Security Find and fix vulnerabilities + Codespaces Instant dev environments + Copilot Write better code with AI + Code review Manage code changes + Issues Plan and track work + Discussions Collaborate outside of code + Explore + All features + Documentation + GitHub Skills + Blog * Solutions + For + Enterprise + Teams + Startups + Education + By Solution + CI/CD & Automation + DevOps + DevSecOps + Case Studies + Customer Stories + Resources * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles + Repositories + Topics + Trending + Collections * Pricing [ ] * # In this repository All GitHub | Jump to | * No suggested jump to results * # In this repository All GitHub | Jump to | * # In this user All GitHub | Jump to | * # In this repository All GitHub | Jump to | Sign in Sign up {{ message }} This repository has been archived by the owner before Nov 9, 2022. It is now read-only. Airblader / i3 Public archive * Notifications * Fork 324 * Star 6k A fork of the i3 window manager with gaps and some other features. [?][?] i3-gaps has been merged into i3. License BSD-3-Clause license 6k stars 324 forks Star Notifications * Code * Issues 1 * Pull requests 0 * Actions * Wiki * Security * Insights More * Code * Issues * Pull requests * Actions * Wiki * Security * Insights Airblader/i3 This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. gaps-next Switch branches/tags [ ] Branches Tags Could not load branches Nothing to show {{ refName }} default View all branches Could not load tags Nothing to show {{ refName }} default View all tags Name already in use A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch? Cancel Create 14 branches 76 tags Code * Local * Codespaces * Clone HTTPS GitHub CLI [https://github.com/A] Use Git or checkout with SVN using the web URL. [gh repo clone Airbla] Work fast with our official CLI. Learn more. * Open with GitHub Desktop * Download ZIP Sign In Required Please sign in to use Codespaces. Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Launching Xcode If nothing happens, download Xcode and try again. Launching Visual Studio Code Your codespace will open once ready. There was a problem preparing your codespace, please try again. Latest commit @Airblader Airblader project status ... 9f3e415 Nov 1, 2022 project status 9f3e415 Git stats * 8,367 commits Files Permalink Failed to load latest commit information. Type Name Latest commit message Commit time .github Merge remote-tracking branch 'upstream/next' into gaps-next Sep 22, 2022 AnyEvent-I3 Introduce GET_BINDING_STATE IPC command Jun 6, 2020 contrib dump-asy.pl: Include floating_nodes Sep 14, 2018 debian Merge remote-tracking branch 'vanilla/next' into gaps-next Sep 21, 2022 docs Merge remote-tracking branch 'upstream/next' into gaps-next Oct 16, 2022 etc make tiling drag configurable Oct 16, 2022 i3-config-wizard Remove outdated //-style commented-out code Dec 6, 2021 i3-dump-log i3-dump-log -f: switch from pthreads to UNIX sockets Jan 20, 2021 i3-input Fix typos (#4989) Jun 1, 2022 i3-msg GET_CONFIG: add raw/variable-processed contents of all config files (... Sep 22, 2021 i3-nagbar i3-nagbar: add possibility to open bar on focused monitor Nov 29, 2020 i3bar Merge remote-tracking branch 'vanilla/next' into gaps-next Jun 1, 2022 include Merge remote-tracking branch 'upstream/next' into gaps-next Oct 19, 2022 libi3 Merge remote-tracking branch 'vanilla/next' into gaps-next Jun 1, 2022 man Escape ~ to prevent interpretation as subscript. (#5168) Oct 11, 2022 meson add meson build files (#4094) May 19, 2020 parser-specs Merge remote-tracking branch 'upstream/next' into gaps-next Oct 16, 2022 release-notes tiling drag: only start when there are drop targets (#5213) Oct 18, 2022 share Move/rename config files/.desktop files into subdirs Oct 23, 2016 src Merge remote-tracking branch 'upstream/next' into gaps-next Oct 19, 2022 testcases Merge remote-tracking branch 'upstream/next' into gaps-next Oct 16, 2022 travis fix travis/check-spelling.pl for recent Lintian changes Jul 28, 2022 .clang-format clang-format: use TypenameMacros Oct 20, 2020 .dockerignore add meson build files (#4094) May 19, 2020 .editorconfig Add .editorconfig (see editorconfig.org) (#2943) Sep 13, 2017 .gitignore Ignore *.tar.xz Nov 15, 2020 DEPENDS Fix DEPENDS table May 1, 2018 I3_VERSION Set non-git version to 4.19.1-non-git. Feb 1, 2021 LICENSE Reformat LICENSE so github sees it as BSD-3-Clause. (#4181) Sep 2, 2020 PACKAGE-MAINTAINER Update compilation instructions throughout our docs Nov 15, 2020 README.md project status Nov 1, 2022 RELEASE-NOTES-4.21.1 release i3 4.21.1 Oct 24, 2022 generate-command-parser.pl Fix bug where long commands crash i3 Aug 24, 2021 i3-dmenu-desktop Fix i3-dmenu-desktop quoting (#5162) Sep 28, 2022 i3-migrate-config-to-v4 Remove dead documentation for non-existing feature "stack-limit". Jun 9, 2015 i3-save-tree i3-save-tree: Exclude unsupported "transient_for" property Sep 12, 2018 i3-sensible-editor Added gVim to i3-sensible-editor Feb 19, 2018 i3-sensible-pager i3-sensible-pager: sanitize LESS environment variable (#5111) Sep 6, 2022 i3-sensible-terminal Add wezterm to i3-sensible-terminal (#5107) Sep 6, 2022 logo.svg Remove small bulge in i3 SVG logo (#4281) Dec 28, 2020 meson.build Restore non-git version suffix Oct 24, 2022 meson_options.txt meson: make docdir configurable May 19, 2020 pseudo-doc.doxygen Replace http:// with https:// where applicable Sep 24, 2017 release.sh release.sh: re-add warning about debian/changelog changes Sep 21, 2022 View code [ ] i3-gaps Project status What is i3-gaps? How do I install i3-gaps? Where can I get help? Features i3 gaps Configuration Commands Smart Gaps Smart Borders Smart Edge Borders i3bar Bar Height README.md Build Status Issues Forks Stars i3-gaps Project status [?][?] [?][?] [?][?] The i3-gaps project has been merged with i3. All i3-gaps features will become available with i3 4.22 (not released yet at the time of writing this). Package maintainers are asked to replace any i3-gaps packages with the i3 package once i3 4.22 has been released. This repository will be archived and no longer be kept up to date. What is i3-gaps? i3-gaps is a fork of i3wm, a tiling window manager for X11. It is kept up to date with upstream, adding a few additional features such as gaps between windows (see below for a complete list). i3 How do I install i3-gaps? Please refer to the wiki. Where can I get help? For bug reports or feature requests regarding i3-gaps specifically, open an issue on GitHub. If your issue is with core i3 functionality, please report it upstream. For support & all other kinds of questions, you can ask your question on GitHub Discussions. Features i3 gaps Note: In order to use gaps you need to disable window titlebars. This can be done by adding the following line to your config. # You can also use any non-zero value if you'd like to have a border default_border pixel 0 Gaps are the namesake feature of i3-gaps and add spacing between windows/containers. Gaps come in two flavors, inner and outer gaps wherein inner gaps are those between two adjacent containers (or a container and an edge) and outer gaps are an additional spacing along the screen edges. Gaps can be configured in your config either globally or per workspace, and can additionally be changed during runtime using commands (e.g., through i3-msg). Note: Outer gaps are added to the inner gaps, i.e., the gaps between a screen edge and a container will be the sum of outer and inner gaps. Configuration You can define gaps either globally or per workspace using the following syntax. Note that the gaps configurations should be ordered from least specific to most specific as some directives can overwrite others. gaps [inner|outer|horizontal|vertical|top|left|bottom|right] workspace gaps [inner|outer|horizontal|vertical|top|left|bottom|right] The inner and outer keywords are as explained above. With top, left, bottom and right you can specify outer gaps on specific sides, and horizontal and vertical are shortcuts for the respective sides. stands for a numeric value in pixels and for either a workspace number or a workspace name. Commands Gaps can be modified at runtime with the following command syntax: gaps inner|outer|horizontal|vertical|top|right|bottom|left current|all set|plus|minus|toggle # Examples gaps inner all set 20 gaps outer current plus 5 gaps horizontal current plus 40 gaps outer current toggle 60 With current or all you can change gaps either for only the currently focused or all currently existing workspaces (note that this does not affect the global configuration itself). You can find an example configuration in the wiki. Smart Gaps Gaps can be automatically turned on/off on a workspace in certain scenarios using the following config directives: # Only enable gaps on a workspace when there is at least one container smart_gaps on # Only enable outer gaps when there is exactly one container smart_gaps inverse_outer Smart Borders Smart borders will draw borders on windows only if there is more than one window in a workspace. This feature can also be enabled only if the gap size between window and screen edge is 0. # Activate smart borders (always) smart_borders on # Activate smart borders (only when there are effectively no gaps) smart_borders no_gaps Smart Edge Borders This extends i3's hide_edge_borders with a new option. When set, edge-specific borders of a container will be hidden if it's the only container on the workspace and the gaps to the screen edge is 0. # Hide edge borders only if there is one window with no gaps hide_edge_borders smart_no_gaps i3bar Bar Height The height of an i3bar instance can be specified explicitly by defining the height key in the bar configuration. If not set, the height will be calculated automatically depending on the font size. bar { # Height in pixels height 25 } About A fork of the i3 window manager with gaps and some other features. [?][?] i3-gaps has been merged into i3. Topics i3 xorg x11 i3wm xcb i3-gaps x11-wm Resources Readme License BSD-3-Clause license Stars 6k stars Watchers 120 watching Forks 324 forks Releases 15 4.21.1 Latest Oct 28, 2022 + 14 releases Contributors 308 * @stapelberg * @Airblader * @orestisfl * @Merovius * @acrisci * @fernandotcl * @sardemff7 * @CyberShadow * @Deiz * @xzfc * @hwangcc23 + 297 contributors Languages * C 58.5% * Perl 38.5% * Python 1.2% * Shell 0.7% * Meson 0.7% * Dockerfile 0.3% * Other 0.1% Footer (c) 2023 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact GitHub * Pricing * API * Training * Blog * About You can't perform that action at this time. You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.