nwg_shell | ||
.gitignore | ||
install.sh | ||
LICENSE | ||
nwg-shell.jpg | ||
PKGBUILD | ||
README.md | ||
setup.py |
nwg-shell
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.
Components:
nwg-shell-config (python)
nwg-panel (python)
nwg-drawer (go)
nwg-dock (go)
nwg-menu (go)
nwg-bar (go)
Azote (python)
nwg-displays (python)
nwg-look (go)
nwg-wrapper (python)
gopsuinfo (go)
autotiling (python)
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. ;)
![](https://raw.githubusercontent.com/nwg-piotr/nwg-shell-resources/master/images/nwg-shell/logo.png)
Images used on this page come from:
- https://wallhaven.cc/w/6kxmj6
- https://wallhaven.cc/w/o39669
- https://pixabay.com/illustrations/home-mountains-fantasy-floating-5889366
- https://pixabay.com/vectors/mobile-devices-website-mockup-web-2017978
Credits
This collection of software relies on some great third-party programs and libraries:
- wlsunset by Kenny Levinsen
- SwayNotificationCenter by Eric Reider
- swappy Copyright (c) 2020 Jeremy Attali
- gtk-layer-shell Copyright (c) 2014 Dennis Blommesteijn, Copyright (c) 2020 William Wold
- gotk3 Copyright (c) 2013-2014 Conformal Systems LLC, Copyright (c) 2015-2018 gotk3 contributors
- gotk3-layershell by @dlasky - many thanks for writing this software, and for patience with my requests!
- go-sway Copyright (c) 2019 Joshua Rubin
- go-singleinstance Copyright (c) 2015 Allan Simon
- python-i3ipc Copyright (c) 2015, Tony Crisci
- python-psutil Copyright (c) 2009, Jay Loden, Dave Daeschler, Giampaolo Rodola
- python-geopy by Kostya Esmukov
- brightnessctl Copyright (c) 2016 Mykyta Holuakha
- playerctl by Tony Crisci
- gtklock by Jovan Lanik
- PulseAudio, bluez-utils, python-netifaces, and probably more, which I forgot to mention here. Please forgive me, if so.
sway is an i3-compatible Wayland compositor Copyright (c) 2016-2017 Drew DeVault
Project supported by
Copyright © 2000-2022 JetBrains s.r.o. JetBrains and the JetBrains logo are registered trademarks of JetBrains s.r.o.