Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bzglve/unirun
Wayland-native runner
https://github.com/bzglve/unirun
gtk gtk4 launcher runner rust wayland
Last synced: 3 months ago
JSON representation
Wayland-native runner
- Host: GitHub
- URL: https://github.com/bzglve/unirun
- Owner: bzglve
- License: mit
- Created: 2024-07-13T11:01:35.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2024-08-17T06:28:56.000Z (6 months ago)
- Last Synced: 2024-10-25T08:36:20.183Z (4 months ago)
- Topics: gtk, gtk4, launcher, runner, rust, wayland
- Language: Rust
- Homepage:
- Size: 125 KB
- Stars: 10
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# UniRun
Yet another ~~shameless plug~~ runner appliction.
Highly inspired by [Anyrun](https://github.com/anyrun-org/anyrun) and [Walker](https://github.com/abenz1267/walker).
---
- Rust
- GTK4 with gtk4-layer-shell
- plugins via Unix-sockets to be able to write them in any language that can work with IPC and will communicate with main app by some kind of protocol [NOTES](NOTES.md)
## How to
### Build
```bash
git clone --recursive https://github.com/bzglve/unirun.git
cd unirun
cargo build --release
```
#### Customizing build
unirun crate contains some features
to build with/without features you can do
```bash
# build enabling feature
cargo build --release --features A --features B
# build without default features
cargo build --release --no-default-features
# combining theese two
cargo build --release --no-default-features --features A
```
##### Features
- `dep:gtk-layer-shell` - `gtk-layer-shell` as optional dependency. For thouse who don't have that
###### Default
- `dep:gtk-layer-shell`
### Install
```bash
# compile and put unirun and plugins to ~/.cargo/bin
cargo install --path unirun
cargo install --path plugins/*
# or you can copy unirun and plaugins binary to whereever dir you want
# cp target/release/unirun{,-plugin-application} ~/.local/bin
```
### Run
```bash
unirun # if it placed into dir from your $PATH
```
> [!NOTE]
>
> unirun will scan dir where it placed for files matches `unirun-plugin-*` to launch them
>
> so plugin need to be named proper way and placed alongside with unirun binary
#### Customizing run
- with (no) features and without install
```bash
cargo run --bin unirun --no-default-features
```
- logging
```bash
# trace debug warn info error
RUST_LOG=trace cargo run # ...
```
## Comments
- yes, code looks terrible [todo](#todo)
- currently only one plugin [todo](#todo)
- expanding there will be more, but it requires to write good looking messages protocol
- mostly plugins will be written in rust as I'm currenly don't know how to be better to write common `unirun`-`plugin` parts without rewriting it from rust to for example python (?FFI)
- but tecnically it is possible to use anything that works with socket
## TODO
- [ ] Refactor and optimize
- [ ] Configuration
- [ ] Protocol
- [ ] Plugins
- [ ] UI
- [x] Close on Escape
- [x] First row selected by default