A Compact Voicemeeter Remote App
Go to file
2024-07-05 18:06:22 +01:00
configs channel_xpadding and navigation_show added to data. 2023-06-29 17:15:03 +01:00
doc_imgs tomli/tomllib compatibility layer added. 2022-09-03 19:29:57 +01:00
tools upd rewriter to reflect changes to pyinstaller 2024-01-30 15:07:20 +00:00
vmcompact use {Bus}.mode.get() to fetch current bus mode 2024-07-05 18:06:22 +01:00
__main__.py 1.9.0 section added to changelog 2023-07-11 08:36:19 +01:00
.gitignore build scripts added 2023-08-27 02:41:07 +01:00
build.ps1 build scripts added 2023-08-27 02:41:07 +01:00
CHANGELOG.md add 1.9.5 section to CHANGELOG 2024-07-03 08:06:06 +01:00
INSTALLATION.md tomli/tomllib compatibility layer added. 2022-09-03 19:29:57 +01:00
LICENSE Initial commit 2022-04-11 13:14:34 +01:00
poetry.lock use {Bus}.mode.get() to fetch current bus mode 2024-07-05 18:06:22 +01:00
pyproject.toml use {Bus}.mode.get() to fetch current bus mode 2024-07-05 18:06:22 +01:00
README.md bump dependencies 2024-07-02 22:24:51 +01:00
scripts.py build scripts added 2023-08-27 02:41:07 +01:00

PyPI version License: MIT Poetry Code style: black OS: Windows

Image of app/potato size comparison

Voicemeeter Compact

A compact Voicemeeter remote app, works locally and over LAN.

For an outline of past/future changes refer to: CHANGELOG

Prerequisites

  • Voicemeeter (Basic v1.0.8.4), (Banana v2.0.6.4) or (Potato v3.0.2.4)
  • Python 3.10 or greater

Installation

For a step-by-step guide click here

pip install voicemeeter-compact

Usage

Example __main__.py file:

import voicemeeterlib
import vmcompact


def main():
    # choose the kind of Voicemeeter (Local connection)
    KIND_ID = "banana"

    # pass the KIND_ID and the vm object to the app
    with voicemeeterlib.api(KIND_ID) as vm:
        app = vmcompact.connect(KIND_ID, vm)
        app.mainloop()


if __name__ == "__main__":
    main()

It's important to know that only labelled strips and buses will appear in the Channel frames. Removing a Channels label will cause the GUI to grow/shrink in real time.

Image of unlabelled app

If the GUI looks like the above when you first load it, then no channels are labelled. From the menu, Configs->Load config you may load an example config. Save your current Voicemeeter settings first :).

KIND_ID

Set the kind of Voicemeeter, KIND_ID may be:

  • basic
  • banana
  • potato

TOML Files

This is how your files should be organised. Wherever your __main__.py file is located (after install this can be any location), configs should be in the same location. Directly inside of configs directory you may place an app.toml, vban.toml and a directory for each kind. Inside each kind directory you may place as many custom toml configurations as you wish.

.

├── __main__.py

├── configs

        ├── app.toml

        ├── vban.toml

        ├── basic

                ├── example.toml

                ├── other_config.toml

                ├── streaming_config.toml

        ├── banana

                ├── example.toml

                ├── other.toml

                ├── ...

        ├── potato

                ├── example.toml

                ├── ...

Configs

app.toml

Configure certain startup states for the app.

  • configs Configure a user config to load on app startup. Don't include the .toml extension in the config name.

  • theme By default the app loads up the [Sun Valley light or dark theme][def] by @rdbende. You have the option to load up the app without any theme loaded. Simply set enabled to false and mode will take no effect.

  • extends Extending the app will show both strips and buses. In reduced mode only one or the other. This app will extend both horizontally and vertically, simply set extends_horizontal true or false accordingly.

  • channel For each channel labelframe the width and height may be adjusted which effects the spacing between widgets and the length of the scales and progressbars respectively.

  • mwscroll_step Sets the amount (in db) the gain slider moves with a single mousewheel step. Default 3.

  • submixes Select the default submix bus when Submix frame is shown. For example, a dedicated bus for OBS.

vban.toml

Configure as many vban connections as you wish. This allows the app to work over a LAN connection as well as with a local Voicemeeter installation.

For vban connections to work correctly VBAN TEXT incoming stream MUST be configured correctly on the remote machine. Both pcs ought to be connected to a local private network and should be able to ping one another.

A valid vban.toml might look like this:

[connection-1]
kind = 'banana'
ip = '192.168.1.2'
streamname = 'worklaptop'
port = 6980

[connection-2]
kind = 'potato'
ip = '192.168.1.3'
streamname = 'streampc'
port = 6990

basic/ banana/ potato/

Three example user configs are included with the package, one for each kind of Voicemeeter. Use these to configure parameter startup states. Any parameter supported by the underlying interfaces may be used. Check the 'multiple-parameters' section for more info:

Python Interface for the Voicemeeter API

Python Interface for VBAN CMD

User configs may be loaded at any time via the menu.

Special Thanks

Vincent Burel for creating Voicemeeter and its SDK.

Rdbende for creating the beautiful Sun Valley theme.