diff options
| author | Donald Williams <129223418+dwilliam62@users.noreply.github.com> | 2026-04-30 03:25:07 -0400 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2026-04-30 03:25:07 -0400 |
| commit | 44ce230e970ddc36095f8be167d1fa1c2f203541 (patch) | |
| tree | b5362245d975cfe58979fd08a7f5847967a1c597 /docs/HOWTO-fix-ventoy-GUI.md | |
| parent | def3d5510b478de42c99039409efe09ed62c6800 (diff) | |
Development merge to main (#50)
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/hypr/configs/Keybinds.conf
new file: config/hypr/scripts/rofi-ssh-menu.sh
* Fixed duplicate keybind
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: Keybinds.conf
* Added script to disable cpu turbo and set power settings
CPU turbo will often spin up the fan, leave it high the slowly
drop the fan speed. Very noisy. 11th/12th gen notorious for this
Should be added to User Startup as needed
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
new file: config/hypr/scripts/disable.cpu.turbo.sh
* Updated dev branch version to v2.3.23
* Really updated the version this time
* Updated waybar style sheets to use `font-size: 14px` vs. `font-size: 99%` (#43)
* Trying to scale waybar
* Updating waybar sizing to support waybar 14+
font-size: 99% is no longer supported
On branch LUA-conversion
Your branch is up to date with 'origin/LUA-conversion'.
Changes to be committed:
modified: config/waybar/style/0-VERTICAL-Catpuccin-Mocha.css
modified: config/waybar/style/0-VERTICAL-Golden-Noir.css
modified: config/waybar/style/0-VERTICAL-Oglo-Chicklets.css
modified: config/waybar/style/Black-&-White-Monochrome.css
modified: config/waybar/style/Catppuccin-Frappe.css
modified: config/waybar/style/Catppuccin-Latte.css
modified: config/waybar/style/Catppuccin-Mocha.css
modified: config/waybar/style/Colored-Chroma-Glow.css
modified: config/waybar/style/Colored-Translucent.css
modified: config/waybar/style/Colorful-Aurora-Blossom.css
modified: config/waybar/style/Colorful-Aurora.css
modified: config/waybar/style/Colorful-Oglo-Chicklets.css
modified: config/waybar/style/Colorful-Rainbow-Spectrum.css
modified: config/waybar/style/Colorful-stolen-style.css
modified: config/waybar/style/Crystal-Clear-Glass.css
modified: config/waybar/style/Dark-Golden-Eclipse.css
modified: config/waybar/style/Dark-Golden-Noir.css
modified: config/waybar/style/Dark-Half-Moon.css
modified: config/waybar/style/Dark-Latte-Wallust-combined-v2.css
modified: config/waybar/style/Dark-Latte-Wallust-combined.css
modified: config/waybar/style/Dark-Purpl.css
modified: config/waybar/style/Dark-Wallust-Obsidian-Edge.css
modified: config/waybar/style/Extra-Arrow.css
modified: config/waybar/style/Extra-Crimson.css
modified: config/waybar/style/Extra-EverForest.css
modified: config/waybar/style/Extra-ML4W-starter.css
modified: config/waybar/style/Extra-Mauve.css
modified: config/waybar/style/Extra-Modern-Combined-Transparent.css
modified: config/waybar/style/Extra-Modern-Combined.css
modified: config/waybar/style/Extra-Neon-Circuit.css
modified: config/waybar/style/Extra-Prismatic-Glow.css
modified: config/waybar/style/Extra-Rose-Pine.css
modified: config/waybar/style/Extra-Simple-Pink.css
modified: config/waybar/style/Light-Monochrome-Contrast.css
modified: config/waybar/style/Light-Obsidian-Glow.css
modified: config/waybar/style/ML4W-Glass-3d.css
modified: config/waybar/style/ML4W-Glass.css
modified: config/waybar/style/Rainbow-RGB-Bordered.css
modified: config/waybar/style/Retro-Simple-Style.css
modified: config/waybar/style/Transparent-Crystal-Clear.css
modified: config/waybar/style/VERTICAL-Catpuccin-Mocha.css
modified: config/waybar/style/Wallust-Bordered-Chroma-Fusion-Edge.css
modified: config/waybar/style/Wallust-Bordered-Chroma-Simple.css
modified: config/waybar/style/Wallust-Box-type.css
modified: config/waybar/style/Wallust-Chroma-Edge.css
modified: config/waybar/style/Wallust-Chroma-Fusion.css
modified: config/waybar/style/Wallust-Chroma-Tally-V2.css
modified: config/waybar/style/Wallust-Chroma-Tally.css
modified: config/waybar/style/Wallust-Colored.css
modified: config/waybar/style/Wallust-ML4W-modern-mixed.css
modified: config/waybar/style/Wallust-ML4W-modern.css
modified: config/waybar/style/Wallust-Simple.css
modified: config/waybar/style/Wallust-Transparent-Crystal-Clear.css
* Added Window Rule for hyprwcenter
Hyprland built audio control panel
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: WindowRules-config-v3.conf
modified: WindowRules.conf
* Fixed rule for hyprpwcenter
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: WindowRules-config-v3.conf
modified: WindowRules.conf
* Added WindowRule for shelly app and waybar icon
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/hypr/configs/WindowRules.conf
modified: config/waybar/ModulesWorkspaces
* Udpated reference WindowRules-v3
* Removing Jakoolit references
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: 0-shared-fonts.rasi
modified: config.rasi
* Added support for awww transition effects
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/hypr/UserScripts/WallpaperAutoChange.sh
modified: config/hypr/UserScripts/WallpaperEffects.sh
modified: config/hypr/UserScripts/WallpaperRandom.sh
modified: config/hypr/UserScripts/WallpaperSelect.sh
* Fixed wallpaper per monitor restore failed
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: CHANGELOG.md
modified: config/hypr/UserScripts/WallpaperSelect.sh
modified: config/hypr/scripts/WallpaperDaemon.sh
* Fixed WallpaperSelect to create restore file per monitor
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/hypr/UserScripts/WallpaperSelect.sh
* Added Garuda assistant WindowRule
* Adj: Setting for hyprpolkitagent startup
Now setting depdendencies to after graphical target and part of
graphical target
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/systemd/user/hyprpolkitagent.service.d/override.conf
* Updated WindowRules added HyprMod GUI rule
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/hypr/configs/WindowRules-config-v3.conf
modified: config/hypr/configs/WindowRules.conf
* Added icon for HyprMod in ModulesWorkspaces
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/waybar/ModulesWorkspaces
* Added window rule for easy effects
* Added musical note icon for easy effects
* Added doc on how to fix ventoyGUI not starting
* Added doc on HOW to fix Ventoy GUI
On branch development
Your branch is ahead of 'origin/development' by 1 commit.
(use "git push" to publish your local commits)
Changes to be committed:
modified: docs/HOWTO-fix-ventoy-GUI.md
* Fixed: Hyprlock grace and parser errors
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: CHANGELOG.md
modified: config/hypr/hyprlock-1080p.conf
modified: config/hypr/hyprlock-2k.conf
modified: config/hypr/hyprlock.conf
* Updated hints.sh for new layouts
* Fixing KeyHints.sh
* Updated keyhints.sh removed extra row and text cleanup
* Creating workaround to polkit crash on missing QML
* Changed error to note on fresh install when bkup dir not there
* Fixed hang issue with lockscreen and WeatherWrap
the weather cache check now runs in the background
Shortend curl and ping timeouts in network connectivity check
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: CHANGELOG.md
modified: config/hypr/UserScripts/WeatherWrap.sh
modified: config/hypr/scripts/LockScreen.sh
* Added script to triage polkit issues
Phase 1 Just supports Arch
Assuming this works will add support for the other distros
Current issue seems to be affect Arch the most
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
new file: config/hypr/scripts/Polkit-Diag.sh
* Removed bad pkg name
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/hypr/scripts/Polkit-Diag.sh
* Fixing diag script to check xfce-polkit from AUR
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/hypr/scripts/Polkit-Diag.sh
* Added confirmation / status for --install-override
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/hypr/scripts/Polkit-Diag.sh
* Fixing polkit (again) changed order so hyprtoolkit 1st
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/hypr/scripts/Polkit.sh
* Fixed Wallust-Chroma-Edge.css had \tcolor
* Fixed \tcolor changed to spaces + color
Fixes waybar crashing
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/waybar/style/Extra-Modern-Combined-Transparent.css
modified: config/waybar/style/Extra-Modern-Combined.css
* Added Fedora to the Polkit-Diag script
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/hypr/scripts/Polkit-Diag.sh
* Added debian/ubuntu to Polkit-Diag
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/hypr/scripts/Polkit-Diag.sh
* Fixed pkg name and made lxqt-polkit optional
If installed it brings in many packages to support it
On branch development
Your branch is ahead of 'origin/development' by 1 commit.
(use "git push" to publish your local commits)
Changes to be committed:
modified: config/hypr/scripts/Polkit-Diag.sh
* Added check for kde-polkit & conflicting kits
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/hypr/scripts/Polkit-Diag.sh
* Added icon for vswaybar-studio
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/waybar/ModulesWorkspaces
* waybar: Add icon for hyprland polkit
* Updated min version supported msg to 0.54.x
* waybar: timeshift icon for waybar
* waybar: btrfs-assistant icon
* OverViewToggle.sh was check for quickshell not qs
- Found by `@TeaJhay`
- Changed script to look for `qs` not `quickshell`
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: CHANGELOG.md
* Fixed overviewtoggle.sh
* Added window rule and module for mousam weather app
It's commented out in the waybar/ModulesCustom file
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: hypr/configs/WindowRules-config-v3.conf
modified: hypr/configs/WindowRules.conf
modified: waybar/ModulesCustom
* Disable VFR, not supported post v0.54.3
* Updated whiptail to dark colors for readability
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: copy.sh
modified: scripts/copy_menu.sh
* Fixed highlight on OK/CANCEL buttons
* Disable dwindle psuedotile not supported v0.55+
* Added fluxer icon to ModulesWorkspaces
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: config/waybar/ModulesWorkspaces
* Removed psuedotile and vfr - not support 0.55+
* Upd CHANGELOG remove LUA-files dir moved to new branch
On branch development
Your branch is up to date with 'origin/development'.
Changes to be committed:
modified: CHANGELOG.md
deleted: LUA-files/hyprland.lua
---------
Co-authored-by: Don Williams <don.e.williamw@gmail.com>
Diffstat (limited to 'docs/HOWTO-fix-ventoy-GUI.md')
| -rw-r--r-- | docs/HOWTO-fix-ventoy-GUI.md | 119 |
1 files changed, 119 insertions, 0 deletions
diff --git a/docs/HOWTO-fix-ventoy-GUI.md b/docs/HOWTO-fix-ventoy-GUI.md new file mode 100644 index 00000000..01441f30 --- /dev/null +++ b/docs/HOWTO-fix-ventoy-GUI.md @@ -0,0 +1,119 @@ +# How to Fix Ventoy GUI on Wayland/Hyprland (with Passwordless Sudo/Polkit) + +If you are using Wayland (such as Hyprland, Sway, or Wayfire) and have passwordless root privileges (e.g., your user is in the `wheel` group with NOPASSWD configured in sudo/polkit), you might encounter an issue where the Ventoy GUI app crashes silently or returns to the command line immediately when launched. + +## The Problem + +When `pkexec` elevates your privileges to root, it aggressively strips out environment variables for security reasons. On X11 this is sometimes fine, but on Wayland, GUI applications require specific environment variables to know how to connect to the display server. + +Because `pkexec` drops variables like `WAYLAND_DISPLAY` and `XDG_RUNTIME_DIR`, the Ventoy GUI (`ventoygui`) starts as root, cannot find a display server, and crashes immediately. + +## The Solution + +To fix this, we need to explicitly pass the necessary display variables back into the `pkexec` environment when launching Ventoy. + +There are two main ways you launch apps: from a GUI app launcher (like Rofi, Wofi, or your desktop environment's menu) and from the command line (Terminal). Here are the fixes for both. + +### Part 1: Fix App Launchers (Rofi, Wofi, Application Menus) + +App launchers use `.desktop` files. We will create a local override for the Ventoy `.desktop` file and point it to a custom wrapper script that preserves the environment variables. + +#### 1. Create a Wrapper Script + +Create a script in your local `bin` directory (create the directory if it doesn't exist): + +```bash path=null start=null +mkdir -p ~/.local/bin +``` + +Create the wrapper script using your favorite text editor (e.g., `nano ~/.local/bin/ventoygui-wayland`) and add the following contents: + +```sh path=null start=null +#!/bin/sh +pkexec env DISPLAY=$DISPLAY WAYLAND_DISPLAY=$WAYLAND_DISPLAY XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR GTK_THEME=Adwaita:dark /usr/bin/ventoygui "$@" +``` + +Make the script executable: + +```bash path=null start=null +chmod +x ~/.local/bin/ventoygui-wayland +``` + +#### 2. Create the Desktop File Override + +Copy the global Ventoy `.desktop` file to your local applications folder: + +```bash path=null start=null +mkdir -p ~/.local/share/applications/ +cp /usr/share/applications/ventoy.desktop ~/.local/share/applications/ventoy.desktop +``` + +Edit the local copy (`~/.local/share/applications/ventoy.desktop`) and change the `Exec=` line to point to the new script. **Make sure to replace `USERNAME` with your actual username:** + +```ini path=null start=null +[Desktop Entry] +Type=Application +Icon=ventoy +Name=Ventoy +Exec=/home/USERNAME/.local/bin/ventoygui-wayland +Terminal=false +Hidden=false +Categories=Utility +Comment=Ventoy2Disk GUI +StartupWMClass=Ventoy2Disk.gtk3 +``` + +Finally, update your desktop database so launchers like Rofi pick up the change immediately: + +```bash path=null start=null +update-desktop-database ~/.local/share/applications +``` + +--- + +### Part 2: Fix the Command Line (Terminal) + +If you type `ventoygui` into your terminal, it will still use the original failing binary. To fix this, we can set up a shell alias or function. + +Add the appropriate snippet below to your shell's configuration file. + +#### For Bash or Zsh + +Add this to the bottom of `~/.bashrc` (for Bash) or `~/.zshrc` (for Zsh): + +```bash path=null start=null +# Fix for VentoyGUI under Wayland/Hyprland +alias ventoygui='pkexec env DISPLAY=$DISPLAY WAYLAND_DISPLAY=$WAYLAND_DISPLAY XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR /usr/bin/ventoygui' +``` + +Apply the changes: + +```bash path=null start=null +# For Bash +source ~/.bashrc + +# For Zsh +source ~/.zshrc +``` + +#### For Fish + +Add this to the bottom of `~/.config/fish/config.fish`: + +```fish path=null start=null +# Fix for VentoyGUI under Wayland/Hyprland +function ventoygui + sh -c 'pkexec env DISPLAY=$DISPLAY WAYLAND_DISPLAY=$WAYLAND_DISPLAY XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR /usr/bin/ventoygui $argv' +end +``` + +Apply the changes: + +```fish path=null start=null +source ~/.config/fish/config.fish +``` + +## Success! + +You should now be able to launch Ventoy GUI from your terminal or your application launcher seamlessly under Wayland. + |
