A fully featured desktop environment based on the dynamic tiling wayland compositor Hyprland. This dotfiles repository is based on the Noctalia Shell and supports Hyprland config customization with the ML4W Settings App.
This dotfiles repository currently supports Arch Linux and Arch-based distributions like CachyOS. A minimal installation of the selected distribution is needed to get started. Make sure your system is up to date before running the installation script.
Run the following command and follow the instructions:
bash <(curl -s https://raw.githubusercontent.com/JTreske/singularity-dotfiles/refs/heads/main/install.sh)Choose the stable release for the latest tagged version or the rolling release to install the current state of the main branch
The script uses Singularity Dotfiles Manager to perform the installation.
This allows for multiple dotfile profiles to be installed and updated.
After installation of the dotfiles you have to reboot your system.
You should boot into SDDM login screen.
If not enable the SDDM service, most likely by running the following command:
sudo systemctl enable --now sddmThe Singularity Dotfiles Repository comes with a curated list of apps.
You can select the apps you need from this list.
The installer will ask you if you want to install apps from this list or not.
If you wish to come back to this list later run one of the following commands:
# works with any dotfiles repository using the singularity-dotfiles-manager
singularity-dotfiles-manager apps
# or
singularity --appsYou can just click on the updates icon in the top bar to start the update script.
If you wish to manually update:
- Make sure the system packages are up-to-date
- Run the installer again:
bash <(curl -s https://raw.githubusercontent.com/JTreske/singularity-dotfiles/refs/heads/main/install.sh) --install
Important
Singularity Dotfiles are highly customizable but make sure that you select your customized files for restore when updating the dotfiles.
This dotfiles repository supports the use of the ML4W Settings App for customization of the Hyprland configuration. You can configure Hyprland in small parts, like the keyboard layout, keybindings, or workspaces.
Run the settings app in the terminal with this command:
settingsor open the Quickshell GUI app with this command:
settings-guiYou may also manually edit the ~/.config/hypr/conf/custom.conf (not supported by the settings app).
This can be useful if you only want to add a single keybinding or similar to the default configs.
Noctalia Shell provides a settings app for theming, installing plugins, and customization of the bar, the launcher, and more. Find the settings app by clicking on the right most icon in the default top bar.
If you want to customize ZSH it would be best to only change the provided .zshenv file and set ZDOTDIR to another directory.
This way you only have to select .zshenv for restore.
Run the following command to enable the Singularity SDDM theme (based on SDDM silent) or set it in the initial install process:
singularity --themeIf you have a multi monitor setup you can turn off additional monitors by adding the following to /usr/share/sddm/scripts/Xsetup:
xrandr --output "<display-name>" --offFind out the display names with the command xrandr (e.g., DP-2).
You might also want to change the content of /usr/share/icons/default/index.theme to the following to have the same cursor as everywhere else:
[Icon Theme]
Inherits=Bibata-Modern-IceDistributed under the GPLv3 License. See LICENSE for more information.