Metadata-Version: 2.4
Name: liquiphy_gui
Version: 1.5.1
Summary: A simple graphical front-end to liquidsfz.
Author-email: Leon Dionne <ldionne@dridesign.sh.cn>
Description-Content-Type: text/markdown
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Multimedia :: Sound/Audio :: Sound Synthesis
Classifier: Topic :: Multimedia :: Sound/Audio :: MIDI
License-File: LICENSE
Requires-Dist: PyQt5
Requires-Dist: conn_jack >= 1.3.2
Requires-Dist: liquiphy >= 1.2.0
Requires-Dist: soso_qt_extras >= 1.10.0
Project-URL: Home, https://github.com/Zen-Master-SoSo/liquiphy_gui

# liquiphy_gui

A quick and dirty GUI interface to the liquidsfz command-line using python's subprocess.

Need to listen to an .sfz file without a lot of hassle? Use liquiphy_gui!

	$ liquiphy-gui <path-to-sfz>

The above command loads the given .sfz file in a liquidsfz instance and
automatically connects the Jack MIDI input and Jack audio outputs to the first
available (physical) ports, displaying the SFZ name and ports connected in a
simple dialog.
<img width="400" height="168" alt="Main tab" src="https://github.com/user-attachments/assets/43290c38-9549-4978-b639-d6886e5d5154" />

Errors that liquidsfsz reported during parsing show up in the "Errors" tab:
<img width="400" height="168" alt="Errors tab" src="https://github.com/user-attachments/assets/c1c2a6e1-a850-40db-8703-b067078aa77c" />


Hit the Escape key or ctrl-Q to exit.

## Install

### Install liquidsfz

You must install liquidsfz first for this package to work. To install:

1. Make sure you have all the build dependencies:

```
$ sudo apt install \
	automake autoconf autoconf-archive libtool \
	libjack-jackd2-dev libreadline-dev lv2-dev libsndfile1-dev \
	libgl-dev libxrandr-dev libxcursor-dev libxext-dev
```

2. Clone the repo:

```
$ git clone https://github.com/swesterfeld/liquidsfz.git
```

3. Ensure the repo's submodules exist and are up-to-date. Enter the repo dir
and update:

```
$ cd liquidsfz
$ git submodule update --init --recursive
```

4. Run the autogen script found in the repo directory:

```
$ ./autogen.sh
```

5. Then, do the configure, make, install routine:

```
./configure
make
make install
```

### Install liquiphy_gui

Install this package (liquiphy_gui) using python pip:

```bash
$ pip install liquiphy_gui
```

...or...

```bash
$ python3 -m pip install liquiphy_gui
```

## File associations

If you would like to open .sfz files in liquiphy-gui by double-clicking them in
your file explorer, you can add an association.

1. Right click on an .sfz file to bring up the context menu.

2. Select "Open With", and then "Other Application"
<img width="799" height="525" alt="nemo-open-with" src="https://github.com/user-attachments/assets/b203be50-ca67-44e1-8511-b50569071541" />

3. In the dialog show, look for "liquiphy-gui" in the list of applications, and
then click "Set as default".
<img width="575" height="563" alt="gnome-set-default" src="https://github.com/user-attachments/assets/cd1c7bea-f867-475e-afee-b11451a3fd55" />

Now, all it takes to preview an .sfz is double-clicking on it. Jack ports are
instantly connected, and you have your live preview.

