2011-07-06 20:40:46 +02:00
# i3 config file (v4)
#
2017-09-24 10:19:07 +02:00
# Please see https://i3wm.org/docs/userguide.html for a complete reference!
2011-07-11 17:22:10 +02:00
#
# This config file uses keycodes (bindsym) and was written for the QWERTY
# layout.
#
# To get a config file with the same key positions, but for your current
# layout, use the i3-config-wizard
#
2009-03-11 18:56:31 +01:00
2012-08-13 13:34:30 +02:00
# Font for window titles. Will also be used by the bar unless a different font
2014-06-08 22:25:59 +02:00
# is used in the bar {} block below.
2015-02-21 23:34:26 +01:00
font pango:monospace 8
2014-06-08 22:25:59 +02:00
# This font is widely installed, provides lots of unicode glyphs, right-to-left
# text rendering and scalability on retina/hidpi displays (thanks to pango).
2015-02-21 23:34:26 +01:00
#font pango:DejaVu Sans Mono 8
2014-06-08 22:25:59 +02:00
# Before i3 v4.8, we used to recommend this one as the default:
# font -misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1
2012-08-13 13:34:30 +02:00
# The font above is very space-efficient, that is, it looks good, sharp and
2014-06-08 22:25:59 +02:00
# clear in small sizes. However, its unicode glyph coverage is limited, the old
# X core fonts rendering does not support right-to-left and this being a bitmap
2017-10-25 22:26:44 +02:00
# font, it doesn't scale on retina/hidpi displays.
2009-02-25 00:50:30 +01:00
2014-06-13 01:34:57 +02:00
# use these keys for focus, movement, and resize directions when reaching for
# the arrows is not convenient
set $up l
set $down k
set $left j
set $right semicolon
2011-06-16 18:58:49 +02:00
# use Mouse+Mod1 to drag floating windows to their wanted position
2009-06-24 20:31:00 +02:00
floating_modifier Mod1
2011-06-16 18:58:49 +02:00
# start a terminal
2011-09-25 19:45:51 +02:00
bindsym Mod1+Return exec i3-sensible-terminal
2010-06-30 00:25:11 +02:00
2011-06-16 18:58:49 +02:00
# kill focused window
2011-07-11 17:22:10 +02:00
bindsym Mod1+Shift+q kill
2010-06-30 00:25:11 +02:00
2011-06-16 18:58:49 +02:00
# start dmenu (a program launcher)
2011-08-23 21:30:09 +02:00
bindsym Mod1+d exec dmenu_run
2012-12-11 22:36:29 +01:00
# There also is the (new) i3-dmenu-desktop which only displays applications
# shipping a .desktop file. It is a wrapper around dmenu, so you need that
# installed.
# bindsym Mod1+d exec --no-startup-id i3-dmenu-desktop
2010-06-30 00:25:11 +02:00
2011-06-16 18:58:49 +02:00
# change focus
2014-06-13 01:34:57 +02:00
bindsym Mod1+$left focus left
bindsym Mod1+$down focus down
bindsym Mod1+$up focus up
bindsym Mod1+$right focus right
2010-06-30 00:25:11 +02:00
# alternatively, you can use the cursor keys:
2011-06-08 20:49:49 +02:00
bindsym Mod1+Left focus left
bindsym Mod1+Down focus down
bindsym Mod1+Up focus up
bindsym Mod1+Right focus right
2010-06-30 00:25:11 +02:00
2011-06-16 18:58:49 +02:00
# move focused window
2014-06-13 01:34:57 +02:00
bindsym Mod1+Shift+$left move left
bindsym Mod1+Shift+$down move down
bindsym Mod1+Shift+$up move up
bindsym Mod1+Shift+$right move right
2010-06-30 00:25:11 +02:00
# alternatively, you can use the cursor keys:
2011-02-20 02:11:03 +01:00
bindsym Mod1+Shift+Left move left
bindsym Mod1+Shift+Down move down
bindsym Mod1+Shift+Up move up
2011-07-11 19:42:30 +02:00
bindsym Mod1+Shift+Right move right
2009-03-11 18:56:31 +01:00
2011-06-16 18:58:49 +02:00
# split in horizontal orientation
bindsym Mod1+h split h
# split in vertical orientation
bindsym Mod1+v split v
# enter fullscreen mode for the focused container
2014-10-26 19:33:09 +01:00
bindsym Mod1+f fullscreen toggle
2011-06-16 18:58:49 +02:00
Introduce splith/splitv layouts, remove orientation
With this commit, the "default" layout is replaced by the splith and
splitv layouts. splith is equivalent to default with orientation
horizontal and splitv is equivalent to default with orientation
vertical.
The "split h" and "split v" commands continue to work as before, they
split the current container and you will end up in a split container
with layout splith (after "split h") or splitv (after "split v").
To change a splith container into a splitv container, use either "layout
splitv" or "layout toggle split". The latter command is used in the
default config as mod+l (previously "layout default"). In case you have
"layout default" in your config file, it is recommended to just replace
it by "layout toggle split", which will work as "layout default" did
before when pressing it once, but toggle between horizontal/vertical
when pressing it repeatedly.
The rationale behind this commit is that it’s cleaner to have all
parameters that influence how windows are rendered in the layout itself
rather than having a special parameter in combination with only one
layout. This enables us to change existing split containers in all cases
without breaking existing features (see ticket #464). Also, users should
feel more confident about whether they are actually splitting or just
changing an existing split container now.
As a nice side-effect, this commit brings back the "layout toggle"
feature we once had in i3 version 3 (see the userguide).
AFAIK, it is safe to use in-place restart to upgrade into versions
after this commit (switching to an older version will break your layout,
though).
Fixes #464
2012-08-04 03:04:00 +02:00
# change container layout (stacked, tabbed, toggle split)
2011-06-16 18:58:49 +02:00
bindsym Mod1+s layout stacking
bindsym Mod1+w layout tabbed
Introduce splith/splitv layouts, remove orientation
With this commit, the "default" layout is replaced by the splith and
splitv layouts. splith is equivalent to default with orientation
horizontal and splitv is equivalent to default with orientation
vertical.
The "split h" and "split v" commands continue to work as before, they
split the current container and you will end up in a split container
with layout splith (after "split h") or splitv (after "split v").
To change a splith container into a splitv container, use either "layout
splitv" or "layout toggle split". The latter command is used in the
default config as mod+l (previously "layout default"). In case you have
"layout default" in your config file, it is recommended to just replace
it by "layout toggle split", which will work as "layout default" did
before when pressing it once, but toggle between horizontal/vertical
when pressing it repeatedly.
The rationale behind this commit is that it’s cleaner to have all
parameters that influence how windows are rendered in the layout itself
rather than having a special parameter in combination with only one
layout. This enables us to change existing split containers in all cases
without breaking existing features (see ticket #464). Also, users should
feel more confident about whether they are actually splitting or just
changing an existing split container now.
As a nice side-effect, this commit brings back the "layout toggle"
feature we once had in i3 version 3 (see the userguide).
AFAIK, it is safe to use in-place restart to upgrade into versions
after this commit (switching to an older version will break your layout,
though).
Fixes #464
2012-08-04 03:04:00 +02:00
bindsym Mod1+e layout toggle split
2011-06-16 18:58:49 +02:00
# toggle tiling / floating
bindsym Mod1+Shift+space floating toggle
2011-07-11 16:57:16 +02:00
# change focus between tiling / floating windows
bindsym Mod1+space focus mode_toggle
2011-06-16 18:58:49 +02:00
# focus the parent container
2011-07-11 17:22:10 +02:00
bindsym Mod1+a focus parent
2011-06-16 18:58:49 +02:00
# focus the child container
#bindsym Mod1+d focus child
2013-09-14 20:57:42 +02:00
# move the currently focused window to the scratchpad
bindsym Mod1+Shift+minus move scratchpad
# Show the next scratchpad window or hide the focused scratchpad window.
# If there are multiple scratchpad windows, this command cycles through them.
bindsym Mod1+minus scratchpad show
2017-12-26 11:29:42 +01:00
# Define names for default workspaces for which we configure key bindings later on.
# We use variables to avoid repeating the names in multiple places.
2017-12-23 12:28:03 +01:00
set $ws1 "1"
set $ws2 "2"
set $ws3 "3"
set $ws4 "4"
set $ws5 "5"
set $ws6 "6"
set $ws7 "7"
set $ws8 "8"
set $ws9 "9"
set $ws10 "10"
2011-06-16 18:58:49 +02:00
# switch to workspace
2017-12-23 12:28:03 +01:00
bindsym Mod1+1 workspace $ws1
bindsym Mod1+2 workspace $ws2
bindsym Mod1+3 workspace $ws3
bindsym Mod1+4 workspace $ws4
bindsym Mod1+5 workspace $ws5
bindsym Mod1+6 workspace $ws6
bindsym Mod1+7 workspace $ws7
bindsym Mod1+8 workspace $ws8
bindsym Mod1+9 workspace $ws9
bindsym Mod1+0 workspace $ws10
2009-02-25 01:44:34 +01:00
2011-06-16 18:58:49 +02:00
# move focused container to workspace
2017-12-23 12:28:03 +01:00
bindsym Mod1+Shift+1 move container to workspace $ws1
bindsym Mod1+Shift+2 move container to workspace $ws2
bindsym Mod1+Shift+3 move container to workspace $ws3
bindsym Mod1+Shift+4 move container to workspace $ws4
bindsym Mod1+Shift+5 move container to workspace $ws5
bindsym Mod1+Shift+6 move container to workspace $ws6
bindsym Mod1+Shift+7 move container to workspace $ws7
bindsym Mod1+Shift+8 move container to workspace $ws8
bindsym Mod1+Shift+9 move container to workspace $ws9
bindsym Mod1+Shift+0 move container to workspace $ws10
2011-06-16 18:58:49 +02:00
# reload the configuration file
2011-07-11 17:22:10 +02:00
bindsym Mod1+Shift+c reload
2011-06-16 18:58:49 +02:00
# restart i3 inplace (preserves your layout/session, can be used to upgrade i3)
2011-07-11 17:22:10 +02:00
bindsym Mod1+Shift+r restart
2011-06-16 18:58:49 +02:00
# exit i3 (logs you out of your X session)
2018-10-07 22:43:24 +02:00
bindsym Mod1+Shift+e exec "i3-nagbar -t warning -m 'You pressed the exit shortcut. Do you really want to exit i3? This will end your X session.' -B 'Yes, exit i3' 'i3-msg exit'"
2011-07-11 17:11:13 +02:00
# resize window (you can also use the mouse for that)
mode "resize" {
# These bindings trigger as soon as you enter the resize mode
2012-04-08 15:59:49 +02:00
# Pressing left will shrink the window’ s width.
# Pressing right will grow the window’ s width.
# Pressing up will shrink the window’ s height.
# Pressing down will grow the window’ s height.
2014-06-13 01:34:57 +02:00
bindsym $left resize shrink width 10 px or 10 ppt
bindsym $down resize grow height 10 px or 10 ppt
bindsym $up resize shrink height 10 px or 10 ppt
bindsym $right resize grow width 10 px or 10 ppt
2011-07-11 17:22:10 +02:00
# same bindings, but for the arrow keys
2012-04-08 15:59:49 +02:00
bindsym Left resize shrink width 10 px or 10 ppt
bindsym Down resize grow height 10 px or 10 ppt
bindsym Up resize shrink height 10 px or 10 ppt
bindsym Right resize grow width 10 px or 10 ppt
2011-07-11 17:11:13 +02:00
2018-01-05 01:14:57 +01:00
# back to normal: Enter or Escape or Mod1+r
2011-07-11 17:11:13 +02:00
bindsym Return mode "default"
bindsym Escape mode "default"
2017-10-31 02:19:12 +01:00
bindsym Mod1+r mode "default"
2011-07-11 17:11:13 +02:00
}
bindsym Mod1+r mode "resize"
2011-07-11 20:02:25 +02:00
2011-07-27 13:32:27 +02:00
# Start i3bar to display a workspace bar (plus the system information i3status
# finds out, if available)
2011-10-21 20:01:02 +02:00
bar {
2011-11-27 14:18:50 +01:00
status_command i3status
2011-10-21 20:01:02 +02:00
}
2011-07-27 13:32:27 +02:00
2011-07-11 20:02:25 +02:00
#######################################################################
# automatically start i3-config-wizard to offer the user to create a
2015-03-12 05:41:43 +01:00
# keysym-based config which used their favorite modifier (alt or windows)
2011-07-11 20:02:25 +02:00
#
# i3-config-wizard will not launch if there already is a config file
2019-03-28 20:29:09 +01:00
# in ~/.config/i3/config (or $XDG_CONFIG_HOME/i3/config if set) or
# ~/.i3/config.
2011-07-11 20:02:25 +02:00
#
# Please remove the following exec line:
#######################################################################
exec i3-config-wizard