nwg-iso

This repository is a part of the nwg-shell project. Please check the project website.

The nwg-iso project provides an ISO image built with archiso, with additions to ensure a simple way to install Arch Linux, sway & Hyprland Wayland compositors, and the nwg-shell toolbox.

The live environment comes with live sway & Hyprland sessions, so that you can test compositors and the shell before installation. It also contains the installer command, which is a simplified version of the interactive installation with the archinstall script. Some must have stuff has already been pre-selected.

Installation

Download the nwg-live ISO.
Create USB flash installation medium.
Boot from the flash drive, enjoy the live sway and Hyprland environment. User: nwg Password: nwg
If you decide to install, use the "Installer" item in the top panel menu. The script will run in the terminal emulator.

Post-installation

Find the 'Shell settings' item in the top panel menu. Review your settings here.

Click the (i) icon in the top panel to see key bindings help. Open the Controls menu in the top panel to see more configuration tools.

AUR helpers

As for August 21st, 2024, we no longer use any pre-installed AUR helper. All the former AUR stuff made it to the Arch [Extra] repository. Just installed system will use pacman/checkupdates in the tray update notification applet. If you want it to look for AUR updates, install one of supported AUR helpers, and those are baph and yay.

Preinstalled stuff

azote
engrampa
fastfetch
foot
gnome-themes-extra
gopsuinfo
grim
gtklock
gtklock-playerctl-module
gtklock-powerbar-module
gtklock-userinfo-module
hyprland
imagemagick
iwd
jq
libappindicator-gtk3
networkmanager
network-manager-applet
nano
nwg-clipman
nwg-displays
nwg-dock
nwg-dock-hyprland
nwg-drawer
nwg-icon-browser
nwg-hello
nwg-look
nwg-menu
nwg-panel
nwg-readme-browser
nwg-shell-config
nwg-shell-wallpapers
otf-font-awesome
papirus-icon-theme
playerctl
polkit-gnome
python
slurp
swappy
sway
swaybg
swayidle
swayimg
swaylock
swaync
ttf-dejavu
udisks2
wl-clipboard
wlsunset
xdg-desktop-portal-hyprland
xdg-user-dirs
xorg-xwayland
web browser, text editor, file manager chosen during installation
optionally: extra GTK themes, icon themes

Aliases

cls for clear

sway session on Nvidia GPU

To be able to run sway on Nvidia GPU, you need to use the --unsupported-gpu flag. Since the 2023.11.09 ISO version the installer should do it for you, but I have no Nvidia in range and haven't yet tested it. So, just in case - the sway.desktop file should look as below:

# nano /usr/share/wayland-sessions/sway.desktop

[Desktop Entry]
Name=Sway
Comment=An i3-compatible Wayland compositor
Exec=sway --unsupported-gpu
Type=Application

Testing on a virtual machine

is neither recommended nor supported. Running sway and Hyprland on a VM is possible, but frustrating (well, Hyprland freezes for me very often). If you do need to do so, remember to enable 3D acceleration and EFI.

Contact

See my GitHub profile for contact info.

tuxslack/nwg-iso

ErrorLooks like something went wrong!

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages