[](https://badge.fury.io/py/voicemeeter-compact)
[](https://github.com/onyx-and-iris/voicemeeter-compact/blob/main/LICENSE)
[](https://github.com/psf/black)
# Voicemeeter Compact
A compact Voicemeeter remote app, works locally and over LAN.
For an outline of past/future changes refer to: [CHANGELOG](CHANGELOG.md)
## Prerequisites
- [Voicemeeter](https://voicemeeter.com/) (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](INSTALLATION.md)
```
pip install voicemeeter-compact
```
## Usage
Example `__main__.py` file:
```python
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.
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](https://github.com/rdbende/Sun-Valley-ttk-theme) 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:
```toml
[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 Voicemeeter API](https://github.com/onyx-and-iris/voicemeeter-api-python#multiple-parameters)
[Python Interface for VBAN CMD](https://github.com/onyx-and-iris/vban-cmd-python#multiple-parameters)
User configs may be loaded at any time via the menu.
## Special Thanks
[Vincent Burel](https://github.com/vburel2018) for creating Voicemeeter, its SDK, the C Remote API, the RT Packet service and Streamer View app!
[Rdbende](https://github.com/rdbende) for creating the beautiful Sun Valley Tkinter theme and adding it to Pypi!
Raw data
{
"_id": null,
"home_page": "https://github.com/onyx-and-iris/voicemeeter-compact",
"name": "voicemeeter-compact",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "onyx-and-iris",
"author_email": "code@onyxandiris.online",
"download_url": "https://files.pythonhosted.org/packages/ed/89/0ddbeb9a5ee9185a97bc4bbae9bd890e736809814cd3fee8788a3dfba09b/voicemeeter_compact-1.9.2.tar.gz",
"platform": null,
"description": "[](https://badge.fury.io/py/voicemeeter-compact)\n[](https://github.com/onyx-and-iris/voicemeeter-compact/blob/main/LICENSE)\n[](https://github.com/psf/black)\n\n\n\n\n# Voicemeeter Compact\n\nA compact Voicemeeter remote app, works locally and over LAN.\n\nFor an outline of past/future changes refer to: [CHANGELOG](CHANGELOG.md)\n\n## Prerequisites\n\n- [Voicemeeter](https://voicemeeter.com/) (Basic v1.0.8.4), (Banana v2.0.6.4) or (Potato v3.0.2.4)\n- Python 3.10 or greater\n\n## Installation\n\nFor a step-by-step guide [click here](INSTALLATION.md)\n\n```\npip install voicemeeter-compact\n```\n\n## Usage\n\nExample `__main__.py` file:\n\n```python\nimport voicemeeterlib\nimport vmcompact\n\n\ndef main():\n # choose the kind of Voicemeeter (Local connection)\n KIND_ID = \"banana\"\n\n # pass the KIND_ID and the vm object to the app\n with voicemeeterlib.api(KIND_ID) as vm:\n app = vmcompact.connect(KIND_ID, vm)\n app.mainloop()\n\n\nif __name__ == \"__main__\":\n main()\n```\n\nIt'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.\n\n\n\nIf 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 :).\n\n### KIND_ID\n\nSet the kind of Voicemeeter, KIND_ID may be:\n\n- `basic`\n- `banana`\n- `potato`\n\n## TOML Files\n\nThis 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.\nDirectly inside of configs directory you may place an app.toml, vban.toml and a directory for each kind.\nInside each kind directory you may place as many custom toml configurations as you wish.\n\n.\n\n\u251c\u2500\u2500 `__main__.py`\n\n\u251c\u2500\u2500 configs\n\n \u251c\u2500\u2500 app.toml\n\n \u251c\u2500\u2500 vban.toml\n\n \u251c\u2500\u2500 basic\n\n \u251c\u2500\u2500 example.toml\n\n \u251c\u2500\u2500 other_config.toml\n\n \u251c\u2500\u2500 streaming_config.toml\n\n \u251c\u2500\u2500 banana\n\n \u251c\u2500\u2500 example.toml\n\n \u251c\u2500\u2500 other.toml\n\n \u251c\u2500\u2500 ...\n\n \u251c\u2500\u2500 potato\n\n \u251c\u2500\u2500 example.toml\n\n \u251c\u2500\u2500 ...\n\n## Configs\n\n### app.toml\n\nConfigure certain startup states for the app.\n\n- `configs`\n Configure a user config to load on app startup. Don't include the .toml extension in the config name.\n\n- `theme`\n By default the app loads up the [Sun Valley light or dark theme](https://github.com/rdbende/Sun-Valley-ttk-theme) 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.\n\n- `extends`\n 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.\n\n- `channel`\n 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.\n\n- `mwscroll_step`\n Sets the amount (in db) the gain slider moves with a single mousewheel step. Default 3.\n\n- `submixes`\n Select the default submix bus when Submix frame is shown. For example, a dedicated bus for OBS.\n\n### vban.toml\n\nConfigure 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.\n\nFor 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.\n\nA valid `vban.toml` might look like this:\n\n```toml\n[connection-1]\nkind = 'banana'\nip = '192.168.1.2'\nstreamname = 'worklaptop'\nport = 6980\n\n[connection-2]\nkind = 'potato'\nip = '192.168.1.3'\nstreamname = 'streampc'\nport = 6990\n```\n\n### basic/ banana/ potato/\n\nThree 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:\n\n[Python Interface for Voicemeeter API](https://github.com/onyx-and-iris/voicemeeter-api-python#multiple-parameters)\n\n[Python Interface for VBAN CMD](https://github.com/onyx-and-iris/vban-cmd-python#multiple-parameters)\n\nUser configs may be loaded at any time via the menu.\n\n## Special Thanks\n\n[Vincent Burel](https://github.com/vburel2018) for creating Voicemeeter, its SDK, the C Remote API, the RT Packet service and Streamer View app!\n\n[Rdbende](https://github.com/rdbende) for creating the beautiful Sun Valley Tkinter theme and adding it to Pypi!\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Compact Voicemeeter Remote App",
"version": "1.9.2",
"project_urls": {
"Homepage": "https://github.com/onyx-and-iris/voicemeeter-compact",
"Repository": "https://github.com/onyx-and-iris/voicemeeter-compact"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e14afeafaa72eb9b0061f391453cac80c5858a02efec4b708fa0e463ae558564",
"md5": "50619787e49118fbb4df961e2e8c07c9",
"sha256": "ab5adf24a03e0807af81b4267e0b68d1db7289c787b2b26770623b525715acd2"
},
"downloads": -1,
"filename": "voicemeeter_compact-1.9.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "50619787e49118fbb4df961e2e8c07c9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10,<4.0",
"size": 45920,
"upload_time": "2023-08-06T22:21:57",
"upload_time_iso_8601": "2023-08-06T22:21:57.354199Z",
"url": "https://files.pythonhosted.org/packages/e1/4a/feafaa72eb9b0061f391453cac80c5858a02efec4b708fa0e463ae558564/voicemeeter_compact-1.9.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ed890ddbeb9a5ee9185a97bc4bbae9bd890e736809814cd3fee8788a3dfba09b",
"md5": "e5f593f54b9d3c5428989698842d2649",
"sha256": "d99b76d3249176933f8666787167c68aa0836d8fc382a3f39a96b1c4ba5aab1d"
},
"downloads": -1,
"filename": "voicemeeter_compact-1.9.2.tar.gz",
"has_sig": false,
"md5_digest": "e5f593f54b9d3c5428989698842d2649",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10,<4.0",
"size": 43751,
"upload_time": "2023-08-06T22:21:59",
"upload_time_iso_8601": "2023-08-06T22:21:59.076683Z",
"url": "https://files.pythonhosted.org/packages/ed/89/0ddbeb9a5ee9185a97bc4bbae9bd890e736809814cd3fee8788a3dfba09b/voicemeeter_compact-1.9.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-06 22:21:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "onyx-and-iris",
"github_project": "voicemeeter-compact",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "voicemeeter-compact"
}
JSON
