Atlas Desktop

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

curl -fsSL https://forge.oblic-parallels.fr/guillm/atlas-desktop/raw/branch/main/scripts/install.sh | bash

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.

curl -fsSL https://forge.oblic-parallels.fr/guillm/atlas-desktop/raw/branch/main/scripts/install.sh | bash

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: After installation the original clone is no longer needed. ~/.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