Installation
One command installs everything, and backs up every file it replaces first.
Before you start
| You need | Check with |
|---|---|
| An Arch-based distro (Arch, EndeavourOS, CachyOS, Manjaro) — others: see below | cat /etc/os-release |
git | git --version |
A user with sudo | sudo -v |
Take a snapshot first
If your system has snapshots (snapper, Timeshift), take one now. The installer backs up your configs, but a
snapshot also covers packages: sudo snapper -c root create --description "before MvpDots".
Install
Get the files
git clone https://github.com/subhadeeproy3902/dotfiles.git
cd dotfilesPreview what it will do (optional)
./install.sh --dry-runEvery step is printed, nothing is changed.
Run it
./install.shIt asks before anything optional and before anything that needs sudo. To accept every default:
./install.sh --yes.
Log in
Log out and choose Hyprland (uwsm-managed) on the login screen. Continue with Your first login.
What happens, step by step
On the Arch family: about 70 packages with pacman, plus two from the AUR (ttf-geist,
bibata-cursor-theme-bin). If you have no AUR helper, it offers to build yay.
sudo pacman -S --needed --noconfirm $(cat packages/arch.txt)
yay -S --needed --noconfirm ttf-geist bibata-cursor-theme-binEvery file or folder it is about to replace is moved, not deleted, into
~/.local/state/dotfiles/backup-<date>/, and every file it installs is listed in installed.txt. That list is
what uninstall.sh uses to put things back.
put() { # put <source> <target>: back up the target if it is not ours, then copy
local src="$1" dst="$2"
if [ -e "$dst" ] || [ -L "$dst" ]; then
if [ -n "$PREV" ] && grep -qxF "$dst" "$PREV"; then run rm -rf "$dst"
else
run mkdir -p "$BACKUP/$(dirname "${dst#$HOME/}")"
run mv "$dst" "$BACKUP/${dst#$HOME/}"
fi
fi
run mkdir -p "$(dirname "$dst")"
run cp -r "$src" "$dst"
[ "$DRY" = 1 ] || echo "$dst" >> "$NEW"
}Shared folders (~/.config/systemd/user, ~/.config/autostart) are handled file by file, so your own services stay.
config/ → ~/.config, local/bin/ → ~/.local/bin. See the file map.
Ten wallpapers are downloaded into ~/Pictures/Wallpapers, and matugen builds the first colour theme. At your
first login, setwall shows that wallpaper.
quickshell, awww-daemon, cliphist, hypridle and hyprpolkitagent are enabled as user services: they
start with the graphical session and restart if they crash.
Built for your exact Hyprland version, without sudo. See Liquid Glass & plugins.
The SDDM theme and the Liquid Glass GRUB theme. Your display manager is not switched, and /etc/default/grub
is backed up before anything changes.
The result
Desktop installer — EndeavourOS
==> Packages
==> Checking programs
✓ all required programs found
==> Configs
Configs copied. Your previous files are in ~/.local/state/dotfiles/backup-20261121-1135
==> Wallpapers
==> Colour theme from the wallpaper
==> User services
enabled quickshell.service … hyprpolkitagent.service
==> Hyprland plugins (built for your Hyprland version)
:: Building plugins for Hyprland 0.56.2 (efb5099)
:: hyprglass → pinned 7fc3280
:: hyprglass ✓
:: dynamic-cursors ✓
:: hyprfocus ✓
:: hyprbars ✓
==> DoneOptions
| Option | Effect |
|---|---|
--yes | accept the defaults (packages, configs, wallpapers, plugins; no SDDM/GRUB) |
--dry-run | print every step, change nothing |
--doctor | only check which programs are missing |
--no-packages | skip the package step |
--no-plugins / --no-wallpapers | skip those steps |
--sddm / --grub | also install the login screen / boot menu theme |
Other distros
Fully supported. Every package comes from the official repositories except two from the AUR.
Try it in a virtual machine
You can try MvpDots in a VM on Windows or macOS before installing it for real. Hyprland draws everything with the GPU, so the VM needs 3D acceleration:
| VM app | Works? | Settings |
|---|---|---|
| VMware Workstation Pro (free for personal use) | best | Display → Accelerate 3D graphics on, 2+ GB graphics memory |
| VirtualBox 7 | yes | Display → Graphics Controller VMSVGA, Enable 3D Acceleration on, 128 MB video memory |
| Hyper-V | no | no 3D acceleration for Linux guests |
Give the VM at least 2 CPU cores, 4 GB of RAM and 30 GB of disk, install Ubuntu 26.04 LTS, then run the
installer as above. Answer No to the plugins question: Liquid Glass and blur are heavy without a real GPU. Press
Win+Alt+G for Eco look if it still feels slow. If the mouse pointer is invisible, add this to
~/.config/hypr/user.lua and save (Hyprland reloads on its own):
hl.config({ cursor = { no_hardware_cursors = 1 } })The Win key in a VM
Windows keeps some Win shortcuts for itself. In VMware and VirtualBox, click inside the VM first; if Win+Space still goes to Windows, use the VM app's keyboard capture option.
Next to your current desktop
MvpDots is a full desktop, not a theme. It installs as its own session next to GNOME or KDE; you pick one on the
login screen. Undo everything with ./uninstall.sh (see Update and uninstall).