nvx

Simple script running nvidia-settings (with anti-tearing) based on your configured layout

Configuration

The configuration is stored in the file ~/.config/nvx/nvx.conf. It is a simple INI file, which contains the following sections:

• Layout: defines the layout matrix using the screen indices and can have multiple rows.
• Screens: must be called Screen_<screen index> and defines the screen properties.

Example

# $HOME/.config/nvx/nvx.conf
[Layout]
Row_1 = 0 4 0
Row_2 = 1 2 3

[Screen_0]
ScreenID = DUMMY-0
ScreenName = Dummy 0
ScreenResolution = 2560x1440
ScreenRefreshRate = 0

[Screen_1]
ScreenID = DP-4
ScreenName = Left Screen
ScreenResolution = 2560x1440
ScreenRefreshRate = 144

[Screen_2]
ScreenID = DP-0
ScreenName = Center Screen
ScreenResolution = 2560x1440
ScreenRefreshRate = 144

[Screen_3]
ScreenID = DP-2
ScreenName = Right Screen
ScreenResolution = 2560x1440
ScreenRefreshRate = 144

[Screen_4]
ScreenID = DP-3
ScreenName = Top Screen
ScreenResolution = 2560x1440
ScreenRefreshRate = 144

Notes:

• A dummy screen maybe used for offsetting the screens, you must call is DUMMY-<index>

Installation

Using pip

pip3 install nvx

Running

⚠️ Running nvx for the first time without prior configuration will write the default config. Make sure to properly edit the generated configuration before running nvx again (you can use the output from xrandr to figure out the screen properties). Improperly configured screens could result in a black screen when running the script.

$ nvx --help

usage: main.py [-h] [-w WRAP] [layout ...]

Configure nvidia-settings for multiple screens

positional arguments:
  layout                Screen layout, e.g. 1 2 3, defaults to config file

options:
  -h, --help            show this help message and exit
  -w WRAP, --wrap WRAP  Number of screens per row, e.g. 2 with 4 screens will result in 2x2 layout, infinite if not set

$ nvx # runs using the default configuration
$ nvx 1 2 3 # overrides the layout to [1][2][3] with corresponding screens ids from the configuration
$ nvx 1 2 3 4 --wrap 2 # makes a 2x2 layout: [1][2]
                       #                     [3][4]