nwg-shell project
The nwg-shell project aims to create a consistent, GTK3-based user interface for the sway Wayland Compositor. In order to give the user the greatest possible choice, some interface elements provide several alternative solutions. The shell contains 4 predefined desktop styles, which can be freely modified by the user.
Starting from the 0.5.x version, nwg-shell also offers support for the Hyprland Wayland compositor. All the component apps are Hyprland-ready, and the shell comes with 4 hyprland-* desktop styles. Hyprland support is an addition to the shell, not a standalone feature.
The project is intended for users of all skill levels. Beginners will find four ready-made and immediately working desktop styles to choose from. Advanced users will get a set of tools to build their own GTK-based user interface.
I strongly discourage manual editing of .dotfiles. There’s a GUI for that. The configuration files are in json format, which does not forgive mistakes.
The user interface mostly consists of dedicated software, but also uses several great third party products, that perfectly fit. Many thanks to their authors for favorable attitude towards feature requests.
The default (preinstalled) terminal emulator is foot by Daniel Eklöf. This does not mean that I consider other terminals worse, but that I had to choose one. The remaining elements of the desktop environment, such as the text editor, file manager, web browser, and so on, are left to the user’s choice. The author’s subjective recommendation might be mousepad, Thunar, and Chromium / Chrome, but it doesn’t really make much difference.
On the backend side there’s a lot of third party Free Open Source Software. I’ll try to list all the applications and libraries in Credits.
If you want to share an idea, find a solution to a problem or discuss the project in general, please join Discussion.
TOC
- What’s inside
- Desktop styles
- Login manager: nwg-hello
- Panel: nwg-panel
- Launcher: nwg-drawer
- Dock: nwg-dock
- Alternative launcher: nwg-menu
- Notification center: swaync
- Screen locker: gtklock
- Wallpaper management: Azote
- Look and feel: nwg-look
- Display management: nwg-displays
- Shell settings: nwg-shell-config
- Documentation: nwg-readme-browser
- Utilities and scripts
- Installation
- nwg-shell on Arch derivatives
- Recent updates
- Contributing
- Credits
- Contact
Credits
This collection of software depends on numerous third-party programs and libraries, that have not been mentioned above:
- wlsunset by Kenny Levinsen
- gtk-layer-shell by Dennis Blommesteijn & William Wold
- gotk3 by Conformal Systems LLC
- gotk3-layershell by @dlasky (Dan, thanks again!)
- go-sway by Joshua Rubin
- go-singleinstance by 2015 Allan Simon
- python-i3ipc by Tony Crisci
- python-psutil by Jay Loden, Dave Daeschler & Giampaolo Rodola
- python-geopy by Kostya Esmukov
- python-dasbus by Red Hat Installer Engineering Team
- python-netifaces by Alastair Houghton
- python-requests by Python Software Foundation
- brightnessctl by Mykyta Holuakha
- ddcutil by Sanford Rockowitz
- playerctl by Tony Crisci
- wlr-randr by Simon Ser
- PulseAudio, bluez-utils, and probably more, which I forgot to mention here. Please forgive me, if so.
GTK and related libraries are a free and open-source cross-platform widget toolkit for creating graphical user interfaces, developed by The GNOME Project.
sway is an i3-compatible Wayland compositor Copyright (c) 2016-2017 Drew DeVault.
The author of the project logo is edskeye.
The artwork used on this site is licensed under the terms of the Creative Commons Zero v1.0 Universal license, and has been contributed by:
Contact
- nwg.piotr(at)gmail.com
- forum.archlabslinux.com/u/nwg
- @nwgpiotr@fosstodon.org
- reddit.com/user/nwg-piotr
This project is supported by
Copyright © 2000-2022 JetBrains s.r.o. JetBrains and the JetBrains logo are registered trademarks of JetBrains s.r.o.