-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathINSTALL
149 lines (103 loc) · 4.84 KB
/
INSTALL
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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
Build instructions
==================
This file is written in rst, so that one can use rst2pdf to create a PDF out of it.
Build on GNU/Linux
------------------
Install the dependencies. (see below)
Build it::
./build.sh
Ubuntu 13.10, 14.04, 15.04 and 16.04 LTS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Install basic development tools fot Qt projects, plus liblo for OSC support::
sudo apt-get install -y \
liblo-dev \
qttools5-dev-tools \
qt5-default \
qtmultimedia5-dev \
libqt5multimedia5-plugins
Install GStreamer 1.0 libraries and plugins::
sudo apt-get install -y \
libgstreamer1.0-dev \
libgstreamer-plugins-base1.0-dev \
gstreamer1.0-gnonlin \
gstreamer1.0-plugins-bad \
gstreamer1.0-libav \
gstreamer1.0-vaapi \
gstreamer1.0-plugins-base \
gstreamer1.0-plugins-base-apps \
gstreamer1.0-plugins-good \
gstreamer1.0-plugins-ugly \
gstreamer1.0-x \
gstreamer1.0-tools
Install extra packages if you want to build the documentation::
sudo apt-get install -y \
doxygen \
graphviz \
rst2pdf \
markdown
Arch Linux
~~~~~~~~~~
Install basic development tools fot Qt projects, GStreamer 1.0 and liblo for OSC support::
sudo pacman -S qt5-tools qt5-multimedia liblo gstreamer
Install GStreamer 1.0 libraries and plugins::
sudo pacman -S gst-libav \
gstreamer-vaapi \
gst-plugins-bad \
gst-plugins-base \
gst-plugins-base-libs \
gst-plugins-good \
gst-plugins-ugly
To edit translations
--------------------
You might need to update the files::
lupdate mapmap.pro
Then, do this::
lrelease mapmap.pro
Build on Mac OS X
-----------------
NOTE: This has been tested on OS X 10.11 (El Capitan).
Install tools and dependencies:
1) Install the Apple Developer Tools
- You need to register with a credit card in the Apple Store in order to download it (no need to pay, but Apple needs your soul).
2) Install Qt5
- You can get the open source version from http://www.qt.io/download-open-source/
- Run the installer and choose the default location (which should be ~/Qt).
- Latest tested version: 5.5.1
3) Install liblo
- Use the following guide: http://macappstore.org/liblo/
- OR compile from the tar.gz - it should install it to /usr/local
4) Install the GStreamer framework. You need the runtime and devel packages to be installed:
- https://gstreamer.freedesktop.org/data/pkg/osx/1.6.0/gstreamer-1.0-1.6.0-x86_64.pkg
- https://gstreamer.freedesktop.org/data/pkg/osx/1.6.0/gstreamer-1.0-devel-1.6.0-x86_64.pkg
- http://gstreamer.freedesktop.org/data/pkg/osx/1.6.0/gstreamer-1.0-1.6.0-x86_64-packages.dmg
Do this::
./build.sh
It will create a .app and a .dmg.
DMGVERSION.txt should be created automatically with "1" as its contents. Update to "2", and so on, if needed.
Use on OS X
-----------
Download GStreamer from:
http://gstreamer.freedesktop.org/data/pkg/osx/1.6.0/gstreamer-1.0-1.6.0-x86_64-packages.dmg
http://gstreamer.freedesktop.org/data/pkg/osx/1.6.0/gstreamer-1.0-1.6.0-x86_64.pkg
Download MapMap.dmg, decompress the app and copy it to /Applications.
If the appearance of the window of the OSC port number in the preferences seem corrupted, you might want to reset MapMap's preferences::
rm -f ~/Library/Preferences/info.mapmap.MapMap.plist
To print debugging informations, launch it from the Terminal app like this::
GST_PLUGIN_PATH=/Library/Frameworks/GStreamer.framework/Libraries GST_DEBUG=2 /Applications/MapMap.app/Contents/MacOS/MapMap
Build for release on Windows
----------------------------
- Download gstreamer-x86 runtime& devel
https://gstreamer.freedesktop.org/data/pkg/windows/1.7.91/gstreamer-1.0-x86-1.7.91.msi https://gstreamer.freedesktop.org/data/pkg/windows/1.7.91/gstreamer-1.0-devel-x86-1.7.91.msi
- Choose complete option during installation process wizard
- Build Mapmap with Qt Creator (qmake, build release)
- Add the bin directory of your Qt installation (e.g. e.g. C:\Qt\Qt5.6.0\5.6\mingw49_32\bin) to the PATH variable
- Open Windows console then run the following command:
windeployqt --release --no-system-d3d-compiler <path-to-app-binary>
- Copy the followings DLL into the target folder together with Mapmap.exe
libffi-6.dll libgobject-2.0-0.dll libgstbase-1.0-0.dll libgsttag-1.0-0.dll liborc-0.4-0.dll
libglib-2.0-0.dll libgstapp-1.0-0.dll libgstpbutils-1.0-0.dll libgstvideo-1.0-0.dll libz.dll
libgmodule-2.0-0.dll libgstaudio-1.0-0.dll libgstreamer-1.0-0.dll libintl-8.dll
- Copy all DLL files of the Gstreamer's bin folder (e.g. C:) into a new folder named 'lib' in the target folder together with mapmap.exe
- Copy all DLL files of the Gstreamer's plugin folder into a new folder named 'plugins' in parallel of lib folder
- Remove lib\libopenh264.dll, lib\libSoundTouch-0.dll, lib\libtag.dll
- Run Mapamp.exe