helvum/README.md

51 lines
1.4 KiB
Markdown
Raw Normal View History

Helvum is a GTK-based patchbay for pipewire, inspired by the JACK tool [catia](https://kx.studio/Applications:Catia).
2021-01-12 11:10:22 +01:00
![Screenshot](screenshot.png)
[![Packaging status](https://repology.org/badge/vertical-allrepos/helvum.svg)](https://repology.org/project/helvum/versions)
2021-01-12 11:10:22 +01:00
# Features planned
- Volume control
- "Debug mode" that lets you view advanced information for nodes and ports
2021-01-12 11:10:22 +01:00
More suggestions are welcome!
# Building
2021-07-22 10:31:44 +02:00
## Via flatpak (recommended)
The recommended way to build is using flatpak, which will take care of all dependencies and avoid any problems that may come from different system configurations.
First, install the required flatpak platform and SDK, if you dont have them already:
```shell
$ flatpak install org.gnome.{Platform,Sdk}//40 org.freedesktop.Sdk.Extension.rust-stable//20.08
```
To compile and install as a flatpak, run
```shell
$ flatpak-builder --install flatpak-build/ org.freedesktop.ryuukyu.Helvum.json
```
You can then run the app via
```shell
flatpak run org.freedesktop.ryuukyu.Helvum
```
## Manually
2021-01-12 11:10:22 +01:00
For compilation, you will need:
- An up-to-date rust toolchain
2021-02-20 18:32:17 +01:00
- `libclang-3.7` or higher
- `gtk-4.0` and `pipewire-0.3` development headers
2021-01-12 11:10:22 +01:00
To compile, run
$ cargo build --release
in the repository root.
The resulting binary will be at `target/release/helvum`.
# License
Helvum is distributed under the terms of the GPL3 license.
See LICENSE for more information.