Skip to Content
MvpDots

Installation

One command installs everything, and backs up every file it replaces first.

Before you start

You needCheck with
An Arch-based distro (Arch, EndeavourOS, CachyOS, Manjaro) — others: see belowcat /etc/os-release
gitgit --version
A user with sudosudo -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

Terminal
git clone https://github.com/subhadeeproy3902/dotfiles.git
cd dotfiles

Preview what it will do (optional)

Terminal
./install.sh --dry-run

Every step is printed, nothing is changed.

Run it

Terminal
./install.sh

It 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

The result

Terminal
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 ✓
==> Done

Options

OptionEffect
--yesaccept the defaults (packages, configs, wallpapers, plugins; no SDDM/GRUB)
--dry-runprint every step, change nothing
--doctoronly check which programs are missing
--no-packagesskip the package step
--no-plugins / --no-wallpapersskip those steps
--sddm / --grubalso 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 appWorks?Settings
VMware Workstation Pro (free for personal use)bestDisplay → Accelerate 3D graphics on, 2+ GB graphics memory
VirtualBox 7yesDisplay → Graphics Controller VMSVGA, Enable 3D Acceleration on, 128 MB video memory
Hyper-Vnono 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):

~/.config/hypr/user.lua
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).

On this page