1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
# Preparing the source tree
If you just cloned the git repository, make sure you also
cloned the submodules, which you can do using:
`$ git submodule update --init`
# Building
## Build dependencies
The required build dependencies are: (devel packages of these)
- PyQt6 (or PyQt5)
- Qt6 dev tools (or Qt5 dev tools)
- qtchooser (only for translations)
- qttools5-dev-tools (only for translations, works for Qt5 and Qt6)
The difficulty with Qt6 build (which is the default), is sometimes to get the following executables:
- rcc
- lrelease
By chance, the compilation should work even if theses 2 tools are supposed to work with Qt5.
On Debian and Ubuntu, use these commands as root to install all build
dependencies:
- for Qt6 build:
`$ [sudo] apt install pyqt6-dev-tools qt6-base-dev-tools qtchooser qttools5-dev-tools`
- for Qt5 build:
`$ [sudo] apt install pyqt5-dev-tools qtchooser qttools5-dev-tools`
To build RaySession, simply run as usual:
`$ make`
if you prefer to build it with Qt5:
`$ QT_VERSION=5 make`
Depending of the distribution you might need to use the LRELEASE variable
to build. If you don't have 'lrelease' executable but 'lrelease-qt5' use:
`$ make LRELEASE=lrelease-qt5`
on Debian, you probably need to set RCC this way:
`$ RCC=/usr/lib/qt6/libexec/rcc make`
# Installing
To install RaySession, simply run as usual:
`$ [sudo] make install`
Packagers can make use of the 'PREFIX' and 'DESTDIR' variable during install,
like this:
`$ [sudo] make install PREFIX=/usr DESTDIR=./test-dir`
# Uninstalling
To uninstall RaySession, run:
`$ [sudo] make uninstall`
# Runtime dependencies
To run it, you'll additionally need:
- qt6-svg-plugins (or probably libqt5svg5 for Qt5)
- python3-pyqt6 (or python3-pyqt5 for Qt5)
- python3-pyqt6.qtsvg (or python3-pyqt5 for Qt5)
- python3-qtpy
- python3-jack-client
- python3-pyliblo3 (or python3-liblo, depending on what is available)
- git (not absolutely required but highly recommended)
- python3-pyalsa (recommended)
- Roboto font family (used by default patchbay theme)
To install runtime dependencies on debian based systems, run:
`[sudo] apt install qt6-svg-plugins python3-pyqt6 python3-pyqt6.qtsvg python3-qtpy python3-jack-client git python3-pyalsa python3-liblo fonts-roboto`
IMPORTANT: since python 3.11, because pyliblo has been totally abandonned
by Dominic Sacre, for liblo you need to use the following fork:
https://github.com/gesellkammer/pyliblo3
Simply install it with:
`$ python3 -m pip install pyliblo3`
# Running
You can run RaySession without install, by using:
`$ ./src/bin/raysession`
|
