Installer & meta-package for the nwg-shell project: a GTK3-based shell for sway and Hyprland Wayland compositors
Go to file
2022-07-20 13:06:53 +02:00
nwg_shell update idle config -> 0.2.3 2022-07-10 23:50:11 +02:00
.gitignore remove folders moved to another repo 2022-02-04 12:48:15 +01:00
install.sh install wallpaper 2022-05-07 01:51:17 +02:00
LICENSE update LICENSE 2022-02-07 01:05:15 +01:00
nwg-shell.jpg add missing scripts & wallpaper 2022-02-07 04:01:57 +01:00
PKGBUILD update dependencies 2022-02-07 23:53:13 +01:00
README.md Update README.md 2022-07-20 13:06:53 +02:00
setup.py update idle config -> 0.2.3 2022-07-10 23:50:11 +02:00

nwg-shell

Packaging status

Learn more about nwg-shell on the project website

The installer provided in this repository pulls all the necessary dependencies, and preconfigures 4 desktop styles for you to choose from. Each of them you can modify freely from the nwg-shell-config GUI. Or you may choose the 'Custom' preset to experiment with.

Installation

The hard way

How to set up nwg-shell on minimal Arch Linux install in several simple steps - Wiki

The easy way

Install ArchLabs Linux with preconfigured sway session.

nwg-shell components:

nwg-shell-config (python)

Packaging status

nwg-panel (python)

Packaging status

nwg-drawer (go)

Packaging status

nwg-dock (go)

Packaging status

nwg-menu (go)

Packaging status

nwg-bar (go)

Packaging status

Azote (python)

Packaging status

nwg-displays (python)

Packaging status

nwg-look (go)

Packaging status

nwg-wrapper (python)

Packaging status

gopsuinfo (go)

Packaging status

autotiling (python)

Packaging status

Support for other WMs

This project is primarily aimed at sway. Some parts may work on other wlroots-based compositors. Some may even work on X11, but it's not the primary objective. Feel free to submit addons / improvements, but keep in mind that all the stuff must work on sway, and may or may not work elsewhere.

Pull requests adding support for non-sway stuff

are welcome.

Feature requests like "add <place_your_wm_here> support"

go to /dev/null.

Contributions

If you like the idea of the GTK shell for sway, feel free to submit your improvements, new modules, plugins or standalone programs. Preferred languages are python and Go.

Important: before you open a PR containing major changes to already existing programs, please (PLEASE!) open an issue to discuss what you're going to do.

Feedback

Bug reports and ideas are more than welcome. Please remember, however, that at this stage, most part of the shell is being developed by a single hobbyist, who uses Arch Linux. Some issues specific to other environment, e.g. Debian, FreeBSD, are out of my range and need some Community commitment.

Resources

The project logo has been created by edskeye. You'll find the basic svg file in the resources repository. If you like the logo, you may also like nwg-shell wallpapers. The uglier ones were designed by me, and the prettier ones by @badkarma. ;)

Project supported by

JetBrains Logo (Main) logo.

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