Atlas Desktop

A fully automated Archlinux setup for people that care about their computer.

git clone https://forge.oblic-parallels.fr/guillm/atlas-desktop.git
cd atlas-desktop
bash scripts/installer.sh

What's included

Window manager: Hyprland
Status bar: Waybar
Display manager: Ly
Launcher: Rofi
Notifications center: Swaync
Terminal: Foot
Shell: Zsh + Zinit + Powerlevel10k

Requirements

A basic Arch Linux install (cli is enough, no DE required)
A user account with sudo access
git installed (sudo pacman -Sy git)
Internet connection

Setup will take care of configuring AppArmor and Zram or even firewall if you haven't done it yet.

Installation

Disclaimer Some platforms may not yet be supported such as Nvidia graphic cards for which you'll have to install all the drivers yourself. Sadly I don't have any equipment to test that out.

git clone https://forge.oblic-parallels.fr/guillm/atlas-desktop.git
cd atlas-desktop
bash scripts/installer.sh

Then just follow the instructions and you should be good to go ! After the setup finishes you may need to reboot in order to login:

sudo reboot

Note

If you encounter any error or bug, don't hesitate to open an issue on this repo.

Note

~/.dotfiles is the real repo and is what the updater tracks.

Configuration

I suggest you to give a look to the Quick start guide that explains how the system works if you're not used to it. As you will very probably miss some software you're used to. I'll strongly recommend you to check the Additionnal packages section to know about some open source utilities that fit perfectly within the desktop.

Note that the default keyboard layout is QWERTY (us-fr). You can switch with the AZERTY layout by using Mod+Ctrl+Space. That said, the default layout already has french accents if you need them. If you need to modify the layout, go to ~/.config/hypr/config/default/kb_layouts.

Staying up to date

atlas-update

This will:

Fetch origin/main and show new commits
Detect conflicts between upstream changes and local edits, asking you which to keep per file
Pull and re-stow config/
Re-prompt for any new optional groups added upstream

Troubleshooting

Stow reports conflicts on first install

Existing real files that clash with stow links are automatically renamed to <file>.bak.

An AUR package failed to install

The installer reports it and continues. It won't be saved to state, so atlas-update will retry it next run.

atlas-update says "already up to date" but a package is missing

Delete its state file to force a re-sync:

rm ~/.atlas-dotfiles/.state/packages/mygroup.pkgs
atlas-update

Waybar doesn't reload after switching layout

Reload desktop using Mod+Shift+R or run the following command:

pkill waybar && waybar &

Future improvements

Waybar switch script
A defaults system allowing you to easily choose your default programs
Nvidia cards handling

3.2 KiB Raw Blame History