@@ -74,7 +74,7 @@ If you love that vibe — welcome home.
7474- 📦 ** Smart uninstall** — Tracks packages installed by draphyOS for clean removal (full reset to pre-install state)
7575- 🔋 ** Battery health** — Configurable charge limit with auto-detection for 10+ laptop vendors
7676- 🔀 ** Version migrations** — Seamless upgrades between draphyOS versions
77- - 🖥️ ** VM detection ** — Automatic picom optimizations for virtual machines
77+ - 🖥️ ** VM mode ** — Optional picom optimizations for virtual machines ( ` --vm ` flag)
7878
7979### Development Tools
8080- 🐳 ** Docker** — Container runtime with rootless setup (user added to docker group)
@@ -126,16 +126,18 @@ draphyOS also works on other Fedora editions. The installer will set up i3 along
126126
127127> ** ⚠️ Make sure you have [ Fedora installed] ( #-prerequisites ) before proceeding.**
128128
129- ### One-Command Install
129+ ### Install
130130
131131``` bash
132- curl -fsSL https://raw.githubusercontent. com/draphy/draphyOS/latest/ install.sh | bash
132+ git clone https://github. com/draphy/draphyOS ~ /.draphyOS && ~ /.draphyOS/ install.sh
133133```
134134
135- Or clone and run:
135+ ### VM Install
136+
137+ If installing in a virtual machine, use the ` --vm ` flag:
136138
137139``` bash
138- git clone https://github.com/draphy/draphyOS ~ /.draphyOS && ~ /.draphyOS/install.sh
140+ git clone https://github.com/draphy/draphyOS ~ /.draphyOS && ~ /.draphyOS/install.sh --vm
139141```
140142
141143### Post-Installation
@@ -169,6 +171,8 @@ update-draphyOS # Interactive menu
169171update-draphyOS -u # Quick system update
170172update-draphyOS -d # Update draphyOS configs
171173update-draphyOS -v # Fedora version upgrade
174+ update-draphyOS --vm # Enable VM mode
175+ update-draphyOS --no-vm # Disable VM mode
172176```
173177
174178### Features
@@ -920,10 +924,19 @@ draphyOS has separate WiFi and Ethernet modules that auto-hide when disconnected
920924<details >
921925<summary ><strong >Running in a VM? Display not refreshing?</strong ></summary >
922926
923- ** Note: ** The installer auto-detects VM environments (VirtualBox, VMware, QEMU/KVM, Hyper-V) and applies these fixes automatically.
927+ Picom's ` glx ` backend doesn't work well in virtual machines. Use VM mode:
924928
925- If not auto-detected or you need to apply manually, picom's ` glx ` backend doesn't work well in virtual machines. Fix:
929+ ** Option 1: Use the ` --vm ` flag during install:**
930+ ``` bash
931+ ~ /.draphyOS/install.sh --vm
932+ ```
926933
934+ ** Option 2: Enable VM mode after installation:**
935+ ``` bash
936+ update-draphyOS --vm
937+ ```
938+
939+ ** Option 3: Manual fix:**
9279401 . Edit ` ~/.config/picom/picom.conf ` :
928941 ``` ini
929942 backend = " xrender" ;
@@ -933,6 +946,11 @@ If not auto-detected or you need to apply manually, picom's `glx` backend doesn'
933946 ```
9349472 . Restart picom: ` pkill picom && picom -b `
935948
949+ To disable VM mode and restore GLX backend:
950+ ``` bash
951+ update-draphyOS --no-vm
952+ ```
953+
936954> ** Note:** Rounded corners and blur aren't supported with ` xrender ` , but opacity and shadows still work.
937955
938956</details >
0 commit comments