https://github.com/simplyceo/wofi
Wofi is a launcher/menu program for wlroots based wayland compositors such as sway.
https://github.com/simplyceo/wofi
Last synced: 9 months ago
JSON representation
Wofi is a launcher/menu program for wlroots based wayland compositors such as sway.
- Host: GitHub
- URL: https://github.com/simplyceo/wofi
- Owner: SimplyCEO
- License: gpl-3.0
- Created: 2024-05-02T10:37:34.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-05-03T03:31:16.000Z (about 2 years ago)
- Last Synced: 2024-11-07T17:36:48.007Z (over 1 year ago)
- Language: C
- Homepage:
- Size: 3.2 MB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING.md
Awesome Lists containing this project
README
Wofi
====
Wofi is a launcher/menu program for wlroots based wayland compositors such as sway.
This repository is a fork of https://hg.sr.ht/~scoopta/wofi with some [additions](https://github.com/SimplyCEO/wofi/commits/master/?author=SimplyCEO).
Dependencies
------------
- PkgConf
- Wayland
- GLib2
- GObject
- GTK3
`cmake` or `meson` is required to build.
Use CMake if your C compiler is not GCC or Clang.
Building
--------
Clone the repository:
```shell
git clone --depth 1 https://github.com/SimplyCEO/wofi.git
cd wofi
```
Then build with your desired build system:
- CMake:
```shell
cmake -S . -B build \
-DCMAKE_INSTALL_PREFIX=/usr/local \
-DENABLE_RUN=1 \
-DENABLE_DRUN=1 \
-DENABLE_DMENU=1
cmake --build build
```
There are more available options in [CMakeLists.txt](/CMakeLists.txt).
```shell
cat CMakeLists.txt | head -n 87 | tail -n $((87-66)) | less
```
- Meson:
```shell
meson setup build
ninja -C build
```
Installing
----------
- CMake:
```shell
su -c "cmake --install build"
```
- Meson:
```shell
su -c "ninja -C build install"
```
Uninstalling
------------
- CMake:
```shell
su -c "xargs -a build/install_manifest.txt rm"
```
- Meson:
```shell
su -c "ninja -C build uninstall"
```
Bug Reports
-----------
This fork is not connected to mainstream, so, for any bugs
regarding newer software behaviour please file reports at their
sourcehut repository: https://todo.sr.ht/~scoopta/wofi
Contributing
------------
It is advised to submit patches to https://lists.sr.ht/~scoopta/wofi
since this fork is not connected to mainstream.
You can find documentation here https://man.sr.ht/hg.sr.ht/email.md
drun and dbus
-------------
Some desktop files declare themselves as being launched by dbus,
if this is the case wofi can experience issues
on systems where a user session bus is not automatically started
such as systems using elogind.
To manually launch a user session bus run the following:
```shell
dbus-daemon --session --address=unix:path=$XDG_RUNTIME_DIR/bus
```
Packages
--------
[](https://repology.org/project/wofi/versions)
Documentation
-------------
The official documentation is provided by the man pages in this repository, sample styling can be found here https://cloudninja.pw/docs/wofi.html
Donating
--------
If you feel like supporting development you can donate at https://ko-fi.com/scoopta
Screenshots
-----------
[](https://f.cloudninja.pw/Rootbar_Example_4.png)