Tscope5
tscope5-0.5/00installation.md
1 # Tscope5 installation manual
2 
3 [TOC]
4 
5 # Windows {#wininstall}
6 
7 We bundled all the tools (compiler, libraries, fonts, custom scripts) that Tscope5 relies on into a single installer package called Mingw4Tscope5.
8 
9 Tscope5 itself is not part of MinGW4Tscope5, as it is updated more frequently.
10 
11 After the installation of MinGW4Tscope5, you will still need to install Tscope5 as described in the next section.
12 
13 ## Mingw4Tscope5
14 
15 Download the installer <a href="http://users.ugent.be/~masteven/tscope5/download/MinGW4Tscope5-0.5.exe"> here</a>. It is about 450 megabytes.
16 
17 - Execute the installer. You will need administrative rights to run the installer. A power user account is not enough. If you don't have administrative rights,
18  the installer will tell you and abort.
19 - There are not many installation options. Mingw4Tscope5 will not install in the standard Program Files directory because of the space in that directory's name. It will be installed in C:\\Mingw4Tscope5 instead. (Actually, Mingw4Tscope5 will be installed on the same drive as your Windows system - so if Windows is installed on the D: drive, Mingw4Tscope5 will be installed in D:\\Mingw4Tscope5, etc. All further information on this site assumes Mingw4Tscope5 is installed in C:\\Mingw4Tscope5, but please note that on your system this also might be D:\\Mingw4Tscope5 or any other drive).
20 - If everything is ok, the installer will extract all the necessary files. This can take a while - the fully extracted system takes about 500 megabytes of disk space.
21 
22 After installation an icon called 'MinGW4Tscope5 will be added to your desktop. Double clicking this icon will open a bash shell where you can enter your compilation commands.
23 
24 ## Tscope5
25 
26 - For Windows we provide an automatic installer that can be downloaded <a href="http://users.ugent.be/~masteven/tscope5/download/tscope5-0.5.exe"> here</a>.
27 - Execute the installer in the same way as the MinGW4Tscope5 installer. Again there are no installation options. After installation you are ready to start developing Tscope5 programs.
28 
29 The distribution currently contains a version of <a href="http://notepad-plus-plus.org" target="_blank"> notepad++</a> that has some predefined <a href="md_tscope5-0_84_00compilation.html"> shortcuts </a> to compile and run Tscope5 programs.
30 
31 You can also compile and run Tscope5 programs using the shell commands described in <a href="md_tscope5-0_84_00compilation.html"> the compilation manual </a>.
32 
33 
34 # Mac OS X {#macinstall}
35 
36 ## Xcode
37 
38 First you will need to install Xcode, Apple's development environment. It can be downloaded for free from the App Store. The download can take a while, it is about 3.5 Gigabytes.
39 
40 Once it is installed open it (you can find it in the Applications folder). At first launch, some components will be installed or upgraded. That may also take a while.
41 
42 Then open Preferences in the Xcode menu and choose the Downloads tab. Click on the Install button next to Command Line Tools. When finished, you can close Xcode.
43 
44 ## MacPorts
45 
46 The next step is to install MacPorts. MacPorts provides an infrastructure for building, installing and packaging open source software. It can be downloaded <a href="http://www.macports.org/install.php" target="_blank"> here</a>.
47 
48 Make sure you download a version that is compatible with your version of OS X (versions for Mavericks, Mountain Lion and Lion are available).
49 
50 Once you have installed MacPorts open a Terminal `(Applications/Utilities/Terminal)` and copy-paste the commands described below.
51 
52 First you will need to update your package repository list:
53 
54  sudo port selfupdate
55 
56 Then you can install the libraries that are needed by Allegro5:
57 
58  sudo port install cmake wget gsl zlib freetype jpeg libogg physfs libpng flac libtheora +universal
59 
60 That process will also take a while.
61 
62 ## Allegro5
63 
64 Then you can install Allegro5
65 
66  cd /usr/local/
67  sudo mkdir -p src
68 
69  cd src
70  sudo wget http://users.ugent.be/~masteven/tscope5/download/allegro-5.1.9.tar.bz2
71 
72  sudo tar -xjf allegro-5.1.9.tar.bz2
73 
74  cd allegro-5.1.9
75  mkdir Build
76  cd Build
77  cmake ..
78  make
79  sudo make install
80 
81 
82 ## Fonts
83 
84 Install the fonts needed by Tscope5
85 
86  cd /usr/local/share
87  sudo wget http://users.ugent.be/~masteven/tscope5/download/tscope5_data.tar.bz2
88 
89  sudo tar -xjf tscope5_data.tar.bz2
90 
91 
92 ## Tscope5
93 
94 And finally install Tscope5
95 
96  cd /usr/local/src
97  sudo wget http://users.ugent.be/~masteven/tscope5/download/tscope5-0.5.tar.bz2
98 
99  sudo tar -xjf tscope5-0.5.tar.bz2
100 
101  cd tscope5-0.5
102  sudo make install-macosx
103 
104 If you want to update Tscope5 you will only need to run this last block of commands.
105 
106 A good text editor for Mac OS X is textmate. It can be downloaded <a href="http://macromates.com/" target="_blank"> here</a>.
107 
108 
109 # Linux (Ubuntu) {#lininstall}
110 
111 To get Tscope5 running on Linux, open a terminal window and copy-paste the commands described below.
112 
113 
114 ## Development tools
115 
116 First you will need to update your package repository list:
117 
118  sudo apt-get update
119 
120 Then you can install the development tools
121 
122  sudo apt-get install build-essential git cmake cmake-curses-gui xorg-dev libgl1-mesa-dev libglu-dev
123 
124 And install the Allegro5 addons
125 
126  sudo apt-get install libpng-dev libcurl4-openssl-dev libfreetype6-dev libjpeg-dev libvorbis-dev \
127  libopenal-dev libphysfs-dev libgtk2.0-dev \
128  libasound-dev libpulse-dev libflac-dev libdumb1-dev \
129  libtheora-dev libgsl0-dev
130 
131 
132 ## Allegro5
133 
134 Then you can install Allegro5
135 
136  cd /usr/local/
137  sudo mkdir -p src
138  cd src
139  sudo wget http://users.ugent.be/~masteven/tscope5/download/allegro-5.1.9.tar.bz2
140 
141  sudo tar -xjf allegro-5.1.9.tar.bz2
142 
143  cd allegro-5.1.9
144  mkdir Build
145  cd Build
146  cmake ..
147 
148  make
149 
150  sudo make install
151 
152  sudo ldconfig
153 
154 ## Fonts
155 
156 Install the fonts needed by Tscope5
157 
158  cd /usr/local/share
159  sudo wget http://users.ugent.be/~masteven/tscope5/download/tscope5_data.tar.bz2
160 
161  sudo tar -xjf tscope5_data.tar.bz2
162 
163 ## Tscope5
164 
165 And finally install Tscope5
166 
167  cd /usr/local/src
168  sudo wget http://users.ugent.be/~masteven/tscope5/download/tscope5-0.5.tar.bz2
169 
170  sudo tar -xjf tscope5-0.5.tar.bz2
171 
172  cd tscope5-0.5
173  sudo make install-linux
174 
175  sudo ldconfig
176 
177 If you want to update Tscope5 you will only need to run this last block of commands.
178 
179 
180 # Raspberry Pi (Raspbian) {#raspinstall}
181 
182 To get Tscope5 running on the Raspberry Pi, open a terminal window and copy-paste the commands described below.
183 
184 
185 ## Development tools
186 
187 First you will need to update your package repository list:
188 
189  sudo apt-get update
190 
191 Then you can install the development tools
192 
193  sudo apt-get install build-essential git cmake cmake-curses-gui xorg-dev libgl1-mesa-dev libglu-dev
194 
195 
196 ## Wiring Pi
197 
198 Then you can install Wiring Pi, an interface to the GPIO
199 
200  cd /usr/local/src
201  sudo apt-get install git-core
202  sudo git clone git://git.drogon.net/wiringPi
203  cd wiringPi
204  sudo git pull origin
205  sudo ./build
206 
207 
208 ## Allegro5
209 
210 First install the Allegro5 addons
211 
212  sudo apt-get install libpng-dev libcurl4-openssl-dev libfreetype6-dev libjpeg-dev libvorbis-dev \
213  libopenal-dev libphysfs-dev libgtk2.0-dev \
214  libasound-dev libpulse-dev libflac-dev libdumb1-dev \
215  libtheora-dev libgsl0-dev
216 
217 Then you can install Allegro5
218 
219  cd /usr/local/
220  sudo mkdir -p src
221 
222  cd src
223  sudo wget http://users.ugent.be/~masteven/tscope5/download/allegro-5.1.9.tar.bz2
224 
225  sudo tar -xjf allegro-5.1.9.tar.bz2
226 
227 
228 On Raspbian the next step is:
229 
230  cd allegro-5.1.9
231  sudo mkdir Build
232  cd Build
233  sudo cmake .. -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchain-raspberrypi.cmake
234  sudo make
235 
236  sudo make install
237  sudo cp -r ../include/allegro5/* /usr/local/include/allegro5
238 
239  sudo ldconfig
240 
241 
242 ## Fonts
243 
244 Install the fonts needed by Tscope5
245 
246  cd /usr/local/share
247  sudo wget http://users.ugent.be/~masteven/tscope5/download/tscope5_data.tar.bz2
248 
249  sudo tar -xjf tscope5_data.tar.bz2
250 
251 
252 ## Tscope5
253 
254 And finally install Tscope5
255 
256  cd /usr/local/src
257  sudo wget http://users.ugent.be/~masteven/tscope5/download/tscope5-0.5.tar.bz2
258 
259  sudo tar -xjf tscope5-0.5.tar.bz2
260 
261  cd tscope5-0.5
262  sudo make install-raspberrypi
263 
264  sudo ldconfig
265 
266 If you want to update Tscope5 you will only need to run this last block of commands.
267