1 # Quick and dirty guide for compiling remmina on ubuntu 14.04
3 ### WARNING: remmina is no longer supported on ubuntu 14.04, see this [blog post](https://remmina.org/ubuntu-14-04-end-of-support/)
5 These are instructions for people or software developers who want to contribute to the latest version of Remmina on Ubuntu 14.04.
7 If you are an end user and you want to install the latest version of remmina, please use the "Remmina Team Ubuntu PPA - next branch", as explained on the [homepage of the wiki](https://github.com/FreeRDP/Remmina/wiki).
9 By following these instructions, you will get Remmina and FreeRDP compiled under the /opt/remmina_devel/ subdir, so they will not mess up your system too much. This is ideal for testing remmina.
11 You will also find the uninstall instructions at the bottom of this page.
14 * Initial write: Aug 20 2014.
15 * Update Oct 3 2014: changed branch name from gtk3 to next
16 * Update Oct 15 2014: addedd -DWITH_CUPS=on -DWITH_WAYLAND=off to freerdp parameters
17 * Update Oct 23 2014: tested on ubuntu 14.10
18 * Update Oct 29 2014: tested on Mine 17.2 (based on Ubuntu 14.04)
19 * Update Oct 29 2015: Found a load of install issued on step 1, changed recommendation from apt-get to aptitude as it reports issues far more lucidly and they all boil down to my having later versions of packages these depend on.
20 * Update Nov 23 2015: Added libsecret-1-dev to packages to be installed
21 * Update Jan 16 2016: Added libsystemd-dev
22 * Update Jan 23 2016: Added libwebkit2gtk-3.0-dev
23 * Update Mar 12 2016: Added apt-get remove of some freerdp packages installed from the PPA, removed ubuntu 14.10
24 * Update Jan 08 2018: Added libsoup2.4-dev libjson-glib-dev to dependencies
26 **1.** Install all packages required to build freerdp and remmina:
28 sudo aptitude install build-essential git-core cmake libssl-dev libx11-dev libxext-dev libxinerama-dev \
29 libxcursor-dev libxdamage-dev libxv-dev libxkbfile-dev libasound2-dev libcups2-dev libxml2 libxml2-dev \
30 libxrandr-dev libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev \
31 libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libxi-dev libavutil-dev \
32 libavcodec-dev libxtst-dev libgtk-3-dev libgcrypt11-dev libssh-dev libpulse-dev \
33 libvte-2.90-dev libxkbfile-dev libfreerdp-dev libtelepathy-glib-dev libjpeg-dev \
34 libgnutls-dev libgnome-keyring-dev libavahi-ui-gtk3-dev libvncserver-dev \
35 libappindicator3-dev intltool libsecret-1-dev libwebkit2gtk-3.0-dev \
36 libsoup2.4-dev libjson-glib-dev libpcre2-dev
38 And try also to install libsystemd-dev (available only in newer ubuntu)
40 sudo aptitude install libsystemd-dev
42 **2.** Remove freerdp-x11 package and all packages containing the string remmina in the package name.
44 sudo apt-get --purge remove freerdp-x11 \
45 remmina remmina-common remmina-plugin-rdp remmina-plugin-vnc remmina-plugin-gnome \
46 remmina-plugin-nx remmina-plugin-telepathy remmina-plugin-xdmcp
47 sudo apt-get --purge remove libfreerdp-dev libfreerdp-plugins-standard libfreerdp1
50 **3.** Create a new directory for development in your home directory, and cd into it
55 **4.** Download the latest source code of FreeRDP from its master branch
57 git clone --branch 2.0.0 https://github.com/FreeRDP/FreeRDP.git
60 **5.** Configure FreeRDP for compilation (don't forget to include -DWITH_PULSE=ON)
62 cmake -DCMAKE_BUILD_TYPE=Debug -DWITH_SSE2=ON -DWITH_CUPS=on -DWITH_WAYLAND=off -DWITH_PULSE=on -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/freerdp .
64 Please note that the above line will make FreeRDP install in /opt/remmina_devel/freerdp
66 **6.** Compile FreeRDP and install
68 make && sudo make install
70 **7.** Make your system dynamic loader aware of the new libraries you installed. For Ubuntu x64:
72 echo /opt/remmina_devel/freerdp/lib | sudo tee /etc/ld.so.conf.d/freerdp_devel.conf > /dev/null
75 For ubuntu 32 bit you have to change the path of the source lib folder in the first line.
77 **8.** Link executable in /usr/local/bin
79 sudo ln -s /opt/remmina_devel/freerdp/bin/xfreerdp /usr/local/bin/
81 **9.** Test the new freerdp by connecting to a RDP host
83 xfreerdp +clipboard /sound:rate:44100,channel:2 /v:hostname /u:username
86 **10.** Now clone remmina repository to your devel dir:
89 git clone https://github.com/FreeRDP/Remmina.git
92 **11.** Configure Remmina for compilation
95 cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/remmina -DCMAKE_PREFIX_PATH=/opt/remmina_devel/freerdp --build=build .
97 **12.** Compile remmina and install it
99 make && sudo make install
101 **13.** Link the executable
103 sudo ln -s /opt/remmina_devel/remmina/bin/remmina /usr/local/bin/
109 Please note that icons and launcher files are not installed, so don't search for remmina using Unity Dash.
111 ## Uninstall everything
112 **1.** Remove the devel directory
114 rm -rf ~/remmina_devel/
116 **2.** Remove the binary directory
118 sudo rm -rf /opt/remmina_devel/
120 **3.** Cleanup symlinks and dynamic loader
122 sudo rm /etc/ld.so.conf.d/freerdp_devel.conf /usr/local/bin/remmina /usr/local/bin/xfreerdp