https://github.com/nwg-piotr/nwg-shell

Installer & meta-package for the nwg-shell project: a GTK3-based shell for sway and Hyprland Wayland compositors
https://github.com/nwg-piotr/nwg-shell

bar gtk gtk3 launcher menu panel sway wlroots

Last synced: 14 days ago
JSON representation

Installer & meta-package for the nwg-shell project: a GTK3-based shell for sway and Hyprland Wayland compositors

• Host: GitHub
• URL: https://github.com/nwg-piotr/nwg-shell
• Owner: nwg-piotr
• License: other
• Created: 2021-05-09T01:31:05.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-10-04T09:16:28.000Z (about 1 month ago)
• Last Synced: 2024-10-25T09:09:28.485Z (20 days ago)
• Topics: bar, gtk, gtk3, launcher, menu, panel, sway, wlroots
• Language: CSS
• Homepage:
• Size: 68.9 MB
• Stars: 851
• Watchers: 7
• Forks: 14
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        


nwg-shell



**nwg-shell** is a GTK3-based shell for [sway](https://github.com/swaywm/sway) and 

[Hyprland](https://github.com/hyprwm/Hyprland) Wayland compositors. The project provides a common configuration tool 

(**nwg-shell-config**) that allows you to configure the system in a graphical UI, and a range of components such as 

**nwg-panel** (system panel), **nwg-drawer** (application launcher), **nwg-dock** (system dock) or **nwg-menu** 

(XDG-style menu). It also includes several native tools as 

**nwg-look** (look and feel GTK settings editor), **nwg-displays** (display configuration tool), **Azote** (wallpaper 

manager), **nwg-clipman** (clipboard history manager), **nwg-icon-picker** (icon browser with textual search), 

**nwg-readme-browser** (documentation viewer) and **nwg-hello** (login manager). Scripts and utilities such as 

**autotiling** (script for sway to automatically switch the horizontal / vertical window split orientation) and 

**gospuinfo** (a command to display system usage info) are used in the background. The shell also utilizes third party 

software as **swaync** (notification center), **gtklock** / **swaylock** (screen lockers) and more. The `nwg-shell` 

package itself acts as a metapackage and installer of default configuration files.

Learn more about nwg-shell on the [**project website**](https://nwg-piotr.github.io/nwg-shell).



## Installation

For installation instructions, see the [Wiki page](https://github.com/nwg-piotr/nwg-shell/wiki).

[![Packaging status](https://repology.org/badge/vertical-allrepos/nwg-shell.svg)](https://repology.org/project/nwg-shell/versions)

## Contributing

Please read the [general contributing rules for the nwg-shell project](https://nwg-piotr.github.io/nwg-shell/contribution).

## License

The shell components are provided under the terms of the [MIT License](https://github.com/nwg-piotr/nwg-shell/blob/main/LICENSE),

unless otherwise specified for a certain component.

## Contact

- Use [Discussions](https://github.com/nwg-piotr/nwg-shell/discussions) to see CHANGELOG and announcements, share ideas, ask for support.

- Use [this invitation](https://matrix.to/#/#nwg-shell:matrix.org) to join the live chat on Matrix.

## Project supported by



Copyright © 2000-2024 JetBrains s.r.o. JetBrains and the JetBrains logo are registered trademarks of JetBrains s.r.o.