mirror of
https://github.com/brunoherbelin/vimix.git
synced 2025-12-13 11:19:58 +01:00
Update build instructions to reference flatpak
This commit is contained in:
48
README.md
48
README.md
@@ -17,45 +17,50 @@ vimix is the successor for GLMixer - https://sourceforge.net/projects/glmixer/
|
|||||||
GPL-3.0-or-later
|
GPL-3.0-or-later
|
||||||
See [LICENSE](https://github.com/brunoherbelin/vimix/blob/master/LICENSE)
|
See [LICENSE](https://github.com/brunoherbelin/vimix/blob/master/LICENSE)
|
||||||
|
|
||||||
# Install
|
# Install vimix
|
||||||
|
|
||||||
Check the [Quick Installation Guide](https://github.com/brunoherbelin/vimix/wiki/Quick-Installation-Guide)
|
Check the [Quick Installation Guide](https://github.com/brunoherbelin/vimix/wiki/Quick-Installation-Guide)
|
||||||
|
|
||||||
### Linux
|
### Linux
|
||||||
|
|
||||||
Download and install a release package from https://snapcraft.io/vimix
|
Download and install a released snap package from https://snapcraft.io/vimix
|
||||||
|
|
||||||
$ snap install vimix
|
~$ snap install vimix
|
||||||
|
|
||||||
NB: You might need to setup the snap permissions.
|
Install the stable debian package
|
||||||
|
|
||||||
|
~$ sudo apt install vimix
|
||||||
|
|
||||||
### Mac OSX
|
### Mac OSX
|
||||||
|
|
||||||
Download and open a release package from https://github.com/brunoherbelin/vimix/releases
|
Download and open a release package from https://github.com/brunoherbelin/vimix/releases
|
||||||
|
|
||||||
NB: You'll need to accept the exception in OSX security preference.
|
NB: You'll need to accept the exception in OSX security preference.
|
||||||
|
|
||||||
|
# Build vimix
|
||||||
|
|
||||||
## Clone
|
## Clone
|
||||||
|
|
||||||
$ git clone --recursive https://github.com/brunoherbelin/vimix.git
|
~$ git clone --recursive https://github.com/brunoherbelin/vimix.git
|
||||||
|
|
||||||
This will create the directory 'vimix', download the latest version of vimix code,
|
This will create the directory 'vimix', download the latest version of vimix code,
|
||||||
and (recursively) clone all the internal git dependencies.
|
and (recursively) clone all the internal git dependencies.
|
||||||
|
|
||||||
To only update a cloned git copy:
|
To only update a cloned git copy:
|
||||||
|
|
||||||
$ git pull
|
~$ git pull
|
||||||
|
|
||||||
## Compile
|
## Compile
|
||||||
|
|
||||||
First time after git clone:
|
First time after git clone:
|
||||||
|
|
||||||
$ mkdir vimix-build
|
~$ mkdir vimix-build
|
||||||
$ cd vimix-build
|
~$ cd vimix-build
|
||||||
$ cmake -DCMAKE_BUILD_TYPE=Release ../vimix
|
~$ cmake -DCMAKE_BUILD_TYPE=Release ../vimix
|
||||||
|
|
||||||
Compile (or re-compile after pull):
|
Compile (or re-compile after pull):
|
||||||
|
|
||||||
$ cmake --build .
|
~$ cmake --build .
|
||||||
|
|
||||||
### Dependencies
|
### Dependencies
|
||||||
|
|
||||||
@@ -85,21 +90,24 @@ Optionnal:
|
|||||||
|
|
||||||
**Ubuntu**
|
**Ubuntu**
|
||||||
|
|
||||||
$ apt-get install build-essential cmake libpng-dev libglfw3-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-libav libicu-dev libgtk-3-dev
|
~$ apt-get install build-essential cmake libpng-dev libglfw3-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-libav libicu-dev libgtk-3-dev
|
||||||
|
|
||||||
Optionnal:
|
Optionnal:
|
||||||
|
|
||||||
$ apt-get install libglm-dev libstb-dev libtinyxml2-dev ableton-link-dev
|
~$ apt-get install libglm-dev libstb-dev libtinyxml2-dev ableton-link-dev
|
||||||
|
|
||||||
|
|
||||||
Follow the instructions to [install Shmdata](https://gitlab.com/sat-mtl/tools/shmdata).
|
Follow the instructions to [install Shmdata](https://gitlab.com/sat-mtl/tools/shmdata).
|
||||||
|
|
||||||
**OSX with Brew**
|
**OSX with Brew**
|
||||||
|
|
||||||
$ brew install cmake libpng glfw gstreamer gst-libav gst-plugins-bad gst-plugins-base gst-plugins-good gst-plugins-ugly icu4c
|
~$ brew install cmake libpng glfw gstreamer gst-libav gst-plugins-bad gst-plugins-base gst-plugins-good gst-plugins-ugly icu4c
|
||||||
|
|
||||||
|
### Generate flatpak
|
||||||
|
|
||||||
#### Generate snap
|
Building a flatpak package is a good option for having the latest version from git while avoiding to install all dependencies in your machine. Instructions are found [here](https://github.com/brunoherbelin/vimix/tree/master/flatpak).
|
||||||
|
|
||||||
|
### Generate snap
|
||||||
|
|
||||||
To generate the snap (from vimix directory):
|
To generate the snap (from vimix directory):
|
||||||
|
|
||||||
@@ -107,17 +115,7 @@ To generate the snap (from vimix directory):
|
|||||||
|
|
||||||
To install and test the locally created snap:
|
To install and test the locally created snap:
|
||||||
|
|
||||||
$ snap install --dangerous vimix_0.5_amd64.snap
|
$ snap install --dangerous vimix_0.X.Y_amd64.snap
|
||||||
|
|
||||||
#### Generate flatpak
|
|
||||||
|
|
||||||
To generate and install the flatpack:
|
|
||||||
|
|
||||||
$ flatpak-builder --user --install --force-clean build ##PATH_TO_VIMIX##/flatpak/io.github.brunoherbelin.Vimix.json
|
|
||||||
|
|
||||||
To run the installed flatpak:
|
|
||||||
|
|
||||||
$ flatpak run io.github.brunoherbelin.Vimix
|
|
||||||
|
|
||||||
### Memcheck
|
### Memcheck
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user