Home

Arch Linux

New: Arch Linux iso with nwg-shell included. You may set up Arch Linux with nwg-shell from scratch by installing from the nwg-iso. Or just do everything the old way, by following the steps below.

NOTE: this guide does not cover all the Arch Linux installation and post-installation steps. That's why we have the Arch Wiki.

Install Arch Linux

1. Download Arch Linux ISO, boot from it.
2. Run guided installation with archinstall.
3. Select profile -> Minimal.
4. Select audio -> pipewire or pulseaudio.
5. Additional packages -> install wget.
6. Configure network -> Use NetworkManager.
7. Reboot & and login as the user you created.
8. Run the installer script. It will perform further installation steps for you. It will also ask whether to install Hyprland.

wget https://raw.github.com/nwg-piotr/nwg-shell/main/install/arch.sh && chmod u+x arch.sh && ./arch.sh && rm arch.sh

9. Reboot. Type sway (or Hyprland, if you installed Hyprland support) at the command prompt. You should see the nwg-shell settings window now:

10. Check the settings, e.g. your location, keyboard layout, applications. Don't forget to press the "Apply" button, or your text editor, file manager and web browser key bindings won't work.

NOTE: To speed up updates, you may want to install go and python-wheel (build dependencies) on your system.

NOTE: You may use whatever AUR helper you like, but the Arch update tray notifier relies on baph by Nate Maia. Baph is cool, anyway.

Fedora

Installation steps & script by @kuba3351.

Nwg-shell in Fedora is fully packaged in the Copr repository: https://copr.fedorainfracloud.org/coprs/tofik/nwg-shell/

Copr is not official repository, it is similar to AUR in Arch Linux. So, before installing nwg-shell in Fedora, the Copr repo must be enabled in the system. Then, the nwg-shell package should be installed, and then, the nwg-shell-installer -a should be executed to install necesary configuration files. We provide an automated instalation scripts that will do everything automatically for you.

Fedora will soon introduce an Sway Spin: https://fedoraproject.org/wiki/Changes/Fedora_Sway_Spin.

So, it is recommend to install the Sway Spin if you plan to install nwg-shell. But installing Sway and nwg-shell on another Fedora Spin should also work, but was not tested.

Fedora Sway Spin is not yet released but install images of Rawhide (development version of Fedora 38) are available, and install scripts was tested on it.

• Live ISO images (select Sway version): https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Spins/x86_64/iso
• Fedora Sericea (Sway Spin based on ostree): https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Sericea/x86_64/iso/

Install on Fedora

1. Boot Live installer linked above
2. Press Win+d or Win+Enter and type liveinst
3. Follow on screen instructions to install the system
4. After installation do a reboot
5. After first login, execute the installer script and follow instructions to select default apps

wget https://raw.github.com/nwg-piotr/nwg-shell/main/install/fedora.sh && chmod u+x fedora.sh && ./fedora.sh && rm fedora.sh

6. Reboot the system

Install on Fedora Sericea (ostree variant)

1. Boot the installer linked above
2. Follow on screen instructions to install the system
3. After installation do a reboot
4. After first login, execute the installer script and follow instructions to select default apps

wget https://raw.github.com/nwg-piotr/nwg-shell/main/install/fedora-ostree.sh && chmod u+x fedora-ostree.sh && ./fedora-ostree.sh && rm fedora-ostree.sh

5. Reboot the system

The Saigoneer-Sericea-NWG:

The Saigoneer-Sericea-NWG docker image is my personal take on Sericea (immutable Fedora Sway), where I have added some cli tools (i.e fastfetch, htop, mc etc), some applications (nemo, duf & exa) and where I have pruned the original base image. Most importantly it includes the great NWG-shell!

Installation

To rebase an existing Silverblue/Kinoite/Sericea installation to the latest build:

• First rebase to the unsigned image, to get the proper signing keys and policies installed:

  sudo rpm-ostree rebase ostree-unverified-registry:ghcr.io/thesaigoneer-sericea/thesaigoneer-sericea:latest
  

• Reboot to complete the rebase:

  systemctl reboot
  

• Press Ctrl+Alt+F3 in the SDDM login screen to enter a command shell and login with your username and password.

• Then rebase to the signed image, like this:

  sudo rpm-ostree rebase ostree-image-signed:docker://ghcr.io/thesaigoneer-sericea/thesaigoneer-sericea:latest
  

• Reboot again to complete the installation

  systemctl reboot
  

After that reboot again press Ctrl+Alt+F3 in the SDDM login screen to enter a command shell and login with your username and password. In there type:

nwg-shell-installer -a

• Press Enter, complete installation and type sway to enter your nwg session.

The next you boot up and enter your credentials into SDDM you will be taken to the nwg-shell environment straight away.

More information at https://github.com/thesaigoneer-sericea/thesaigoneer-sericea/blob/live/README.md

Slackware

Slackware 15.0 (x86, x86_64)

1. Download the nwg-shell scripts manually or use a TUI tool such as sbopkg or sboui to auto-install deps from SBo.
2. After building and install, ensure your user account is added to the video group, and run xdg-user-dirs-update.
3. As root run /usr/sbin/pipewire-enable.sh.
4. Afterwards, run the nwg-installer script to setup your environment, nwg-shell-installer -a.
5. Execute sway to load nwg-shell.

Slackware64-current (x86_64-development)

1. Download & install slackpkg+ to add custom repositories to the distro.
2. Edit /etc/slackpkg/slackpkgplus.conf adding this information to the configuration file: MIRRORPLUS['nwg-shell']=https://slackware.lngn.net/pub/x86_64/slackware64-current/nwg-shell/ also ensure you add nwg-shell to the PKGS_PRIORITY and REPOPLUS fields.
3. Run slackpkg update && slackpkg install nwg-shell as root. This will install binary packages (you will not have to build anything).
4. Then follow Steps 2-5 for Slackware 15.0 above.

Work in progress by mac-a-r0ni.

Adding Hyprland support to your pre-0.5.x installation

As the updater in its current state does not support optional updates, you need to do it manually.

1. Install hyprland and wlr-randr;
2. Run nwg-shell-installer -r -hypr to add missing Hyprland presets.

Installing / restoring default presets

From scratch

Run nwg-shell-installer -a [-hypr] to overwrite all default presets w/ default files (use -hypr argument to include Hyprland presets).

Selectively

Remove preset files you want to restore manually, then run nwg-shell-installer -r [-hypr].