mirror of
https://github.com/onyx-and-iris/voicemeeter-compact.git
synced 2024-11-16 01:50:51 +00:00
b116c6a24f
python version requirement changed. updated installation instructions tomli added as runtime dependency if py ver < 3.11 minor version bump.
50 lines
1.8 KiB
Markdown
50 lines
1.8 KiB
Markdown
## Python Installation
|
|
|
|
If you don't have Python already you can fetch it easily from the Windows Store. Simply type `store` into the windows search bar. To run this GUI you'll need Python version 3.10 or above.
|
|
|
|
![Image of Python 311 in Windows Store](./doc_imgs/python311.png)
|
|
|
|
If you install Python straight from `python.org` instead remember to click 'Add Python environmental variables', this is important.
|
|
|
|
## Install Code
|
|
|
|
Once Python is installed:
|
|
|
|
Create a directory in the location you wish to install the GUI. This can be anywhere.
|
|
|
|
Copy the `__main__.py` file from the code files into this directory. (Copy paste will do but ensure the file name is exactly `__main__.py`)
|
|
|
|
Then type `powershell.exe` into the explorer bar as shown in the image below.
|
|
|
|
![Image of PS in Explorer](./doc_imgs/gui_install.png)
|
|
|
|
This will open a Powershell in the current directory.
|
|
|
|
Then use the command `pip install voicemeeter-compact` and wait for the required packages to install.
|
|
|
|
## Use
|
|
|
|
You will need to set the kind of Voicemeeter you want to run in the `__main__.py` file. Just edit the kind_id line to one of the following:
|
|
|
|
- basic
|
|
- banana
|
|
- potato
|
|
|
|
```python
|
|
if __name__ == "__main__":
|
|
# choose the kind of Voicemeeter (Local connection)
|
|
kind_id = "banana"
|
|
```
|
|
|
|
Finally, in powershell, run the GUI with the command `pythonw .`
|
|
|
|
If the GUI looks like the image below 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 :).
|
|
|
|
![Image of no labels example](./doc_imgs/nolabels.png)
|
|
|
|
## Updates
|
|
|
|
If there are updates to the app, you can track them in the [CHANGELOG](CHANGELOG.md)
|
|
|
|
To install any updates simply open a Powershell in the install directory as explained above, then use the commmand `pip install voicemeeter-compact -U`
|