# **Atlas Desktop - Quick Start Guide** ## Introduction :::success New installer is here ! It's available at https://forge.oblic-parallels.fr/guillm/atlas-install. Check the readme for more informations. ::: Also, as this page only concerns the desktop, I will not dive into the system related packages and will suppose that you alredy have a functionnal base system. ## Keybindings ### Applications - Open terminal: `Mod Enter` - Open launcher: `Mod R` | `Mod Space` ### Windows - Close window: `Mod Q` - Move window to workspace: `Mod Shift *Number*` - Move window to special workspace: `Mod Shift S` - Change focus: `Mod *Arrow key*` - Toggle fullscreen: `Mod F` - Toggle floating: `Mod T` - Toggle dwindle: `Mod H` - Move window: `Mod Left click` - Resize window: `Mod Right click` - Toggle split: ` Mod V` - Minimize (uses special workspace): `Mod N` ### Environment - Switch workspaces: `Mod *Number*` - Special workspace: `Mod + S` - Toggle sidebar: `Mod B` - Exit desktop `Mod Shift M` - Lock screen `Mod L`7 - Workspaces overview `Mod Tab` *(disbaled by default)* - Game mode `Mod F11` - Change keyboard layout `Mod Ctrl Spa` ### Terminal - New tab: `Ctrl Shift T` - Close tabs: `Ctrl Shift W` - Cycle tabs: `Ctrl Tab` - Enlarge font: `Ctrl Shift +` - Reduce font: `Ctrl Shift 6` <br/> ## Commands For the moment there are only two scripts provided: - `set-wallpaper` to change the current wallpaper - `set-lockscreen` to change the lockscreen background image ## Additional packages By default the desktop doesn't come with some basic programs like a web browser or a file manager. So this section is meant to suggest you some good programs I use personnally on my desktop: :::info 🛈 I'll only propose open-source software here, simply because I think that there is so much we can do actually with these programs, that it's not necessary to deal with proprietary software. ::: ### Web browser For those who want a simple browser that just works, **Firefox** is pretty good for everyday use, **Librewolf** is not too far but comes with a lot more privacy features enabled by default, the downside being that all websites could not work as well. And for those who may want something more powerful, **Zen browser** is super good. If you prefer to use a chromium-based browser, give a look at **Brave**, **Vivaldi** or even **Chromium** / **Ungoogled Chromium**. ### File manager **Cosmic files** is the one I recommend for this desktop as it is very fast and suits really well with the color scheme thanks to the cosmic theme builder. However you may want to opt for a more powerful alternative, there I recommend **Nautilus** and **Dolphin** depending on your preferences. Also don't hesitate to check command line file managers like **ranger**, **nnn**, **yazi** or even **superfile**. ### Photos viewer Ok for this one I've not found a good enough solution for me yet. Currently I use **qview** to display single images and **digikam** to manage my photos. While qview is excellent as it aims to be (a very simple, fast and lightweight image viewer), I personnally found digikam not very optimal for what I want it to do but don't have a better alternative at this time. If you want to propose one, don't hesitate. ### Code Editor / IDE For most people, I tink the most versatile solution is by far **VSCodium**: it's fast, modern, efficient and comes with tons of useful features and extensions available for almost every possible language out there. But if you want to go deeper and explore the world of keyboard-only editors, the main ones here are **Vim**, and **Emacs**. There is akso **Neovim** which is a more modern version of vim with a giant extensions ecosystem. However, as it can be very time consumming to manage theme yourself, I suggest you using already made configs such as **Nvchad** if you want something more minimalist or **Lazyvim** for something full fletched. Also **Kate** and **Builder** are good options to look into. ### Note taking I've not explored enough this category yet as I do most of my notes on paper or on my Hedgedoc instance but if it's something that interests you, you should consider **Logseq** and **Joplin** (I know there is so much stuff here but these two are the only apps I tried) <br/> ## Configuration Feel free to modify all the configuration files as you want (and as long as you don't break your system, it'd be better). Just note that I provided a way to configure hyprland on the go if needed with the `hyprcfg` command. I strongly recommend you doing all your modifications in `~/.config/hypr/config/custom/user.conf` to not have all your config overriten after an update. I would even recommend that you manage your own dotfiles git repo, it prevents, among other things, breaking or loosing your configuration. ### Plugins Hyprland has a plugin system which can make it even more powerful but it's not yet enabled by default even if Atlas has configuration for Hyprspace. To enable that, it's better to refer to [Hyprland wiki](https://wiki.hyprland.org/Plugins/Using-Plugins/). ### Mods Mods are more an Atlas thing that is a little like presets that modifies aspect and functionnalities of the desktop. For example, the minimalist mod is installed by default, you just have to decomment it in the `hyprland.conf` file. <br/>