EVE-min is a client-switcher for EVE Online built for Linux's CachyOS & KDE Plasma designed primarily for multiboxers who actively juggle many characters across fewer accounts. However, it can also act as a simple 'cycle-switcher' for less-complicated multiboxing setups. It does not generate thumbnail previews.
This software is congruent with EVE's Terms of Service because nothing here touches anything in game.
Unlike conventional client-switchers, targeted hotkeys in EVE-min don't switch between characters. Instead, hotkeys switch between active clients based on an order of character names you provide. The idea is for hotkeys to remain tight regardless of character selection or count. For example, if you've got characters 1, 4, and 7 logged in, the hotkeys would stay as 1, 2, and 3. If you log out of 7 and into 9, the hotkeys are still 1, 2, and 3.
Another focus of this tool is to fully utilize EVE's throttling mechanics. It achieves this by seamlessly minimizing inactive clients while switching. This offers a dramatic boost in performance, but also eliminates the ability to generate thumbnail previews. Since I don't use previews anyway, this is not a sacrifice.
Because speed and responsiveness are important when multiboxing, this script uses KWin scripts served over dbus to actually manipulate the windows. This bypasses Plasma's frontend and performs our operations in a much faster environment.
Out of Focus vs. Hidden
Many players believe that if an EVE client's window is out of focus or in another virtual desktop/workspace, that window will be throttled for performance purposes. But if a window is out of focus but not minimized, it will only be partially throttled.
On the other hand, minimizing a client will trigger both layers of throttling: "Not focused" and "Window hidden". When fully-throttled, an EVE client will consume virtually zero resources from the GPU. Therefore minimizing inactive windows dramatically boosts peformance while multiboxing.
Without minimizing I use what feels like the whole GPU:
With minimizing I use less than half of the GPU:
EVE-min is a script that you can run as a command to manipulate your EVE clients. The script does nothing on its own and must be provided flags to indicate which behavior or combination of behaviors you'd like to enact. The flags are as follows:
"r"refreshes active clients- This command creates a list of currently-logged-in clients
- The list is then used by other commands
"f"and"b"cycle forward and backward through clients"1","3", and"12"target specific clients- This command will look for the Nth active character
- This uses the order listed
characters.txt
"m"minimizes all clients"k"kills all clients
Combination Flags: The "r" flag can be prepended to target flags like "rf", "rb", "r1", and "r5" to perform both actions at once, avoiding the need for a dedicated refresh button. However, be aware that refreshing slows down switches. Unless performance doesn't matter to you, use combination flags sparingly.
- KDE Plasma for KWin scripting (technically just the compositor is needed)
- The qt5-tools package for
qdbus(comes with KDE Plasma)- Install:
sudo pacman -S qt5-tools
- Install:
- The kdotool package for window IDing (easy installation instructions below)
- Install (one-line):
curl -s -L https://github.com/jinliu/kdotool/releases/download/v0.2.2-pre/kdotool.tar.gz | sudo tar xf - -C /usr/local/bin/
- Install (one-line):
- Install dependencies from above (qt5tools, kdotool)
- Download the EVE-min repository to
~/Documentswith these commands:mkdir ~/Documents/eve-mingit clone https://github.com/chloroken/eve-min ~/Documents/eve-min
- Grant executable permission to the script with this command:
sudo chmod a+x ~/Documents/eve-min/switch.sh
- Use a text editor to open
~/Documents/eve-min/characters.txtto add characters - If using Lutris instead of Steam, edit line 12 of
switch.shas commented - Proceed to the Usage Guide section below
- Back up your
characters.txtfile - Remove the entire
eve-mindirectory - Continue from step 2 above
- Replace the new
characters.txtwith your backup
- Remove the entire
eve-mindirectory - To remove
kdotool, in a terminal run:sudo rm /usr/local/bin/kdotool
- Leave
qt5-toolsunless you know you don't need it
In KDE Plasma's System Settings → Keyboard → Shortcuts, bind the scripts with the following format:
bash -c '~/Documents/eve-min/switch.sh "<flag>"'- Replace
<flag>with the desired flag from the How It Works section above
- One-button wonder:
bash -c '~/Documents/eve-min/switch.sh "rf"'refreshes active characters & cycles forward- NOTE: Combining "r" with another flag makes switching slower. Other setups are more ideal.
- Targeted switching (my setup):
- F1:
bash -c '~/Documents/eve-min/switch.sh "1"'switches to first client - F2:
bash -c '~/Documents/eve-min/switch.sh "2"'switches to second client - F3:
bash -c '~/Documents/eve-min/switch.sh "3"'switches to third client - F4:
bash -c '~/Documents/eve-min/switch.sh "4"'switches to fourth client - F5:
bash -c '~/Documents/eve-min/switch.sh "5"'switches to fifth client - F6:
bash -c '~/Documents/eve-min/switch.sh "r"'refreshes active clients - F7:
bash -c '~/Documents/eve-min/switch.sh "m"'minimizes all clients - F8:
bash -c '~/Documents/eve-min/switch.sh "k"'kills all clients
- F1:
- Quick cycler:
- Mouse Forward:
bash -c '~/Documents/eve-min/switch.sh "f"'cycles forward - Mouse Back:
bash -c '~/Documents/eve-min/switch.sh "b"'cycles backward - Capslock:
bash -c '~/Documents/eve-min/switch.sh "r"'refreshes active clients
- Mouse Forward:
- Log into EVE Online with desired characters
- Use any shortcut containing the
"r"flag- This "locks in" active characters based on the order supplied in
characters.txt - This is particularly useful when changing characters - keybinds will persist until a refresh
- This "locks in" active characters based on the order supplied in
- Use chosen shortcuts to switch between clients
Cycle scriptBlocklist (for launcher or other purposes)Addkdotoolto$pathCreate an installation script that pullskdotoolAllow for higher-count targeted switching (stops at 9 now)Add"m"flag to minimize all clientsAdd"k"flag to kill all clientsRefactor using dbus for speedFix cycling issues- Have target switches adjust cycle index
- Remove kdotool as a depedency altogether
- Make dbus interaction distro agnostic





