Waybar/README.md

93 lines
2.4 KiB
Markdown
Raw Normal View History

2019-02-04 09:32:16 +00:00
# Waybar [![Travis](https://travis-ci.org/Alexays/Waybar.svg?branch=master)](https://travis-ci.org/Alexays/Waybar) [![Licence](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Paypal Donate](https://img.shields.io/badge/Donate-Paypal-2244dd.svg)](https://paypal.me/ARouillard)<br>![Waybar](https://raw.githubusercontent.com/alexays/waybar/master/preview-2.png)
2018-08-08 21:58:43 +00:00
2018-08-10 10:28:54 +00:00
> Highly customizable Wayland bar for Sway and Wlroots based compositors.<br>
> Available in Arch [community](https://www.archlinux.org/packages/community/x86_64/waybar/) or
2019-11-11 10:46:10 +00:00
[AUR](https://aur.archlinux.org/packages/waybar-git/), [openSUSE](https://build.opensuse.org/package/show/X11:Wayland/waybar), and [Alpine Linux](https://pkgs.alpinelinux.org/packages?name=waybar)<br>
2019-06-11 11:55:35 +00:00
> *Waybar [examples](https://github.com/Alexays/Waybar/wiki/Examples)*
2018-08-08 22:06:10 +00:00
2018-08-08 21:58:43 +00:00
**Current features**
2018-11-16 09:06:24 +00:00
- Sway (Workspaces, Binding mode, Focused window name)
2019-04-16 11:42:49 +00:00
- Tray [#21](https://github.com/Alexays/Waybar/issues/21)
2018-08-08 21:58:43 +00:00
- Local time
- Battery
2018-08-10 10:28:54 +00:00
- Network
2020-04-17 07:09:30 +00:00
- Bluetooth
2018-08-09 21:57:11 +00:00
- Pulseaudio
2019-09-25 08:27:51 +00:00
- Disk
2018-08-10 10:28:54 +00:00
- Memory
- Cpu load average
2019-03-13 15:56:13 +00:00
- Temperature
2019-04-16 14:34:37 +00:00
- MPD
2018-08-10 14:29:37 +00:00
- Custom scripts
2019-02-01 20:52:38 +00:00
- Multiple output configuration
- And much more customizations
2018-08-10 10:28:54 +00:00
2018-12-28 23:06:59 +00:00
**Configuration and Styling**
2018-08-08 21:58:43 +00:00
2018-08-10 10:28:54 +00:00
[See the wiki for more details](https://github.com/Alexays/Waybar/wiki).
**How to build**
2018-08-09 12:00:08 +00:00
```bash
2018-08-10 10:28:54 +00:00
$ git clone https://github.com/Alexays/Waybar
2018-11-16 09:07:20 +00:00
$ cd Waybar
2018-08-10 10:28:54 +00:00
$ meson build
$ ninja -C build
$ ./build/waybar
2018-12-28 23:06:59 +00:00
# If you want to install it
$ ninja -C build install
$ waybar
```
**Dependencies**
```
gtkmm3
jsoncpp
libinput
2019-06-11 11:55:35 +00:00
2018-12-28 23:06:59 +00:00
libsigc++
2019-01-25 15:38:38 +00:00
fmt
2018-12-28 23:06:59 +00:00
wayland
wlroots
libgtk-3-dev [gtk-layer-shell]
gobject-introspection [gtk-layer-shell]
libgirepository1.0-dev [gtk-layer-shell]
2018-12-28 23:06:59 +00:00
libpulse [Pulseaudio module]
libnl [Network module]
sway [Sway modules]
libdbusmenu-gtk3 [Tray module]
2019-04-16 14:34:37 +00:00
libmpdclient [MPD module]
2018-08-09 12:00:08 +00:00
```
On Ubuntu 19.10 you can install all the relevant dependencies using this command:
```
sudo apt install \
clang-tidy \
gobject-introspection \
libdbusmenu-gtk3-dev \
libfmt-dev \
libgirepository1.0-dev \
libgtk-3-dev \
libgtkmm-3.0-dev \
libinput-dev \
libjsoncpp-dev \
libmpdclient-dev \
libnl-3-dev \
libnl-genl-3-dev \
libpulse-dev \
libsigc++-2.0-dev \
libspdlog-dev \
libwayland-dev \
scdoc
```
2018-08-16 15:19:02 +00:00
Contributions welcome! - have fun :)<br>
2018-08-16 12:29:41 +00:00
The style guidelines is [Google's](https://google.github.io/styleguide/cppguide.html)
2018-08-10 10:28:54 +00:00
## License
Waybar is licensed under the MIT license. [See LICENSE for more information](https://github.com/Alexays/Waybar/blob/master/LICENSE).