nixo
/
gri3-wm
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
gri3-wm/etc/config

207 lines
7.3 KiB
Plaintext
Raw Normal View History

Automatically call the migration script when the config does not look like v4
2011-07-06 20:40:46 +02:00
# i3 config file (v4)
#
Replace http:// with https:// where applicable The testcases will be updated automatically in a separate commit.
2017-09-24 10:19:07 +02:00
# Please see https://i3wm.org/docs/userguide.html for a complete reference!
default config: convert to QWERTY, add comments
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
#
Implement moving containers, implement moving windows to the top if top-most, change config to use Mod3
2009-03-11 18:56:31 +01:00
default config: include a short explanation about xft fonts
2012-08-13 13:34:30 +02:00
# Font for window titles. Will also be used by the bar unless a different font
default config: switch to “DejaVu Sans Mono 8” as default font As mentioned in the comment, this change is motivated by better support for unicode, right-to-left rendering and scalability on retina/hidpi setups.
2014-06-08 22:25:59 +02:00
# is used in the bar {} block below.
Config: use default system monospace Use the default monospace font for the system in the default config. This should be a bit more portable for systems that do not have the recommended font installed.
2015-02-21 23:34:26 +01:00
font pango:monospace 8
default config: switch to “DejaVu Sans Mono 8” as default font As mentioned in the comment, this change is motivated by better support for unicode, right-to-left rendering and scalability on retina/hidpi setups.
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).
Config: use default system monospace Use the default monospace font for the system in the default config. This should be a bit more portable for systems that do not have the recommended font installed.
2015-02-21 23:34:26 +01:00
#font pango:DejaVu Sans Mono 8
default config: start xss-lock+i3lock, nm-applet, pactl (volume key) This change will make things strictly better for new users (without an existing configuration file) and has no effect on existing users. The tools should be fairly uncontentious, I hope, especially as they only serve as a starting point anyway: users can quickly delete what they don’t want, or change it into what they prefer. But having something is strictly better than having nothing :) We make some space in the config file by removing the old paragraph about pixel fonts, which seems rather outdated and irrelevant to me.
2019-07-28 17:55:44 +02:00
# The combination of xss-lock, nm-applet and pactl is a popular choice, so
# they are included here as an example. Modify as you see fit.
# xss-lock grabs a logind suspend inhibit lock and will use i3lock to lock the
default config: mention loginctl lock-session alongside xss-lock
2019-08-15 21:16:12 +02:00
# screen before suspend. Use loginctl lock-session to lock your screen.
default config: start xss-lock+i3lock, nm-applet, pactl (volume key) This change will make things strictly better for new users (without an existing configuration file) and has no effect on existing users. The tools should be fairly uncontentious, I hope, especially as they only serve as a starting point anyway: users can quickly delete what they don’t want, or change it into what they prefer. But having something is strictly better than having nothing :) We make some space in the config file by removing the old paragraph about pixel fonts, which seems rather outdated and irrelevant to me.
2019-07-28 17:55:44 +02:00
exec --no-startup-id xss-lock --transfer-sleep-lock -- i3lock --nofork
# NetworkManager is the most popular way to manage wireless networks on Linux,
# and nm-applet is a desktop environment-independent system tray GUI for it.
exec --no-startup-id nm-applet
# Use pactl to adjust volume in PulseAudio.
default config: immediately refresh i3status after volume changes
2019-08-15 20:33:33 +02:00
set $refresh_i3status killall -SIGUSR1 i3status
bindsym XF86AudioRaiseVolume exec --no-startup-id pactl set-sink-volume @DEFAULT_SINK@ +10% && $refresh_i3status
bindsym XF86AudioLowerVolume exec --no-startup-id pactl set-sink-volume @DEFAULT_SINK@ -10% && $refresh_i3status
bindsym XF86AudioMute exec --no-startup-id pactl set-sink-mute @DEFAULT_SINK@ toggle && $refresh_i3status
default config: add XF86AudioMicMute
2019-08-15 20:56:58 +02:00
bindsym XF86AudioMicMute exec --no-startup-id pactl set-source-mute @DEFAULT_SOURCE@ toggle && $refresh_i3status
Implement configuration file parsing
2009-02-25 00:50:30 +01:00
default config: use `set` for directions Using `set` for direction letter keys makes them easier to configure for users who prefer traditional vim-style directions.
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
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# use Mouse+Mod1 to drag floating windows to their wanted position
Implement the configuration option floating_modifier and document it
2009-06-24 20:31:00 +02:00
floating_modifier Mod1
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# start a terminal
Introduce the i3-sensible-{pager,editor,terminal} scripts The former two provide fallbacks in case $PAGER or $EDITOR is not set (which might be more common than you think, because they have to be set in ~/.xsession, not in the shell configuration!) while the latter tries to launch a terminal emulator. The scripts are most prominently used in i3-nagbar, which alerts the user when the configuration is broken for some reason. Also, i3-sensible-terminal is used in the default configuration. This commit does not rely on the shell supporting ${PAGER:-less} anymore, which is not the case for 'fish'.
2011-09-25 19:45:51 +02:00
bindsym Mod1+Return exec i3-sensible-terminal
update configfile for the new commands (this is not the final default config file)
2010-06-30 00:25:11 +02:00
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# kill focused window
default config: convert to QWERTY, add comments
2011-07-11 17:22:10 +02:00
bindsym Mod1+Shift+q kill
update configfile for the new commands (this is not the final default config file)
2010-06-30 00:25:11 +02:00
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# start dmenu (a program launcher)
Don’t use absolute paths in the default config (Thanks cls) Fixes #489
2011-08-23 21:30:09 +02:00
bindsym Mod1+d exec dmenu_run
Mention rofi in default config file Fixes #2482
2020-05-02 02:34:15 +02:00
# A more modern dmenu replacement is rofi:
# bindsym Mod1+d exec rofi -modi drun,run -show drun
# There also is i3-dmenu-desktop which only displays applications shipping a
# .desktop file. It is a wrapper around dmenu, so you need that installed.
recommend i3-dmenu-desktop in the default config We might replace dmenu_run in v4.5, depending on the feedback we get for v4.4.
2012-12-11 22:36:29 +01:00
# bindsym Mod1+d exec --no-startup-id i3-dmenu-desktop
update configfile for the new commands (this is not the final default config file)
2010-06-30 00:25:11 +02:00
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# change focus
default config: use `set` for directions Using `set` for direction letter keys makes them easier to configure for users who prefer traditional vim-style directions.
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
update configfile for the new commands (this is not the final default config file)
2010-06-30 00:25:11 +02:00
# alternatively, you can use the cursor keys:
CONFIG BREAK: kick the 'next'/'prev' commands, introduce 'focus left' etc. Instead of the cryptic next/prev commands, we now provide an argument to the focus command. Userguide and default config is updated.
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
update configfile for the new commands (this is not the final default config file)
2010-06-30 00:25:11 +02:00
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# move focused window
default config: use `set` for directions Using `set` for direction letter keys makes them easier to configure for users who prefer traditional vim-style directions.
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
update configfile for the new commands (this is not the final default config file)
2010-06-30 00:25:11 +02:00
# alternatively, you can use the cursor keys:
also change the cursor keys to the new move syntax
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
default config: put bindings in the right order (left/down/up/right)
2011-07-11 19:42:30 +02:00
bindsym Mod1+Shift+Right move right
Implement moving containers, implement moving windows to the top if top-most, change config to use Mod3
2009-03-11 18:56:31 +01:00
config: change order, normalize comments, more comments, remove advanced/experimental bindings
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
Extend the fullscreen command Rather than just toggling the fullscreen modes, allow to set them directly with: fullscreen enable|toggle [global] fullscreen disable For compatibility, retain the previous command and its toggling behavior: fullscreen [global] fixes #1120
2014-10-26 19:33:09 +01:00
bindsym Mod1+f fullscreen toggle
config: change order, normalize comments, more comments, remove advanced/experimental bindings
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)
config: change order, normalize comments, more comments, remove advanced/experimental bindings
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
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# toggle tiling / floating
bindsym Mod1+Shift+space floating toggle
default config: add binding to change focus between tiling / floating windows
2011-07-11 16:57:16 +02:00
# change focus between tiling / floating windows
bindsym Mod1+space focus mode_toggle
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# focus the parent container
default config: convert to QWERTY, add comments
2011-07-11 17:22:10 +02:00
bindsym Mod1+a focus parent
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# focus the child container
#bindsym Mod1+d focus child
Add scratchpad bindings to the default config.
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
Shorten comment for workspace variables The old comments gave the impression that you had to define workspace names upfront, which is not true. This also keeps the overall config as brief as possible.
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.
Add workspace vars to support DRY when customizing Relabeling the workspaces required the user to update the labels at least in two places of the i3 config file (switch to workspace + move focused container to workspace) to keep a consistent state. This got even worse when the user started to reference the workspaces elsewhere, e.g. for assigning containers to specific workspaces. This change supports the DRY principle for users. Relabeling the workspaces is now merely a matter of changing the respective variable ($ws1, $ws2, … $ws10).
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"
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# switch to workspace
default config: use workspace number, not just workspace This is strictly better: if the configured name does not match the current name, the correct workspace will still be used. When creating a new workspace, the configured name is still used.
2019-07-28 17:58:39 +02:00
bindsym Mod1+1 workspace number $ws1
bindsym Mod1+2 workspace number $ws2
bindsym Mod1+3 workspace number $ws3
bindsym Mod1+4 workspace number $ws4
bindsym Mod1+5 workspace number $ws5
bindsym Mod1+6 workspace number $ws6
bindsym Mod1+7 workspace number $ws7
bindsym Mod1+8 workspace number $ws8
bindsym Mod1+9 workspace number $ws9
bindsym Mod1+0 workspace number $ws10
Bugfix: when a window is unmapped, correctly pass focus to the next one and cleanup the table
2009-02-25 01:44:34 +01:00
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# move focused container to workspace
default config: use workspace number, not just workspace This is strictly better: if the configured name does not match the current name, the correct workspace will still be used. When creating a new workspace, the configured name is still used.
2019-07-28 17:58:39 +02:00
bindsym Mod1+Shift+1 move container to workspace number $ws1
bindsym Mod1+Shift+2 move container to workspace number $ws2
bindsym Mod1+Shift+3 move container to workspace number $ws3
bindsym Mod1+Shift+4 move container to workspace number $ws4
bindsym Mod1+Shift+5 move container to workspace number $ws5
bindsym Mod1+Shift+6 move container to workspace number $ws6
bindsym Mod1+Shift+7 move container to workspace number $ws7
bindsym Mod1+Shift+8 move container to workspace number $ws8
bindsym Mod1+Shift+9 move container to workspace number $ws9
bindsym Mod1+Shift+0 move container to workspace number $ws10
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# reload the configuration file
default config: convert to QWERTY, add comments
2011-07-11 17:22:10 +02:00
bindsym Mod1+Shift+c reload
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# restart i3 inplace (preserves your layout/session, can be used to upgrade i3)
default config: convert to QWERTY, add comments
2011-07-11 17:22:10 +02:00
bindsym Mod1+Shift+r restart
config: change order, normalize comments, more comments, remove advanced/experimental bindings
2011-06-16 18:58:49 +02:00
# exit i3 (logs you out of your X session)
i3-nagbar: add option for button that runs commands without a terminal (#3258) Fixes #2199.
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'"
default config: add resize mode
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
Implement resize <grow|shrink> <width|height>, use it in the default config Fixes: #576
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.
default config: use `set` for directions Using `set` for direction letter keys makes them easier to configure for users who prefer traditional vim-style directions.
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
default config: convert to QWERTY, add comments
2011-07-11 17:22:10 +02:00
# same bindings, but for the arrow keys
Implement resize <grow|shrink> <width|height>, use it in the default config Fixes: #576
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
default config: add resize mode
2011-07-11 17:11:13 +02:00
config: add comment $mod+r in back to normal when resize window
2018-01-05 01:14:57 +01:00
# back to normal: Enter or Escape or Mod1+r
default config: add resize mode
2011-07-11 17:11:13 +02:00
bindsym Return mode "default"
bindsym Escape mode "default"
$mod+r toggles resize mode
2017-10-31 02:19:12 +01:00
bindsym Mod1+r mode "default"
default config: add resize mode
2011-07-11 17:11:13 +02:00
}
bindsym Mod1+r mode "resize"
default config: start i3-config-wizard
2011-07-11 20:02:25 +02:00
default config: start i3bar -d by default like i3-migrate-config-to-v4.pl does it
2011-07-27 13:32:27 +02:00
# Start i3bar to display a workspace bar (plus the system information i3status
# finds out, if available)
change default config to use 'bar' blocks (Thanks mxf)
2011-10-21 20:01:02 +02:00
bar {
convert tabs into whitespaces in config files
2011-11-27 14:18:50 +01:00
status_command i3status
change default config to use 'bar' blocks (Thanks mxf)
2011-10-21 20:01:02 +02:00
}
default config: start i3bar -d by default like i3-migrate-config-to-v4.pl does it
2011-07-27 13:32:27 +02:00
default config: start i3-config-wizard
2011-07-11 20:02:25 +02:00
#######################################################################
# automatically start i3-config-wizard to offer the user to create a
degendered terms
2015-03-12 05:41:43 +01:00
# keysym-based config which used their favorite modifier (alt or windows)
default config: start i3-config-wizard
2011-07-11 20:02:25 +02:00
#
# i3-config-wizard will not launch if there already is a config file
etc/config: Mention ~/.config/i3/config
2019-03-28 20:29:09 +01:00
# in ~/.config/i3/config (or $XDG_CONFIG_HOME/i3/config if set) or
# ~/.i3/config.
default config: start i3-config-wizard
2011-07-11 20:02:25 +02:00
#
# Please remove the following exec line:
#######################################################################
exec i3-config-wizard