venmic fork

this is a fork of venmic which removes the PipeWire check so that it always passes.

why?

the PipeWire check actually doesn't check whether PipeWire is running. instead, it queries PulseAudio and checks whether it is PulseAudio or PipeWire (via pipewire-pulse). therefore it assumes that the user is using pipewire-pulse instead of PulseAudio.

what if you have a PulseAudio-less setup? or you want to keep using vanilla PulseAudio (for example with the JACK sink)? this test will fail as it finds vanilla PulseAudio and not pipewire-pulse.

so yeah. I removed the check and simply made it return true.

original readme

venmic - screenshare support for pipewire

Warning

This project is not intended for standalone usage. You need a modified discord client that makes use of this.

📖 Usage

venmic can be used as node-module or as a local rest-server.

The node-module is intended for internal usage by Vesktop.

The Rest-Server exposes three simple endpoints

• (POST) /list

  List all available applications to share.
  You can optionally define a JSON-Body containing all the props the listed nodes should have (i.e. ["node.name"]).

• (POST) /link

  Expects a JSON-Body in the following form:

  {
    "include": 
    [
      { "key": "node.name", "value": "Firefox" }
    ],
    "exclude":
    [
      { "key": "node.name", "value": "Chrome" }
    ]
    "ignore_devices": true,
    "workaround": [{ "key": "node.name", "value": "Chrome" }]
  }

  Depending on wether or not include or exclude are defined the behavior will change:

  • only include
    • Links nodes that match given props
  • only exclude
    • Links nodes that do not match given props
  • both include and exclude
    • Links all applications that match props in include and not those given in exclude

  The setting ignore_devices is optional and will default to true.
  When enabled it will prevent hardware-devices like speakers and microphones from being linked to the virtual microphone.

  The setting workaround is also optional and will default to an empty array.
  When set, venmic will redirect the first node that matches the all of the specified properties to itself.

• (GET) /unlink

  Unlinks the currently linked application

🏗️ Compiling

• Rest-Server

  git clone https://github.com/Vencord/linux-virtmic && cd linux-virtmic
  cmake -B build && cmake --build build

• Node-Addon

  git clone https://github.com/Vencord/linux-virtmic && cd linux-virtmic
  pnpm install

🐛 Debugging

When reporting an issue please make sure to set the environment variable VENMIC_ENABLE_LOG.

If said variable is set venmic will output a lot of useful information to stdout and a log-file which can be found in ~/.local/state/venmic/venmic.log.

It is highly recommended to include this log file in your issue report otherwise we may not be able to help you!

🤝 Acknowledgements

This project heavily relies on the following projects:

• Curve/rohrkabel
• cmake-js

Kudos to all the developers involved, keep up the great work!