https://github.com/nwg-piotr/nwgocc
nwg Control Center - Go version
https://github.com/nwg-piotr/nwgocc
go golang gtk3 preferences
Last synced: about 1 year ago
JSON representation
nwg Control Center - Go version
- Host: GitHub
- URL: https://github.com/nwg-piotr/nwgocc
- Owner: nwg-piotr
- License: mit
- Created: 2020-12-12T01:11:40.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-05-26T00:23:13.000Z (about 4 years ago)
- Last Synced: 2025-03-31T09:41:15.683Z (about 1 year ago)
- Topics: go, golang, gtk3, preferences
- Language: Go
- Homepage:
- Size: 10.1 MB
- Stars: 15
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# nwg Control Center (Go version)
nwg Control Center is a highly customisable, GTK-based GUI, intended for use with window managers. It may serve as an
extension to bars / panels, providing built-in and user-defined controls. Default theme may be overridden with custom
css style sheets.
Main window, Nordic-bluish-accent GTK theme, icons Custom light:
[More screenshots](https://scrot.cloud/album/nwgocc.tDg)
This code was primarily written in python and published as [nwgcc](https://github.com/nwg-piotr/nwgcc). As I wanted it
to work a bit faster, and also to learn something new, I translated it into Go, using the
[gotk3](https://github.com/gotk3/gotk3) library. This is my very first more serious code in golang. I'm 100% sure it
may be improved in many ways.
## Dependencies
- go
- gtk3
The above seems to be enough on Arch Linux. On other distributions you may also need `libgtk-3`, `libglib2` and
`libgdk-pixbuf2`. Check the reference on https://github.com/gotk3/gotk3.
### Components
For built-in components to work, you need external commands / dependencies as below. If you don't need one, you may
skip installing related packages (e.g. on a desktop machine, you probably don't need the brightness slider).
- `light`: for Brightness slider
- `alsa`, `alsa-utils`: for Volume slider
- `playerctl`: for mpris media player controller buttons
- `wireless_tools`: for Wi-fi status
- `bluez`, `bluez-utils`: for Bluetooth status
Sample user defined commands use `blueman` and `NetworkManager`.
## Installation
- Install dependencies and your selection of optional dependencies.
- `git clone https://github.com/nwg-piotr/nwgocc.git`
- `cd nwgocc`
- `make get` (This may take a while; provided that no new libraries added, you may skip this step next time.)
- `make build`
- `sudo make install`
## To uninstall
`sudo make uninstall`
## Usage
```text
Usage of nwgocc:
-c string
user's templates: Config file name (default "config.json")
-d Do checks, print results
-p place window at the mouse Pointer position (Xorg only)
-r Restore defaults (preferences, templates and icons)
-s string
custom Styling: css file name (default "style.css")
-v display Version information
```
Click the Preferences button to adjust the window to your needs. For your own custom styling, either modify the
`~/.config/nwgocc/style.css` file, or place your own `whatever.css` in the same folder, and use the `-s` flag.
You may also make a copy of `~/.config/nwgocc/config.json` under another name, for further use with the `-c` flag.
## Credits
- GUI uses the [gotk3](https://github.com/gotk3/gotk3) package, Copyright (c) 2013-2014 Conformal Systems LLC,
Copyright (c) 2015-2018 gotk3 contributors, released under the terms of the
[ISC License](https://github.com/gotk3/gotk3/blob/master/LICENSE).
- Volume control relies on the [volume-go](https://github.com/itchyny/volume-go) package, Copyright (c) 2017-2020 itchyny,
released under the terms of the [MIT License](https://github.com/itchyny/volume-go/blob/master/LICENSE).
- Handling multiple instances relies on the [go-singleinstance](https://github.com/allan-simon/go-singleinstance)
library, Copyright (c) 2015 Allan Simon, released under the terms of the
[MIT License](https://github.com/allan-simon/go-singleinstance/blob/master/LICENSE).
- Most of custom icons come from my favorite [Papirus icon theme](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme),
released under the terms of the
[GNU General Public License, version 3](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme/blob/master/LICENSE).