Skip to content

Repository files navigation

EVE Preview Manager

Website | Discord | Flathub | AUR | FlakeHub

EVE Preview Manager is a Linux-native tool for managing multiple EVE Online clients, with live window previews, configurable hotkeys, and quick-swap profiles built for multiboxing.


Features

  • Real-time thumbnail previews of all EVE client windows
  • Per-character and cycle group hotkeys with configurable key bindings
  • Customizable thumbnail appearance including size, opacity, fonts, colors, and borders
  • Profile-based configuration system for managing multiple setups
  • One-click character import for cycle groups
  • Optional cycling through logged-off clients
  • Auto-minimize inactive windows and inherit positions for new characters
  • Option to disable thumbnails altogether

Screenshots

EVE Preview Manager in action EVE Preview Manager Settings


Usage

  1. Launch the Application: Run eve-preview-manager (or flatpak run com.evepreview.manager). It starts in GUI mode and creates a system tray icon.
  2. Manage Profiles: Use the GUI to create specific profiles for different activities (e.g., PvP, Mining). You can add, remove, or duplicate profiles to quickly switch between setups.
  3. Configure Display Settings: Customize the look and feel of your thumbnails, including size, opacity, fonts, borders, and colors to match your preferences.
  4. Set Up Hotkeys: Configure hotkeys to cycle between clients in your active group.
  5. Manage Characters:
    • Add Characters: Click the "Add" button to include EVE characters in your cycle group. Active and previously detected clients will appear in the popup.
    • Manual Entry: Alternatively, switch to "Text Editor" mode to manually paste a list of character names (one per line).
    • Individual Hotkeys: Once added to the cycle group, you can bind specific hotkeys to individual characters for direct access.
  6. Save & Apply: Click "Save & Apply" to save your current configuration and refresh the previews.
  7. Swap Profiles: Swapping profiles can be done quickly by right-clicking the system tray icon and selecting the desired profile.

Note: Configuration is stored in ~/.config/eve-preview-manager/config.json.


System Requirements

  • Required: OpenGL, fontconfig, dbus, libxkbcommon, libxcb (standard on most distros).
  • Recommended: Wayland (via XWayland). Native X11 environments are supported but users may experience issues with preview overlays fighting for Z-order and incorrect image offsets.
  • Optional: If using evdev instead of x11 hotkeys, you will need to add your user to the input group. Not recommended unless you know what you're doing.

Installation

Flatpak

Install from Flathub:

flatpak install flathub com.evepreview.manager

Arch Linux (AUR)

Install from the AUR using your preferred AUR helper (e.g., paru, yay, pamac, pikaur, etc):

paru -S eve-preview-manager

NixOS

1. Add Flake Input

Add the input to your flake.nix. We use FlakeHub for versioned releases.

inputs = {
  eve-preview-manager.url = "https://flakehub.com/f/h0lylag/EVE-Preview-Manager/*";
};

2. Add Package

Add the package to your system packages.

{
  environment.systemPackages = [
    eve-preview-manager.packages.${pkgs.stdenv.hostPlatform.system}.default
  ];
}

Manual Installation

Download the latest release from the Releases page. This archive contains a standalone binary that works on most major Linux distributions (Ubuntu, Fedora, etc.).

unzip eve-preview-manager-v*.zip
chmod +x ./eve-preview-manager
./eve-preview-manager

Build from Source

Build dependencies: Rust/Cargo, pkg-config, fontconfig, dbus, X11, libxkbcommon

git clone https://github.com/h0lylag/EVE-Preview-Manager.git
cargo build --release

Contributing

Contributions are welcome! If you find a bug or have a feature request, please open an issue. Pull requests are also appreciated.


License

Distributed under the MIT License. See LICENSE for more information.

Releases

Packages

Used by

Contributors

Languages