8 releases

0.4.99 Dec 9, 2023
0.4.0 Feb 12, 2023
0.3.4 Feb 2, 2022
0.3.2 Dec 1, 2021
0.1.0 Mar 12, 2021

#82 in GUI

GPL-3.0-only

135KB
2K SLoC

This crate is deprecated

This crate was originally used to publish releases of Helvum, a GTK-based UI for pipewire.
As the project has grown beyond a single simple binary, cargo install-ing it from crates.io is no longer sufficient.
Therefore, this crates.io release is no longer updated.
Visit https://gitlab.freedesktop.org/pipewire/helvum for the latest source code and releases.

Original Readme

Helvum is a GTK-based patchbay for pipewire, inspired by the JACK tool catia.

Screenshot

Features planned

  • Volume control
  • "Debug mode" that lets you view advanced information for nodes and ports

More suggestions are welcome!

Building

Via flatpak

If you don't have the flathub repo in your remote-list for flatpak you will need to add that first:

$ flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

Then install the required flatpak platform and SDK, if you dont have them already:

$ flatpak install org.gnome.{Platform,Sdk}//43 org.freedesktop.Sdk.Extension.rust-stable//22.08 org.freedesktop.Sdk.Extension.llvm14//22.08

To compile and install as a flatpak, clone the project, change to the project directory, and run:

$ flatpak-builder --install flatpak-build/ build-aux/org.pipewire.Helvum.json

You can then run the app via

$ flatpak run org.pipewire.Helvum

Manually

For compilation, you will need:

  • Meson
  • An up-to-date rust toolchain
  • libclang-3.7 or higher
  • gtk-4.0 and pipewire-0.3 development headers

To compile and install, run

$ meson setup build && cd build
$ meson compile
$ meson install

in the repository root. This will install the compiled project files into /usr/local.

License and Credits

Helvum is distributed under the terms of the GPL3 license. See LICENSE for more information.

Parts of the build system were taken from the gtk-rust-template project, which is provided under the terms of the MIT license.

Dependencies

~24MB
~525K SLoC