• Stars
    star
    138
  • Rank 264,508 (Top 6 %)
  • Language
    Go
  • License
    GNU General Publi...
  • Created over 5 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

i3wm multiple monitors auto configuration

i3-autodisplay

i3-autodisplay is a i3wm display auto-configuration for multiple monitors

Go Report Card GitHub release (latest SemVer)

Installation

Pre requisites

xrandr program

Pre built binary

Fetch the latest release.

Archlinux AUR

From sources

git clone https://github.com/lpicanco/i3-autodisplay.git
cd i3-autodisplay
go build cmd/i3-autodisplay/i3-autodisplay.go

Usage

i3-autodisplay requires a configuration file to work. The configuration file can be loaded from these locations:

  • $XDG_HOME/i3-autodisplay/config.yml
  • $HOME/.config/i3-autodisplay/config.yml
  • Specified via -config parameter

In your i3wm configuration add the following line:

exec --no-startup-id <path to i3-autodisplay>

Usage via command line:

./i3-autodisplay -config sample_config.yml

Sample configuration file:

displays:
  - name: eDP1
    workspaces: [1,2,3,4,5,6,7,8,9,0]
  - name: HDMI1
    workspaces: [2,4,6,8]
    randr_extra_options: "--left-of eDP1"
  - name: DP1
    workspaces: [1,3,5,7,9]
    randr_extra_options: "--left-of HDMI1"