The goal of this CLI is to lower the barrier for Linux users to
use their eGPU on the Linux Desktop. With the egpu-switcher config
command the user can choose their external GPU.
On every bootup the service will check if the eGPU is connected
and if so, make X.Org prefer it.
- No hotplugging is possible. Users still need to reboot their computer to connect / disconnect the eGPU.
- Running X.Org
- Thunderbolt connection to eGPU is authorized
- Necessary graphics drivers for eGPU are installed
The PPA is no longer maintained for now (see #90)
paru -S egpu-switcherNote: paru is an AUR helper written in Rust 🦀
Installation and setup:
git clone [email protected]:hertg/egpu-switcher.git
cd egpu-switcher
make build -s
sudo make install -s
sudo egpu-switcher enableUninstall:
sudo egpu-switcher disable
sudo make uninstall -sUsage:
egpu-switcher [command]
Available Commands:
config Choose your external GPU
disable Disable egpu-switcher from running at startup
enable Enable egpu-switcher to run at startup
help Help about any command
switch Check if eGPU is present and configure X.org accordingly
version Print version information
Flags:
-h, --help help for egpu-switcher
-v, --verbose verbose output
Use "egpu-switcher [command] --help" for more information about a command.
The config file is created automatically and can be found at /etc/egpu-switcher/config.yaml.
Below you can see an example of a configuration file, annotated with some notes.
# the 'egpu' config is generated by 'egpu-switcher config'.
# you probably shouldn't change this manually.
egpu:
driver: amdgpu
id: 1153611719250962689
# OPTIONAL: how many times 'egpu-switcher switch auto' should retry finding the egpu.
# this can be helpful if the egpu takes some time to connect on your machine,
# the following values are the default, if this config is omitted.
detection:
retries: 6
interval: 500 # milliseconds
# OPTIONAL: if you want to execute a script after switching to egpu/internal.
# the values must be absolute paths to a shell script, this script will
# then be run with '/bin/sh $script'.
#
# it is required that the script is owned by root (uid 0)
# and has a permission of -rwx------ (0700), in order to
# prevent potential privilege escalation.
hooks:
internal: /home/michael/tmp/internal.sh
egpu: /home/michael/tmp/egpu.shIf you run into problems, please have a look at TROUBLESHOOT.md before reporting any issues.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent