Installation#

There are multiple ways to get LiSP installed in your system.

📦 Flatpak#

This is usually the easy path, but depending on your needs it might not be the best.

Note

  • Native JACK is not support in flatpaks, you can get JACK working via PipeWire (pipewire-jack)

  • You might get some issues with dialogs placement and window decorations in Wayland sessions

Prepare your system#

If you don’t already have flatpak installed, follow their simple instructions, here.

Download LiSP#

You can get the latest builds here:

  • Master - Generally stable

  • Development - Preview features, might be unstable and untested

Install#

If you have the right app installed it might be possible to simply double-click the downloaded file, otherwise, you can use the following command:

flatpak install "path/to/file.flatpak"

Important

If the installation produce an error similar the this:

The application org.linuxshowplayer.LinuxShowPlayer/x86_64/master requires the runtime org.kde.Platform/x86_64/5.15-23.08 which was not found.

Before installing LiSP you need to run the following:

flatpak install <name-of-the-runtime>

In the above example the runtime name is org.kde.Platform/x86_64/5.15-23.08.


🐧 From your distribution repository#

For some GNU/Linux distributions you can install a native package.
Keeping in mind that it might not be the latest version, you can find a list on repology.org.


🛠️ Manually#

You want to test something? Hack some plugin? Or simply none of the options above satisfy your needs? Then you can install LiSP manually.

With the following instructions you will:

  1. Install binary dependencies from your distribution repository

  2. Install python dependencies (from pypi) in a venv managed by poetry

  3. Run LiSP in that venv via poetry

Important

What follows are guidelines to run LiSP without a “proper” installation, if something is missing or doens’t work let us know!

Dependencies (1/2)#

To start, you’ll need to install these packages using your package manager:

  • python3 (>= 3.8)

  • python3-dev

  • python3-poetry (>= 1.2, otherwise follow these instructions)

  • gstreamer1.0-plugins-good

  • gstreamer1.0-plugins-ugly

  • gstreamer1.0-plugins-bad

  • gstreamer1.0-libav

  • libasound2

  • libasound2-dev

  • libgirepository1.0-dev

  • libcairo2-dev

  • liblo7

  • liblo-dev

  • librtmidi6

  • python3 (>= 3.8)

  • python3-devel

  • poetry (>= 1.2, otherwise follow these instructions)

  • gstreamer1-plugins-good

  • gstreamer1-plugins-ugly-free

  • gstreamer1-plugins-bad-free

  • gstreamer1-plugin-libav (Not available on CentOS)

  • alsa-lib

  • alsa-lib-devel

  • gobject-introspection-devel

  • cairo-gobject-devel

  • liblo

  • liblo-devel

  • rtmidi

  • python

  • python-poetry

  • gst-plugins-good

  • gst-plugins-ugly

  • gst-plugins-bad

  • gst-libav

  • alsa-lib

  • cairo

  • gobject-introspection

  • liblo

  • rtmidi

  • python

  • poetry

  • gst-plugins-good

  • gst-plugins-ugly

  • gst-plugins-bad

  • gst-plugins-libav

  • alsa-lib

  • cairo

  • gobject-introspection

  • liblo

  • rtmidi

Hint

You might also want to install ola, for ArtNet timecode, however, using the method described here, it’s not possile to use it.

Download#

Download the source code from GitHub or clone the git repository.

Dependencies (2/2)#

Install the python dependencies:

# From the source code root
poetry install

Note

Run this step every time you download a new version of the code.

Run#

# From the source code root
poetry run linux-show-player