103 lines
3.2 KiB
Markdown
103 lines
3.2 KiB
Markdown
# Atlas Desktop
|
|
|
|
A fully automated Archlinux setup for people that care about their computer.
|
|
|
|
```sh
|
|
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.
|
|
|
|
|
|
```sh
|
|
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:
|
|
```sh
|
|
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](https://hedgedoc.oblic-parallels.fr/s/JSR33pjd_) 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](https://hedgedoc.oblic-parallels.fr/s/JSR33pjd_#Additional-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
|
|
|
|
```sh
|
|
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:
|
|
```bash
|
|
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:
|
|
```bash
|
|
pkill waybar && waybar &
|
|
```
|
|
|
|
|
|
## Future improvements
|
|
|
|
- Waybar switch script
|
|
- A defaults system allowing you to easily choose your default programs
|
|
- Nvidia cards handling
|