diff options
37 files changed, 1955 insertions, 0 deletions
diff --git a/Compilation/Compilation-guide-for-RHEL.md b/Compilation/Compilation-guide-for-RHEL.md new file mode 100644 index 0000000..ae53ddc --- /dev/null +++ b/Compilation/Compilation-guide-for-RHEL.md @@ -0,0 +1,225 @@ +These are the instructions for people who want to test the latest version of Remmina (`master` branch) on RHEL-like operating systems. + +Current version of this guide was tested on vanilla CentOS 7 GNOME Desktop (specifically: [CentOS-7-x86_64-DVD-1908.iso](http://tux.rainside.sk/centos/7.7.1908/isos/x86_64/)), CentOS 8 Workstation (specifically: [CentOS-8.1.1911-x86_64-dvd1.iso](http://tux.rainside.sk/centos/8.1.1911/isos/x86_64/)) and Fedora 31 x86_64 (specifically: [Fedora-Workstation-Live-x86_64-31-1.9.iso](https://download.fedoraproject.org/pub/fedora/linux/releases/31/Workstation/x86_64/iso/Fedora-Workstation-Live-x86_64-31-1.9.iso)). However, it should work on all CentOS 7+, Red Hat 7+ and Fedora 20+ versions. If you find anything not working, raise an [issue](https://gitlab.com/Remmina/Remmina/issues/new). + +Note that although on CentOS 8 and Fedora, they use `dnf` package manager, there is still the `yum` symlink to `dnf`, so we decided to keep `yum` in this guide to make it usable on all of these distributions without any modifications. + +If you want to uninstall the program, follow the instructions in the step 0. + +**0.** It is important that no other Remmina or FreeRDP version is installed, therefore we need to remove it. +```bash +# To check if a program is installed, we can use `whereis [program(s)]` +whereis freerdp remmina + +# When FreeRDP is installed from the CentOS repo, use this command to remove it +sudo yum -y remove freerdp* + +# When FreeRDP is installed from source code, enter the FreeRDP source code folder +# and run the following command +cd ${HOME}/freerdp +sudo rm $(cat install_manifest.txt) + +# When Remmina is installed from the CentOS repo, use this command to remove it +sudo yum -y remove remmina* + +# When Remmina is installed from source code, enter the `build` folder +# in Remmina source code folder and run the following command +cd ${HOME}/remmina/build +sudo make uninstall + +# Finally, we need to delete the empty folders of Remmina and FreeRDP +# This needs to be run for uninstallation of either programs +sudo rmdir $(find $(whereis freerdp remmina | grep -Po "^[^:]*: \K.*$") -type d | tac) +``` + +**1.** Add necessary repos. Note that on CentOS 7 GNOME Desktop only `epel` and `rpmfusion-free-updates` are not installed by default. I presume that `base`, `extras` and `updates` repos are installed on all version of CentOS 7. +```bash +# Get some information of the currently installed distribution +# Note: This is used to determine what repositories are need to be be installed +# and to create the relevant URLs +distro_name="$(grep -Po '^ID="*\K[^"]*' /etc/os-release)" +distro_version="$(rpm -E %$distro_name)" + +if [ "$distro_name" = 'fedora' ]; then + distro_name_short='fedora' +else + distro_name_short='el' + epel_repo='epel-release' +fi + +# epel (on CentOS only): required for `openjpeg2-devel`, `openssl-devel` +# rpmfusion-free-updates (on both CentOS and Fedora): required for `ffmpeg-devel` +# PowerTools (on CentOS 8+ only) +# okay (on CentOS 8+); required for `avahi-ui-devel`, `openh264`, `libopenh264-devel`, `libx264-devel` +sudo yum -y install $epel_repo \ + https://download1.rpmfusion.org/free/${distro_name_short}/rpmfusion-free-release-${distro_version}.noarch.rpm + +if [ "$distro_name" = 'centos' ] && [ "$distro_version" = 8 ]; then + sudo dnf config-manager --enable PowerTools + sudo rpm -ivh http://repo.okay.com.mx/${distro_name}/${distro_version}/x86_64/release/okay-release-1-3.el${distro_version}.noarch.rpm + + # Disable okay repo for potential package conflicts + sudo dnf config-manager --disable okay +fi + +if [ "$distro_name" = 'fedora' ]; then + sudo dnf config-manager --enable fedora-cisco-openh264 +fi +``` + +**3.** Update `yum` cache and packages. This step might require a reboot. +```bash +sudo yum -y upgrade +``` + +**4.** Install dependencies of FreeRDP and Remmina. Note that the installation dependencies for FreeRDP and Remmina was merged. If you want to know exactly which program requires which package, see the [Dependencies](#dependencies) section at the end of this document. +```bash +sudo yum -y install alsa-lib-devel atk-devel avahi-ui-gtk3 cairo-devel cmake3 \ + cups-devel docbook-style-xsl ffmpeg-devel gcc gcc-c++ git glib2-devel gnutls-devel \ + gstreamer1-devel gstreamer1-plugins-base-devel gtk3-devel harfbuzz-devel \ + json-glib-devel libappindicator-gtk3 libappindicator-gtk3-devel libgcrypt-devel \ + libsecret-devel libSM-devel libsodium libsodium-devel libsoup-devel libssh-devel \ + libusb-devel libvncserver-devel libX11-devel libXcursor-devel libXdamage-devel \ + libXext-devel libXi-devel libXinerama-devel libxkbfile-devel libXrandr-devel libxslt \ + libxslt-devel libXtst-devel libXv-devel make ninja-build openjpeg2-devel \ + openssl-devel pango-devel pulseaudio-libs-devel vte291 vte291-devel webkitgtk4-devel \ + xmlto xorg-x11-server-utils + +# On CentOS 8 +if [ "$distro_name" = 'centos' ] && [ "$distro_version" = 8 ]; then + sudo yum -y install --enablerepo=okay avahi-ui-devel openh264 libopenh264-devel libx264-devel +fi + +# On Fedora +if [ "$distro_name" = 'fedora' ]; then + # TODO: Do we really need `libx264`? Or even `openh264` (that for CentOS too)? + sudo yum -y install avahi-ui-devel libx264 libx264-devel openh264 openh264-devel +fi +``` + +**5.** Clone FreeRDP and Remmina repos. You may want to modify the `${HOME}/{freerdp,remmina}` paths and the folder names. +```bash +git clone --branch 2.0.0 https://github.com/FreeRDP/FreeRDP.git ${HOME}/freerdp +git clone https://gitlab.com/Remmina/Remmina.git ${HOME}/remmina +``` + +**6.** Build FreeRDP. +```bash +mkdir ${HOME}/freerdp/build +cd ${HOME}/freerdp/build +# In the following line, the `DWITH_PULSE=ON` option needs to be included +# Note: `-DCMAKE_INSTALL_LIBDIR=/usr/lib64` is required when `-DCMAKE_INSTALL_PREFIX:PATH` +# is not `/usr`; otherwise Remmina will not find the `libfreerdp*` libraries +# Note: `-DWITH_OPENH264=ON -DWITH_X264=OFF` makes FreeRDP use H264 which results +# in extreme good quality for a quite good performance +cmake3 -DCMAKE_BUILD_TYPE=Debug -DWITH_SSE2=ON -DWITH_PULSE=ON -DWITH_CUPS=on -DWITH_WAYLAND=off \ + -DCMAKE_INSTALL_LIBDIR=/usr/lib64 -DCMAKE_INSTALL_PREFIX:PATH=/opt -DWITH_OPENH264=ON \ + -DWITH_X264=OFF .. +make && sudo make install + +# If you install FreeRDP and Remmina to `/opt`, you need to add `/opt/bin` to PATH +export PATH="$PATH:/opt/bin" +echo 'export PATH="$PATH:/opt/bin"' >> ${HOME}/.bashrc + +# You can test FreeRDP by connecting to an RDP host +xfreerdp +clipboard /sound:rate:44100,channel:2 /v:hostname /u:username +``` + +**7.** Make your system dynamic loader aware of the new libraries you installed +```bash +sudo ldconfig +``` + +**8.** Build Remmina. +```bash +mkdir ${HOME}/remmina/build +cd ${HOME}/remmina/build +# Note: `-DCMAKE_INSTALL_LIBDIR=/usr/lib64` is not required to successfully run Remmina, +# but `/usr/lib64` is the proper location for the libraries; again, it is not required +# at all when Remmina is installed to `/usr` +cmake3 -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX:PATH=/opt -DCMAKE_INSTALL_LIBDIR=/usr/lib64 \ + -DCMAKE_PREFIX_PATH=/opt --build=build .. +make && sudo make install +``` + +**9.** If Remmina is installed to a custom path (e.g. for use `/opt`), we need to create some symlinks in order to . + +```bash +sudo mkdir -p /usr/share/icons/hicolor/scalable/panel /usr/share/icons/hicolor/apps + +for old in /opt/share/applications/*desktop $(find /opt/share/icons -type f | grep 'svg$\|png$'); do + new="${old/opt/usr}" + sudo ln -s $old $new +done +``` + +**10.** Now you should be able to run Remmina with the following command or using the GUI. +```bash +remmina &> /dev/null & +``` + +## Notes + +### Remmina in the system tray on GNOME 3 + +Current GNOME Shell versions does not include system tray, therefore vanilla GNOME will not show the Remmina system tray icon and menu. Press <kbd>Super</kbd>+<kbd>M</kbd> to see the Remmina icon on the message bar. If you want to fix this, you could install either [KStatusNotifierItem/AppIndicator Support](https://extensions.gnome.org/extension/615/appindicator-support/). + +Below is a guide how to install the extension. For more information on installing the `chrome-gnome-shell` , see the [documentation](https://wiki.gnome.org/Projects/GnomeShellIntegrationForChrome/Installation) + +<details> + <summary><b>How to install [KStatusNotifierItem/AppIndicator Support](https://extensions.gnome.org/extension/615/appindicator-support/) extension</b></summary> + +This method installs the extension locally (i.e. for current user only). + +1. Install `chrome-gnome-shell` package. + +```bash +sudo yum -y install chrome-gnome-shell +``` + +2. Install the browser extension. Go to [GNOME extension website](https://extensions.gnome.org) and click on _Click here to install browser extension_; or you can install it from [Firefox Browser Add-ons](https://addons.mozilla.org/en-US/firefox/addon/gnome-shell-integration/). + +3. Install the [KStatusNotifierItem/AppIndicator Support](https://extensions.gnome.org/extension/615/appindicator-support/) extension by clicking on the toggle on that page (it must be on `on` position). Then confirm the installation. + +4. Don't forget to re-login the GNOME. :smiley: +</details> + +### Remmina in the system tray on Xfce + +> :information_source: This might be outdated. If you know the current state of this issue or any workaround(s), open an [issue](https://gitlab.com/Remmina/Remmina/issues/new). + +Xfce and other desktop environments without app indicator support, will not show you the system tray icon if you are executing Remmina from its compilation folder (e.g. `~/remmina`) because it contains a folder named `remmina`. For more infomation, see [Bug #1363277 on Launchpad](https://bugs.launchpad.net/libappindicator/+bug/1363277). + +### Dependencies + +1. If you are cloning the repositories, you need `git`. + +2. FreeRDP dependencies: + +```bash +# Official guide (src: https://github.com/FreeRDP/FreeRDP/wiki/Compilation [rhel based]) +gcc cmake ninja-build openssl-devel libX11-devel libXext-devel libXinerama-devel \ + libXcursor-devel libXi-devel libXdamage-devel libXv-devel libxkbfile-devel \ + alsa-lib-devel cups-devel ffmpeg-devel glib2-devel libusb-devel +# We had to install these at least on CentOS 8, but they are probably required on CentOS 7 too; +# otherwise the build failed +make gcc-c++ pulseaudio-libs-devel libXrandr-devel +# Recommended: these are required to build man pages +libxslt libxslt-devel docbook-style-xsl +# Recommended: for multimedia redirection, audio and video playback +gstreamer1-devel gstreamer1-plugins-base-devel +# Recommended: for some X11 addon +xorg-x11-server-utils +# Recommended: at build-time, FreeRDP states that this is 'required by virtual:world' +cairo-devel +``` + +3. Remmina dependencies (besides FreeRDP and its dependencies): + +```bash +atk-devel avahi-ui-devel avahi-ui-gtk3 cmake3 gnutls-devel gtk3-devel harfbuzz-devel \ + json-glib-devel libappindicator-devel libappindicator-gtk3 libappindicator-gtk3-devel \ + libgcrypt-devel libopenh264-devel libsecret-devel libSM-devel libsodium libsodium-devel \ + libsoup-devel libssh-devel libvncserver-devel libx264-devel libXtst-devel openh264 \ + openjpeg2-devel pango-devel vte291 vte291-devel webkitgtk4-devel xmlto +``` diff --git a/Compilation/Compilation.md b/Compilation/Compilation.md new file mode 100644 index 0000000..faefa76 --- /dev/null +++ b/Compilation/Compilation.md @@ -0,0 +1,12 @@ +We have tested the compilation of Remmina on several operating systems. Unfortunately, some of these guides are outdated. If you find some issues (or even better: their solutions), raise an [issue](https://gitlab.com/Remmina/Remmina/issues/new) please. :smiley: + +- [Compilation guide for Red Hat/CentOS](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compilation-guide-for-RHEL) +- [Compile on Arch Linux](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Arch-Linux) +- [Compile on Debian 10 Buster](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Debian-10-Buster) +- [Compile on Debian 9 Stretch](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Debian-9-Stretch) +- [Compile on Fedora 20 ~ 26](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Fedora-20-~-26) +- [Compile on FreeBSD](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-FreeBSD) +- [Compile on Ubuntu 14.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-14.04) +- [Compile on Ubuntu 16.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-16.04) +- [Compile on Ubuntu 18.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-18.04) +- [Compile on Ubuntu 20.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-20.04) diff --git a/Compilation/Compile-on-Arch-Linux.md b/Compilation/Compile-on-Arch-Linux.md new file mode 100644 index 0000000..3c1e5e6 --- /dev/null +++ b/Compilation/Compile-on-Arch-Linux.md @@ -0,0 +1,98 @@ +# Quick and dirty guide for compiling remmina on Arch + +These are the instructions for people who want to test the latest version of Remmina on Arch linux + +You will obtain Remmina compiled under the /opt/remmina_devel/ subdir, so it will not mess up your system too much. This is ideal for testing remmina. + +You will also find the uninstall instructions at the bottom of this page. + +You must be **root** to follow this guide. + +**1.** Update your system +``` +pacman -Syu +``` +and reboot if needed. + +Install packages needed to compile FreeRDP and Remmina: +```shell +pacman -S base-devel git libssh libvncserver gnome-keyring libgnome-keyring libpulse \ + vte3 cmake libappindicator-gtk3 docbook-utils docbook-xsl spice-gtk spice-protocol +``` +**2.** Remove installed versions of remmina and freerdp + +``` +pacman -Rs remmina freerdp +``` + +**3.** Create a new directory for development in your home directory, and cd into it +``` +mkdir ~/remmina_devel +cd ~/remmina_devel +``` + +**4.** Download the latest source code of FreeRDP from its master branch +``` +git clone --branch 2.0.0 https://github.com/FreeRDP/FreeRDP.git +cd FreeRDP +``` +**5.** Configure FreeRDP for compilation (don't forget to include -DWITH_PULSE=ON) +``` +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 . +``` +Please note that the above line will make FreeRDP install in /opt/remmina_devel/freerdp + +**6.** Compile FreeRDP and install +``` +make && make install +``` +**7.** Make your system dynamic loader aware of the new libraries you installed. For Arch x64: +``` +echo /opt/remmina_devel/freerdp/lib64 | sudo tee /etc/ld.so.conf.d/freerdp_devel.conf > /dev/null +sudo ldconfig +``` +Please note: in your system the above lib directory could be different (`/opt/remmina_devel/freerdp/` in manjaro) + +**8.** Link executable in /usr/local/bin +``` +ln -s /opt/remmina_devel/freerdp/bin/xfreerdp /usr/local/bin/ +``` +**9.** Test the new freerdp by connecting to a RDP host +``` +xfreerdp +clipboard /sound:rate:44100,channel:2 /v:hostname /u:username +``` +**10.** Now clone remmina repository, to your devel dir: +``` +cd ~/remmina_devel +git clone https://gitlab.com/Remmina/Remmina.git +``` +**11.** Configure Remmina for compilation +``` +cd Remmina +cmake -DWITH_TELEPATHY=off -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/remmina -DWITH_APPINDICATOR=off -DCMAKE_PREFIX_PATH=/opt/remmina_devel/freerdp --build=build . +``` +**12.** Compile remmina and install it +``` +make && make install +``` +**13.** Link the executable +``` +ln -s /opt/remmina_devel/remmina/bin/remmina /usr/local/bin/ +``` +**14.** Run remmina +``` +remmina +``` +NOTES for execution: +* Icons and .desktop files are not installed, so don't search for remmina in Gnome Shell. You can only launch it from a terminal or pressing ALT-F2 and typing remmina. +* Gnome Shell will never show you the system tray icon and menu. Press Super+M to see the remmina icon on the message bar. + +## Uninstall everything +**1.** Remove the devel directory +``` +rm -rf ~/remmina_devel/ +``` +**2.** Remove the binary directory and the symlink +``` +rm -rf /opt/remmina_devel/ /usr/local/bin/remmina +``` diff --git a/Compilation/Compile-on-Debian-10-Buster.md b/Compilation/Compile-on-Debian-10-Buster.md new file mode 100644 index 0000000..2a884e9 --- /dev/null +++ b/Compilation/Compile-on-Debian-10-Buster.md @@ -0,0 +1,102 @@ +# Quick and dirty guide for compiling remmina on Debian 10 + +These are instructions for people or software developers who want to contribute to the development of Remmina on Debian 10 Stretch. + +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. + +You will also find the uninstall instructions at the bottom of this page. + +You need to execute the following commands as root or as a user with sudo privileges (member of the sudo group). + +**1.** Install all packages required to build freerdp and remmina: +Execute te following commands as root +``` +sudo apt install build-essential git-core libssh-dev cmake libx11-dev libxext-dev libxinerama-dev \ + libxcursor-dev libxdamage-dev libxv-dev libxkbfile-dev libasound2-dev libcups2-dev libxml2 libxml2-dev \ + libxrandr-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \ + libxi-dev libavutil-dev libjson-glib-dev\ + libavcodec-dev libxtst-dev libgtk-3-dev libgcrypt20-dev libpulse-dev \ + libvte-2.91-dev libxkbfile-dev libtelepathy-glib-dev libjpeg-dev \ + libgnutls28-dev libsecret-1-dev libavahi-ui-gtk3-dev libvncserver-dev \ + libappindicator3-dev intltool libsecret-1-dev libwebkit2gtk-4.0-dev libsystemd-dev \ + libsodium-dev libkf5wallet-dev libusb-1.0-0-dev +``` +**2.** As root, remove freerdp-x11 package and all packages containing the string remmina in the package name. +``` + sudo apt purge "remmina*" "libfreerdp*" "libwinpr*" "freerdp*" +``` + +**3.** Create a new directory for development in your home directory, and cd into it +``` +mkdir ~/remmina_devel +cd ~/remmina_devel +``` +**4.** Download the latest source code of FreeRDP from its master branch +``` +git clone --branch 2.0.0 https://github.com/FreeRDP/FreeRDP.git +cd FreeRDP +``` +**5.** Configure FreeRDP for compilation (don't forget to include -DWITH_PULSE=ON) +``` +cmake -DCMAKE_BUILD_TYPE=Debug -DWITH_SSE2=ON -DWITH_CUPS=on -DWITH_PULSE=on -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/freerdp . +``` +Please note that the above line will make FreeRDP install in /opt/remmina_devel/freerdp + +**6.** Compile FreeRDP and install +``` +make && sudo make install +``` +**7.** Make your system dynamic loader aware of the new libraries you installed. For Ubuntu x64: +``` +echo /opt/remmina_devel/freerdp/lib | sudo tee /etc/ld.so.conf.d/freerdp_devel.conf > /dev/null +sudo ldconfig +``` + +**8.** Create a symbolik link to the executable in /usr/local/bin +``` +sudo ln -s /opt/remmina_devel/freerdp/bin/xfreerdp /usr/local/bin/ +``` +**9.** Test the new freerdp by connecting to a RDP host +``` +xfreerdp +clipboard /sound:rate:44100,channel:2 /v:hostname /u:username +``` + +**10.** Now clone remmina repository to your devel dir: +``` +cd ~/remmina_devel +git clone https://gitlab.com/Remmina/Remmina.git +``` + +**11.** Configure Remmina for compilation +``` +cd Remmina +cmake -DCMAKE_BUILD_TYPE=Debug -DWITH_KF5WALLET=on -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/remmina -DCMAKE_PREFIX_PATH=/opt/remmina_devel/freerdp --build=build . +``` +**12.** Compile remmina and install it +``` +make && sudo make install +``` +**13.** Create a symbolik link to the the executable +``` +sudo ln -s /opt/remmina_devel/remmina/bin/remmina /usr/local/bin/ +``` +**14.** Run remmina +``` +remmina +``` +Please note that icons and launcher files are not installed, so don't search for remmina using Unity Dash. + +## Uninstall everything +**1.** Remove the devel directory +``` +rm -rf ~/remmina_devel/ +``` +**2.** Remove the binary directory +``` +sudo rm -rf /opt/remmina_devel/ +``` +**3.** Cleanup symlinks and dynamic loader +``` +sudo rm /etc/ld.so.conf.d/freerdp_devel.conf /usr/local/bin/remmina /usr/local/bin/xfreerdp +sudo ldconfig +``` diff --git a/Compilation/Compile-on-Debian-9-Stretch.md b/Compilation/Compile-on-Debian-9-Stretch.md new file mode 100644 index 0000000..f20771e --- /dev/null +++ b/Compilation/Compile-on-Debian-9-Stretch.md @@ -0,0 +1,109 @@ +# Quick and dirty guide for compiling remmina on Debian 9 + +****NOTE: THIS IS NO LONGER REQUIRED, [REMMINA IS NOW AVAILABLE FROM DEBIAN BACKPORTS](https://www.remmina.org/wp/debian-the-boys-are-backport-in-town).**** + +These are instructions for people or software developers who want to contribute to the latest version of Remmina on Debian 9 Stretch. + +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. + +You will also find the uninstall instructions at the bottom of this page. + +**Changelog** +* Initial write: May 1 2017. + +You need to execute the following commands as root or as a user with sudo privileges (member of the sudo group). + +**1.** Install all packages required to build freerdp and remmina: +Execute te following commands as root +``` +sudo apt purge libssl-dev + +sudo apt install build-essential git-core libssh-dev cmake libx11-dev libxext-dev libxinerama-dev \ + libxcursor-dev libxdamage-dev libxv-dev libxkbfile-dev libasound2-dev libcups2-dev libxml2 libxml2-dev \ + libxrandr-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \ + libxi-dev libavutil-dev libjson-glib-dev\ + libavcodec-dev libxtst-dev libgtk-3-dev libgcrypt11-dev libpulse-dev \ + libvte-2.91-dev libxkbfile-dev libtelepathy-glib-dev libjpeg-dev \ + libgnutls28-dev libgnome-keyring-dev libavahi-ui-gtk3-dev libvncserver-dev \ + libappindicator3-dev intltool libsecret-1-dev libwebkit2gtk-4.0-dev libsystemd-dev \ + libsodium-dev +``` +**2.** As root, remove freerdp-x11 package and all packages containing the string remmina in the package name. +``` + sudo apt purge "remmina*" "libfreerdp*" "libwinpr*" "freerdp*" +``` + +**3.** Create a new directory for development in your home directory, and cd into it +``` +mkdir ~/remmina_devel +cd ~/remmina_devel +``` +**4.** Download the latest source code of FreeRDP from its master branch +``` +git clone --branch 2.0.0 https://github.com/FreeRDP/FreeRDP.git +cd FreeRDP +``` +**5.** Configure FreeRDP for compilation (don't forget to include -DWITH_PULSE=ON) +``` +cmake -DCMAKE_BUILD_TYPE=Debug -DWITH_SSE2=ON -DWITH_CUPS=on -DWITH_PULSE=on -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/freerdp . +``` +Please note that the above line will make FreeRDP install in /opt/remmina_devel/freerdp + +**6.** Compile FreeRDP and install +``` +make && sudo make install +``` +**7.** Make your system dynamic loader aware of the new libraries you installed. For Ubuntu x64: +``` +echo /opt/remmina_devel/freerdp/lib | sudo tee /etc/ld.so.conf.d/freerdp_devel.conf > /dev/null +sudo ldconfig +``` + +**8.** Create a symbolik link to the executable in /usr/local/bin +``` +sudo ln -s /opt/remmina_devel/freerdp/bin/xfreerdp /usr/local/bin/ +``` +**9.** Test the new freerdp by connecting to a RDP host +``` +xfreerdp +clipboard /sound:rate:44100,channel:2 /v:hostname /u:username +``` + +**10.** Now clone remmina repository to your devel dir: +``` +cd ~/remmina_devel +git clone https://gitlab.com/Remmina/Remmina.git +``` + +**11.** Configure Remmina for compilation +``` +cd Remmina +cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/remmina -DCMAKE_PREFIX_PATH=/opt/remmina_devel/freerdp --build=build . +``` +**12.** Compile remmina and install it +``` +make && sudo make install +``` +**13.** Create a symbolik link to the the executable +``` +sudo ln -s /opt/remmina_devel/remmina/bin/remmina /usr/local/bin/ +``` +**14.** Run remmina +``` +remmina +``` +Please note that icons and launcher files are not installed, so don't search for remmina using Unity Dash. + +## Uninstall everything +**1.** Remove the devel directory +``` +rm -rf ~/remmina_devel/ +``` +**2.** Remove the binary directory +``` +sudo rm -rf /opt/remmina_devel/ +``` +**3.** Cleanup symlinks and dynamic loader +``` +sudo rm /etc/ld.so.conf.d/freerdp_devel.conf /usr/local/bin/remmina /usr/local/bin/xfreerdp +sudo ldconfig +``` diff --git a/Compilation/Compile-on-FreeBSD.md b/Compilation/Compile-on-FreeBSD.md new file mode 100644 index 0000000..b747130 --- /dev/null +++ b/Compilation/Compile-on-FreeBSD.md @@ -0,0 +1,80 @@ +# Compiling Remmina on FreeBSD 11 + +In order to use Remmina, you need at least one plugin, here we explain you how to build Remmina with most plugins but mainly with FreeRDP support. + +## How to compile FreeRDP + +Follow the next procedure to compile FreerRDP + +### Install FreeRDP dependencies + +```sh +pkg install cmake gccmakedep git pkgconf libX11 libXext libXinerama libXcursor libXdamage libXv libxkbfile alsa-lib cups ffmpeg pulseaudio libssh libXi libXtst libXrandr xmlto gstreamer1 gstreamer1-plugins ffmpeg libx264 qt5-qmake qt5-buildtools +``` +### Get FreeRDP code in you development environment +**1.** Prepare your dev environment +``` +mkdir ~/remmina_devel +cd ~/remmina_devel +``` +**2.** Get the source code +``` +git clone --branch stable-2.0 https://github.com/FreeRDP/FreeRDP.git +cd FreeRDP +``` +**3.** Configure FreeRDP +``` +cmake -DCMAKE_BUILD_TYPE=Debug -DWITH_SSE2=ON -DWITH_PULSE=ON -DWITH_CUPS=on -DWITH_WAYLAND=off -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/freerdp . +``` +**4.** Compile and install + +``` +make && sudo make install +``` +**5.** Add the freerdp library path to ldconfig +Edit the file `/etc/ld-elf.so.conf`, create it if it does not exits. A add the line +``` +/opt/remmina_devel/freerdp/lib/ +``` +And then restart ldconfig with +``` +service ldconfig restart +``` +**6.** Link the xfreerdp executable + +If you use Gnome, you probably have FreeRDP installed under /usr/local. Gnome needs vinagre that needs FreeRDP, so you won't be able to remove FreeRDP, that shouldn't be an issue as we installed the git version under /opt... But keep this in mind if you'll have troubles. +If you don't have Gnome, you can link xfreerdp under /usr/local/bin +``` +sudo ln -s /opt/remmina_devel/freerdp/bin/xfreerdp /usr/local/bin/ +``` +**7.** Test xfreerdp +``` +xfreerdp +clipboard /sound:rate:44100,channel:2 /v:hostname /u:username +``` +## How to compile Remmina +**1.** Install Remmina dependencies. +``` +pkg install avahi-gtk3 gtk3 libgcrypt gnutls avahi vte3 telepathy-glib libSM openjpeg libvncserver libsodium libappindicator +``` +**2.** Install gnome keyring or similar password storage for your specific desktop +``` +pkg install gnome-keyring +``` +**3.** Clone Remmina +``` +cd ~/remmina_devel +git clone https://gitlab.com/Remmina/Remmina.git +``` +**4.** Configure compile settings +``` +cd Remmina +cmake -DCMAKE_BUILD_TYPE=Debug -DWITH_APPINDICATOR=OFF -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/remmina -DCMAKE_PREFIX_PATH=/opt/remmina_devel/freerdp --build=build . +``` +**5.** Compile remmina and install it +``` +make && make install +``` +**6.** Run Remmina +``` +/opt/remmina_devel/remmina/bin/remmina +``` diff --git a/Compilation/Compile-on-Ubuntu-14.04.md b/Compilation/Compile-on-Ubuntu-14.04.md new file mode 100644 index 0000000..8cd9671 --- /dev/null +++ b/Compilation/Compile-on-Ubuntu-14.04.md @@ -0,0 +1,124 @@ +# Quick and dirty guide for compiling remmina on ubuntu 14.04 + +### WARNING: remmina is no longer supported on ubuntu 14.04, see this [blog post](https://remmina.org/ubuntu-14-04-end-of-support/) + +These are instructions for people or software developers who want to contribute to the latest version of Remmina on Ubuntu 14.04. + +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). + +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. + +You will also find the uninstall instructions at the bottom of this page. + +**Changelog** +* Initial write: Aug 20 2014. +* Update Oct 3 2014: changed branch name from gtk3 to next +* Update Oct 15 2014: addedd -DWITH_CUPS=on -DWITH_WAYLAND=off to freerdp parameters +* Update Oct 23 2014: tested on ubuntu 14.10 +* Update Oct 29 2014: tested on Mine 17.2 (based on Ubuntu 14.04) +* 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. +* Update Nov 23 2015: Added libsecret-1-dev to packages to be installed +* Update Jan 16 2016: Added libsystemd-dev +* Update Jan 23 2016: Added libwebkit2gtk-3.0-dev +* Update Mar 12 2016: Added apt-get remove of some freerdp packages installed from the PPA, removed ubuntu 14.10 +* Update Jan 08 2018: Added libsoup2.4-dev libjson-glib-dev to dependencies + +**1.** Install all packages required to build freerdp and remmina: +``` +sudo aptitude install build-essential git-core cmake libssl-dev libx11-dev libxext-dev libxinerama-dev \ + libxcursor-dev libxdamage-dev libxv-dev libxkbfile-dev libasound2-dev libcups2-dev libxml2 libxml2-dev \ + libxrandr-dev libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev \ + libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libxi-dev libavutil-dev \ + libavcodec-dev libxtst-dev libgtk-3-dev libgcrypt11-dev libssh-dev libpulse-dev \ + libvte-2.90-dev libxkbfile-dev libfreerdp-dev libtelepathy-glib-dev libjpeg-dev \ + libgnutls-dev libgnome-keyring-dev libavahi-ui-gtk3-dev libvncserver-dev \ + libappindicator3-dev intltool libsecret-1-dev libwebkit2gtk-3.0-dev \ + libsoup2.4-dev libjson-glib-dev +``` +And try also to install libsystemd-dev (available only in newer ubuntu) +``` +sudo aptitude install libsystemd-dev +``` +**2.** Remove freerdp-x11 package and all packages containing the string remmina in the package name. +``` +sudo apt-get --purge remove freerdp-x11 \ + remmina remmina-common remmina-plugin-rdp remmina-plugin-vnc remmina-plugin-gnome \ + remmina-plugin-nx remmina-plugin-telepathy remmina-plugin-xdmcp +sudo apt-get --purge remove libfreerdp-dev libfreerdp-plugins-standard libfreerdp1 +``` + +**3.** Create a new directory for development in your home directory, and cd into it +``` +mkdir ~/remmina_devel +cd ~/remmina_devel +``` +**4.** Download the latest source code of FreeRDP from its master branch +``` +git clone --branch 2.0.0 https://github.com/FreeRDP/FreeRDP.git +cd FreeRDP +``` +**5.** Configure FreeRDP for compilation (don't forget to include -DWITH_PULSE=ON) +``` +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 . +``` +Please note that the above line will make FreeRDP install in /opt/remmina_devel/freerdp + +**6.** Compile FreeRDP and install +``` +make && sudo make install +``` +**7.** Make your system dynamic loader aware of the new libraries you installed. For Ubuntu x64: +``` +echo /opt/remmina_devel/freerdp/lib | sudo tee /etc/ld.so.conf.d/freerdp_devel.conf > /dev/null +sudo ldconfig +``` +For ubuntu 32 bit you have to change the path of the source lib folder in the first line. + +**8.** Link executable in /usr/local/bin +``` +sudo ln -s /opt/remmina_devel/freerdp/bin/xfreerdp /usr/local/bin/ +``` +**9.** Test the new freerdp by connecting to a RDP host +``` +xfreerdp +clipboard /sound:rate:44100,channel:2 /v:hostname /u:username +``` + +**10.** Now clone remmina repository to your devel dir: +``` +cd ~/remmina_devel +git clone https://github.com/FreeRDP/Remmina.git +``` + +**11.** Configure Remmina for compilation +``` +cd Remmina +cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/remmina -DCMAKE_PREFIX_PATH=/opt/remmina_devel/freerdp --build=build . +``` +**12.** Compile remmina and install it +``` +make && sudo make install +``` +**13.** Link the executable +``` +sudo ln -s /opt/remmina_devel/remmina/bin/remmina /usr/local/bin/ +``` +**14.** Run remmina +``` +remmina +``` +Please note that icons and launcher files are not installed, so don't search for remmina using Unity Dash. + +## Uninstall everything +**1.** Remove the devel directory +``` +rm -rf ~/remmina_devel/ +``` +**2.** Remove the binary directory +``` +sudo rm -rf /opt/remmina_devel/ +``` +**3.** Cleanup symlinks and dynamic loader +``` +sudo rm /etc/ld.so.conf.d/freerdp_devel.conf /usr/local/bin/remmina /usr/local/bin/xfreerdp +sudo ldconfig +``` diff --git a/Compilation/Compile-on-Ubuntu-16.04.md b/Compilation/Compile-on-Ubuntu-16.04.md new file mode 100644 index 0000000..f7d72d6 --- /dev/null +++ b/Compilation/Compile-on-Ubuntu-16.04.md @@ -0,0 +1,116 @@ +# Quick and dirty guide for compiling remmina on ubuntu 16.04 + +These are instructions for people or software developers who want to contribute to the latest version of Remmina on Ubuntu 16.04. + +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). + +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. + +You will also find the uninstall instructions at the bottom of this page. + + +**1.** Install all packages required to build freerdp and remmina: +``` +sudo apt-get install build-essential git-core cmake libssl-dev libx11-dev libxext-dev libxinerama-dev \ + libxcursor-dev libxdamage-dev libxv-dev libxkbfile-dev libasound2-dev libcups2-dev libxml2 libxml2-dev \ + libxrandr-dev libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev \ + libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libxi-dev libavutil-dev \ + libavcodec-dev libxtst-dev libgtk-3-dev libgcrypt11-dev libssh-dev libpulse-dev \ + libvte-2.91-dev libxkbfile-dev libtelepathy-glib-dev libjpeg-dev \ + libgnutls-dev libgnome-keyring-dev libavahi-ui-gtk3-dev libvncserver-dev \ + libappindicator3-dev intltool libsecret-1-dev libwebkit2gtk-4.0-dev libsystemd-dev \ + libsoup2.4-dev libjson-glib-dev libavresample-dev libusb-1.0-0-dev +``` +**2.** Remove freerdp-x11 package and all packages containing the string remmina in the package name. +``` +sudo apt-get --purge remove freerdp-x11 \ + remmina remmina-common remmina-plugin-rdp remmina-plugin-vnc remmina-plugin-gnome \ + remmina-plugin-nx remmina-plugin-telepathy remmina-plugin-xdmcp +sudo apt-get --purge remove libfreerdp-dev libfreerdp-plugins-standard libfreerdp1 \ + libfreerdp-utils1.1 libfreerdp-primitives1.1 libfreerdp-locale1.1 \ + libfreerdp-gdi1.1 libfreerdp-crypto1.1 libfreerdp-core1.1 libfreerdp-common1.1.0 \ + libfreerdp-codec1.1 libfreerdp-client1.1 libfreerdp-cache1.1 +sudo apt-get --purge remove \ + libfreerdp-rail1.1 libwinpr-asn1-0.1 libwinpr-bcrypt0.1 libwinpr-credentials0.1 libwinpr-credui0.1 \ + libwinpr-crt0.1 libwinpr-crypto0.1 libwinpr-dev libwinpr-dsparse0.1 libwinpr-environment0.1 \ + libwinpr-error0.1 libwinpr-file0.1 libwinpr-handle0.1 libwinpr-heap0.1 libwinpr-input0.1 \ + libwinpr-interlocked0.1 libwinpr-io0.1 libwinpr-library0.1 libwinpr-path0.1 libwinpr-pipe0.1 \ + libwinpr-pool0.1 libwinpr-registry0.1 libwinpr-rpc0.1 libwinpr-sspi0.1 libwinpr-sspicli0.1 \ + libwinpr-synch0.1 libwinpr-sysinfo0.1 libwinpr-thread0.1 libwinpr-timezone0.1 libwinpr-utils0.1 \ + libwinpr-winhttp0.1 libwinpr-winsock0.1 freerdp2-x11 "libfreerdp2*" "libwinpr2*" +``` + +**3.** Create a new directory for development in your home directory, and cd into it +``` +mkdir ~/remmina_devel +cd ~/remmina_devel +``` +**4.** Download the latest source code of FreeRDP from its master branch +``` +git clone --branch 2.0.0 https://github.com/FreeRDP/FreeRDP.git +cd FreeRDP +``` +**5.** Configure FreeRDP for compilation (don't forget to include -DWITH_PULSE=ON) +``` +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 . +``` +Please note that the above line will make FreeRDP install in /opt/remmina_devel/freerdp + +**6.** Compile FreeRDP and install +``` +make && sudo make install +``` +**7.** Make your system dynamic loader aware of the new libraries you installed. For Ubuntu x64: +``` +echo /opt/remmina_devel/freerdp/lib | sudo tee /etc/ld.so.conf.d/freerdp_devel.conf > /dev/null +sudo ldconfig +``` + +**8.** Create a symbolik link to the executable in /usr/local/bin +``` +sudo ln -s /opt/remmina_devel/freerdp/bin/xfreerdp /usr/local/bin/ +``` +**9.** Test the new freerdp by connecting to a RDP host +``` +xfreerdp +clipboard /sound:rate:44100,channel:2 /v:hostname /u:username +``` + +**10.** Now clone remmina repository to your devel dir: +``` +cd ~/remmina_devel +git clone https://gitlab.com/Remmina/Remmina.git +``` + +**11.** Configure Remmina for compilation +``` +cd Remmina +cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/remmina -DCMAKE_PREFIX_PATH=/opt/remmina_devel/freerdp --build=build . +``` +**12.** Compile remmina and install it +``` +make && sudo make install +``` +**13.** Create a symbolik link to the the executable +``` +sudo ln -s /opt/remmina_devel/remmina/bin/remmina /usr/local/bin/ +``` +**14.** Run remmina +``` +remmina +``` +Please note that icons and launcher files are not installed, so don't search for remmina using Unity Dash. + +## Uninstall everything +**1.** Remove the devel directory +``` +rm -rf ~/remmina_devel/ +``` +**2.** Remove the binary directory +``` +sudo rm -rf /opt/remmina_devel/ +``` +**3.** Cleanup symlinks and dynamic loader +``` +sudo rm /etc/ld.so.conf.d/freerdp_devel.conf /usr/local/bin/remmina /usr/local/bin/xfreerdp +sudo ldconfig +``` diff --git a/Compilation/Compile-on-Ubuntu-18.04.md b/Compilation/Compile-on-Ubuntu-18.04.md new file mode 100644 index 0000000..ba02a5e --- /dev/null +++ b/Compilation/Compile-on-Ubuntu-18.04.md @@ -0,0 +1,102 @@ +# Quick and dirty guide for compiling remmina on ubuntu 18.04 + +These are instructions for people or software developers who want to contribute to the latest version of Remmina on Ubuntu 18.04. + +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://gitlab.com/Remmina/Remmina/wikis/home). + +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. + +You will also find the uninstall instructions at the bottom of this page. + +**1.** Install all packages required to build freerdp and remmina: +``` +sudo apt install build-essential git-core cmake libssl-dev libx11-dev libxext-dev libxinerama-dev \ + libxcursor-dev libxdamage-dev libxv-dev libxkbfile-dev libasound2-dev libcups2-dev libxml2 libxml2-dev \ + libxrandr-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \ + libxi-dev libavutil-dev \ + libavcodec-dev libxtst-dev libgtk-3-dev libgcrypt11-dev libssh-dev libpulse-dev \ + libvte-2.91-dev libxkbfile-dev libtelepathy-glib-dev libjpeg-dev \ + libgnutls28-dev libgnome-keyring-dev libavahi-ui-gtk3-dev libvncserver-dev \ + libappindicator3-dev intltool libsecret-1-dev libwebkit2gtk-4.0-dev libsystemd-dev \ + libsoup2.4-dev libjson-glib-dev libavresample-dev libsodium-dev \ + libusb-1.0-0-dev +``` +**2.** Remove freerdp-x11 package and all packages containing the string remmina in the package name. +``` +sudo apt purge "remmina*" "libfreerdp*" "libwinpr*" "freerdp*" +``` + +**3.** Create a new directory for development in your home directory, and cd into it +``` +mkdir ~/remmina_devel +cd ~/remmina_devel +``` +**4.** Download the latest source code of FreeRDP from its master branch +``` +git clone --branch stable-2.0 https://github.com/FreeRDP/FreeRDP.git +cd FreeRDP +``` +**5.** Configure FreeRDP for compilation (don't forget to include -DWITH_PULSE=ON) +``` +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 . +``` +Please note that the above line will make FreeRDP install in /opt/remmina_devel/freerdp + +**6.** Compile FreeRDP and install +``` +make && sudo make install +``` +**7.** Make your system dynamic loader aware of the new libraries you installed. For Ubuntu x64: +``` +echo /opt/remmina_devel/freerdp/lib | sudo tee /etc/ld.so.conf.d/freerdp_devel.conf > /dev/null +sudo ldconfig +``` + +**8.** Create a symbolik link to the executable in /usr/local/bin +``` +sudo ln -s /opt/remmina_devel/freerdp/bin/xfreerdp /usr/local/bin/ +``` +**9.** Test the new freerdp by connecting to a RDP host +``` +xfreerdp +clipboard /sound:rate:44100,channel:2 /v:hostname /u:username +``` + +**10.** Now clone remmina repository to your devel dir: +``` +cd ~/remmina_devel +git clone https://gitlab.com/Remmina/Remmina.git +``` + +**11.** Configure Remmina for compilation +``` +cd Remmina +cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/remmina -DCMAKE_PREFIX_PATH=/opt/remmina_devel/freerdp --build=build . +``` +**12.** Compile remmina and install it +``` +make && sudo make install +``` +**13.** Create a symbolik link to the the executable +``` +sudo ln -s /opt/remmina_devel/remmina/bin/remmina /usr/local/bin/ +``` +**14.** Run remmina +``` +remmina +``` +Please note that icons and launcher files are not installed, so don't search for remmina using Unity Dash. + +## Uninstall everything +**1.** Remove the devel directory +``` +rm -rf ~/remmina_devel/ +``` +**2.** Remove the binary directory +``` +sudo rm -rf /opt/remmina_devel/ +``` +**3.** Cleanup symlinks and dynamic loader +``` +sudo rm /etc/ld.so.conf.d/freerdp_devel.conf /usr/local/bin/remmina /usr/local/bin/xfreerdp +sudo ldconfig +``` diff --git a/Compilation/Compile-on-Ubuntu-20.04.md b/Compilation/Compile-on-Ubuntu-20.04.md new file mode 100644 index 0000000..d897b7b --- /dev/null +++ b/Compilation/Compile-on-Ubuntu-20.04.md @@ -0,0 +1,132 @@ +# Quick and dirty guide for compiling remmina on ubuntu 20.04 + +These are instructions for people or software developers who want to contribute to the latest version of Remmina on Ubuntu 20.04. + +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://gitlab.com/Remmina/Remmina/wikis/home). + +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. + +You will also find the uninstall instructions at the bottom of this page. + +**1.** Install all packages required to build freerdp and remmina: + +```shell +sudo apt install build-essential git-core cmake libssl-dev libx11-dev libxext-dev libxinerama-dev \ + libxcursor-dev libxdamage-dev libxv-dev libxkbfile-dev libasound2-dev libcups2-dev libxml2 libxml2-dev \ + libxrandr-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \ + libxi-dev libavutil-dev \ + libavcodec-dev libxtst-dev libgtk-3-dev libgcrypt20-dev libssh-dev libpulse-dev \ + libvte-2.91-dev libxkbfile-dev libtelepathy-glib-dev libjpeg-dev \ + libgnutls28-dev libavahi-ui-gtk3-dev libvncserver-dev \ + libappindicator3-dev intltool libsecret-1-dev libwebkit2gtk-4.0-dev libsystemd-dev \ + libsoup2.4-dev libjson-glib-dev libavresample-dev libsodium-dev \ + libusb-1.0-0-dev +``` + +**2.** Remove freerdp-x11 package and all packages containing the string remmina in the package name. + +```shell +sudo apt purge "?name(^remmina.*)" "?name(^libfreerdp.*)" "?name(^freerdp.*)" "?name(^libwinpr.*)" +``` + +**3.** Create a new directory for development in your home directory, and cd into it + +```shell +mkdir ~/remmina_devel +cd ~/remmina_devel +``` + +**4.** Download the latest source code of FreeRDP from its master branch + +```shell +git clone --branch stable-2.0 https://github.com/FreeRDP/FreeRDP.git +cd FreeRDP +``` + +**5.** Configure FreeRDP for compilation (don't forget to include -DWITH_PULSE=ON) + +```shell +cmake -DCMAKE_BUILD_TYPE=Debug -DWITH_SSE2=ON -DWITH_CUPS=on -DWITH_PULSE=on -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/freerdp . +``` + +Please note that the above line will make FreeRDP install in /opt/remmina_devel/freerdp + +**6.** Compile FreeRDP and install + +```shell +make && sudo make install +``` + +**7.** Make your system dynamic loader aware of the new libraries you installed. For Ubuntu x64: + +```shell +echo /opt/remmina_devel/freerdp/lib | sudo tee /etc/ld.so.conf.d/freerdp_devel.conf > /dev/null +sudo ldconfig +``` + +**8.** Create a symbolik link to the executable in /usr/local/bin + +```shell +sudo ln -s /opt/remmina_devel/freerdp/bin/xfreerdp /usr/local/bin/ +``` + +**9.** Test the new freerdp by connecting to a RDP host + +```shell +xfreerdp +clipboard /sound:rate:44100,channel:2 /v:hostname /u:username +``` + +**10.** Now clone remmina repository to your devel dir: + +```shell +cd ~/remmina_devel +git clone https://gitlab.com/Remmina/Remmina.git +``` + +**11.** Configure Remmina for compilation + +```shell +cd Remmina +cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX:PATH=/opt/remmina_devel/remmina -DCMAKE_PREFIX_PATH=/opt/remmina_devel/freerdp --build=build . +``` + +**12.** Compile remmina and install it + +```shell +make && sudo make install +``` + +**13.** Create a symbolik link to the the executable + +```shell +sudo ln -s /opt/remmina_devel/remmina/bin/remmina /usr/local/bin/ +``` + +**14.** Run remmina + +```shell +remmina +``` + +Please note that icons and launcher files are not installed, so don't search for remmina using Unity Dash. + +## Uninstall everything + +**1.** Remove the devel directory + +```shell +rm -rf ~/remmina_devel/ +``` + +**2.** Remove the binary directory + +```shell +sudo rm -rf /opt/remmina_devel/ +``` + +**3.** Cleanup symlinks and dynamic loader + +```shell +sudo rm /etc/ld.so.conf.d/freerdp_devel.conf /usr/local/bin/remmina /usr/local/bin/xfreerdp +sudo ldconfig +``` diff --git a/Contribution.md b/Contribution.md new file mode 100644 index 0000000..cc9a8cf --- /dev/null +++ b/Contribution.md @@ -0,0 +1,2 @@ +- [Contribute to the Remmina documentation](https://gitlab.com/Remmina/Remmina/-/wikis/Contribution/Contribute-to-the-Remmina-documentation) +- [HOWTO generate the changelog](https://gitlab.com/Remmina/Remmina/-/wikis/Contribution/HOWTO-generate-the-changelog)
\ No newline at end of file diff --git a/Contribution/Contribute-to-the-Remmina-documentation.md b/Contribution/Contribute-to-the-Remmina-documentation.md new file mode 100644 index 0000000..b6262e7 --- /dev/null +++ b/Contribution/Contribute-to-the-Remmina-documentation.md @@ -0,0 +1,27 @@ +Remmina lacks good usage and development documentation. + +## Usage documentation + +In the future we would like to have an offline user manual generated out of the wiki, therefore it's important to get a useful and updated wiki ASAP. + +Contribute to the wiki you either editing an existing page, or creating new ones. + +To create a new page, click [New page](https://gitlab.com/Remmina/Remmina/-/wikis/new), in the title specify the relative path of the page you want to create. + +For instance, if you want to create a page on "How to share your local printers" under the Usage section, you will set the title as `Usage/How-to-share-your-local-printers`. + +When you are done, update the sidebar links https://gitlab.com/Remmina/Remmina/-/wikis/_sidebar and the section page (e.g. https://gitlab.com/Remmina/Remmina/-/wikis/Usage). + +That's all! + +If you prefer to work from a terminal, the wiki can be [cloned](https://gitlab.com/Remmina/Remmina/-/wikis/git_access) + +## Developer documentation + +We try to document the code as much as we can, but often lack the time and/or some quick-fixes would require documenting a large amount of code. + +If you are writing new code, try to document it. If you are not a developer, but would like to learn, documenting the code is hard, but an extremely effective way to learn. + +We use [Doxygen](https://www.doxygen.nl/index.html), the documented code is automatically deployed on https://remmina.gitlab.io/remminadoc.gitlab.io/ , a good example, if you don't have Doxygen experience is https://gitlab.com/Remmina/Remmina/-/blob/master/src/remmina_stats.c, that renders as https://remmina.gitlab.io/remminadoc.gitlab.io/remmina__stats_8c.html + +Don't be afraid and/or lazy and ask for help in our IRC channel if you have troubles.
\ No newline at end of file diff --git a/Contribution/HOWTO-generate-the-changelog.md b/Contribution/HOWTO-generate-the-changelog.md new file mode 100644 index 0000000..08584b2 --- /dev/null +++ b/Contribution/HOWTO-generate-the-changelog.md @@ -0,0 +1,24 @@ +# Requirements + +## [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator) + +You can install using gem + +```sh +gem install github_changelog_generator +``` + +If you want to contribute back to the project you can clone the repository and build it. + +## [GitHub token](https://github.com/skywinder/github-changelog-generator/blob/master/README.md#github-token) + +You need the token because github doesn't accept more than 50 request per day with it's API. +It's for free... + +# Generate the CHANGELOG.md + +github_changelog_generator -t 689c2dd09acaebf4ce92fecaeed2ec8140b6bfbf + +# Commit the new CHANGELOG.md + +The CHANGELOG.md should be committed only after a new release.
\ No newline at end of file diff --git a/Development/Development-Notes.md b/Development/Development-Notes.md new file mode 100644 index 0000000..e4677df --- /dev/null +++ b/Development/Development-Notes.md @@ -0,0 +1,18 @@ +Use this page to add useful links and notes to help out with the development + +# Remmina generated documentation + +https://daguniverse.github.io/RemminaDoc/index.html + +# GTK3 + +## GTK3 Deprecation mini guide + +* [GTK3 Reference Manual](https://developer.gnome.org/gtk3/unstable/index.html) +* [Icon names standard](http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html#names) +* [GTK Stock Item Deprecation](https://docs.google.com/document/d/1KCVPoYQBqMbDP11tHPpjW6uaEHrvLUmcDPqKAppCY8o/pub) +* [Stock Items Migration Guide](https://docs.google.com/spreadsheet/pub?key=0AsPAM3pPwxagdGF4THNMMUpjUW5xMXZfdUNzMXhEa2c&output=html) +* Menu and GtkActionGroup deprecation: [what to use instead](http://stackoverflow.com/questions/24788045/gtk-action-group-new-and-gtkstock-what-to-use-instead) +* _"GtkAlignment has been deprecated in 3.14 and should not be used in newly-written code. The desired effect can be achieved by using the “halign”, “valign” and “margin” properties on the child widget."_ In Remmina GtkAlignment has been replaced by a GtkAspectFrame, used by the "scaler" code to scale the remote desktop. +* Icons in menu are being removed. See [here](https://igurublog.wordpress.com/2014/03/22/gtk-3-10-drops-menu-icons-and-mnemonics/). Also mnemonics should be removed. + diff --git a/Development/multi-monitor-support.md b/Development/multi-monitor-support.md new file mode 100644 index 0000000..90f8425 --- /dev/null +++ b/Development/multi-monitor-support.md @@ -0,0 +1,45 @@ +# Multi monitor support + +See also #6 and #323 + +## Windows server support + +- Only in full scren + +### WINDOWS 2003 till WINDOWS 2008 (XP, Vista) + +- Only using span. One big bitmap for all monitors +- Going out of fullscreen we still have a huge bitmap as the server cannot be reconfigured. +- Removing a montor is not possible, we will have a window with the huge bitmap. +- As conswquence we can go back to fullscreen with any impact. + +### WINDOWS 2008R2, WINDOWS 2012 (Win7, Win8) + +- First basic, real multi monitor support, the server is aware of each monitor and places the windows correctly. +- Yet, it doesn't support the configuration change awareness. +- Same behaviors as above. + +### WINDOWS 2012R2, WINDOWS 2016 (Win 8.1, Win 10) and forward + +"Display Control Virtual Channel Extension" has been implemented, https://msdn.microsoft.com/en-us/library/dn366738.aspx + +Every time we add qand remove a monitor, the remote server adapt its configuration. + +## FreeRDP + +- FreeRDP/client/common/client.c + +```c +/* Moved logic for Multimon and Span monitors to force fullscreen, so + * that the rdp file also triggers this functionality */ +if (settings->SpanMonitors) +{ + settings->UseMultimon = TRUE; + settings->Fullscreen = TRUE; +} +else if (settings->UseMultimon) +{ + settings->Fullscreen = TRUE; +} +``` + @@ -0,0 +1,225 @@ +## *Welcome to the Remmina wiki* + +Remmina is developed on [GitLab](https://gitlab.com/Remmina/Remmina), as of the 20th of June 2018. + +Use these [wiki](https://gitlab.com/Remmina/Remmina/wikis/home) and [issues](https://gitlab.com/Remmina/Remmina/issues) links instead of GitHub equivalents. + +--- + +Usually Remmina is [included in your distribution](https://repology.org/project/remmina/versions), or in an external repository you can add. + +[](https://repology.org/project/remmina/versions) + +## [Flatpak](https://flathub.org/) + +This is a system agnostic package that works on just about every distribution. + +```shell +flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo +# In order to have H.264 codecs +flatpak install org.freedesktop.Platform +flatpak install org.freedesktop.Platform.openh264 +flatpak install --user flathub org.remmina.Remmina +flatpak run --user org.remmina.Remmina +``` + +If you use SSH agent (https://github.com/flatpak/flatpak/issues/1438 ) + +```shell +flatpak run --filesystem=$SSH_AUTH_SOCK --env=SSH_AUTH_SOCK=$SSH_AUTH_SOCK org.remmina.Remmina +``` + +Flatpak stores data for installed applications (the XDG config/data folders) under `$HOME/.var` +If you have previously installed Remmina with another package manager, you will have to transfer what was under `$HOME/.config/remmina` and `$HOME/.local/share/remmina` under, respectively `~/.var/app/org.remmina.Remmina/config/remmina` and `~/.var/app/org.remmina.Remmina/data/remmina` + +## [Snap](https://snapcraft.io/) + +This also is a system agnostic package that works on many distributions, but mainly Ubuntu. + +If you run into issues, try something else first, and then [report the issues](https://github.com/FreeRDP/Remmina/issues). +Our Snap package does not work on Ubuntu 17.10 if you use Wayland, see [issue #1414](https://github.com/FreeRDP/Remmina/issues/1414)._ + +First make sure you have `snapd` installed. Then install the last release from the Ubuntu Software Center by looking for `Remmina`, or install it from a terminal with: + +```shell +sudo snap install remmina +``` + +The Snap subsystem has limitations, so some features, for example password storage via keyring is missing and *must* be fixed manually: + +```shell +sudo snap connect remmina:avahi-observe :avahi-observe # servers discovery +sudo snap connect remmina:cups-control :cups-control # printing +sudo snap connect remmina:mount-observe :mount-observe # mount management +sudo snap connect remmina:password-manager-service :password-manager-service # password manager +``` + +Some features just don't work on Snap, for example accessing your personal ~/.ssh directory is not possible. +You have to manually copy your ~/.ssh/* files to ~/snap/remmina/common/.ssh/ + +If you want to install the latest Git revision of Remmina as Snap, get it from the `edge` channel: + +```shell +sudo snap install remmina --edge +``` + +**Or**, update your Remmina Snap install with your channel of choice: + +```shell +sudo snap refresh remmina --channel=edge # use --channel=stable otherwise +``` + +Snaps are updated with the system and include both latest `FreeRDP` Git and the latest `libssh 0.7` release (for better security). + +## [Ubuntu](https://ubuntu.com/) and [Linux Mint](https://linuxmint.com/) + +**Remmina will no longer be available as a PPA package after the release of version 1.4.8.** + +An official PPA with Remmina 1.4.7 release can be installed by copying and pasting this in a terminal: + +``` +sudo apt-add-repository ppa:remmina-ppa-team/remmina-next +sudo apt update +sudo apt install remmina remmina-plugin-rdp remmina-plugin-secret +``` + +Make sure Remmina is not running. Either close it, reboot, or kill it by pasting this in a terminal: + +``` +sudo killall remmina +``` + +List available plugins with `apt-cache search remmina-plugin`. By default RDP, SSH and SFTP are installed. +To test a daily built development version, do the above, but start with + +``` +ppa:remmina-ppa-team/remmina-next-daily +``` + +## [Debian](https://www.debian.org/) + +### 10 [Buster](https://wiki.debian.org/DebianBuster) (stable), [Bullseye](https://wiki.debian.org/DebianBullseye) (testing), and [Sid](https://wiki.debian.org/DebianUnstable) (unstable) + +Remmina is in the official stable, testing and unstable repositories. + +### 9 [Stretch](https://wiki.debian.org/DebianStretch) (oldstable) + +Here Remmina can be [installed from backports](https://www.remmina.org/debian-the-boys-are-backport-in-town/) by copying and pasting this in a terminal: +``` +echo 'deb http://ftp.debian.org/debian stretch-backports main' | sudo tee --append /etc/apt/sources.list.d/stretch-backports.list >> /dev/null +sudo apt update +sudo apt install -t stretch-backports remmina remmina-plugin-rdp remmina-plugin-secret remmina-plugin-spice +``` + +## [Raspberry Pi](https://www.raspberrypi.org/) + +**ATTENTION**: We do not (or rarely) update this repository anymore. Maintainers are welcome if any. + +Remmina operates its own package repository for Raspbian Buster (10.x) you can install by copying and pasting this in a terminal: + +``` +sudo apt install dirmngr +sudo apt-key adv --fetch-keys https://www.remmina.org/raspbian/remmina_raspbian.asc +sudo bash -c 'echo "deb https://www.remmina.org/raspbian/ buster main" > /etc/apt/sources.list.d/remmina_raspbian.list' +sudo apt update +sudo apt install remmina +``` + +(Tested on RPi 3B and 3B+) +It is strongly advised to also install gnome-keyring to let Remmina save encrypted passwords in a safer place than .remmina textfiles in the /home user folder. + +``` +sudo apt install gnome-keyring +``` + +(The remmina-next PPA can be used on Raspberry Pi 2 and 3, provided you are running one of the supported *buntu derivatives.) + +## [Fedora](https://getfedora.org/) and [Red Hat](https://www.redhat.com) + +As of March 2018 Remmina is available on most Fedora testing and stable, we still have a (not updated) Copr provided by [Hubbitus](https://github.com/Hubbitus) (Pavel Alexeev), to install, paste this in a terminal as root: + +```shell +dnf copr enable hubbitus/remmina-next +dnf upgrade --refresh 'remmina*' 'freerdp*' +``` + +## [Red Hat/CentOS](https://www.redhat.com) + +Install Remmina from the EPEL repository by pasting this in a terminal: + +```shell +wget http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm +rpm -ivh epel-release-latest-7.noarch.rpm +``` + +A more updated version is available thanks to @castorsky through a [COPR repo](https://copr.fedorainfracloud.org/coprs/castor/remmina/) + +To install Remmina on RHEL/CentOS 8 enable EPEL and COPR repo then install package with following commands: + +```shell +dnf install epel-release +dnf copr enable castor/remmina +dnf install 'remmina*' +``` + +## [Gentoo](https://www.gentoo.org/) + +To build and install + +```shell +emerge -av net-misc/remmina +``` + +To build a binary and install + +```shell +emerge -avb net-misc/remmina +``` + +```shell +emerge -avk remmina*.tar.bz +# From cp /usr/portage/packages/net-misc remmina* > /mnt/some-usb-stick to multiple boxes +emerge -avk =net-misc/remmina-#??Version number +``` + +## [Sabayon](https://www.sabayon.org/) + +``` +equo -i net-misc/remmina + ``` + +## [Arch Linux](https://www.archlinux.org/) (and friends) + +There is an official Arch Linux Remmina package. **Or**, if you want to use the AUR, install [remmina-git](https://aur.archlinux.org/packages/remmina-git). +There are also some external, not supported plugins provided by [Muflone](https://github.com/muflone) and other +Arch Remmina [Protocol plugins](https://aur.archlinux.org/packages/?O=0&SeB=nd&K=Remmina&outdated=&SB=n&SO=a&PP=50&do_Search=Go) + +## [Solus](https://getsol.us/home/) + +```shell +sudo eopkg update-repo +sudo eopkg install remmina +``` + +## [Build from source](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compilation) + +- [Compilation guide for Red Hat/CentOS](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compilation-guide-for-RHEL) +- [Compile on Arch Linux](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Arch-Linux) +- [Compile on Debian 10 Buster](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Debian-10-Buster) +- [Compile on Debian 9 Stretch](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Debian-9-Stretch) +- [Compile on Fedora 20 ~ 26](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Fedora-20-~-26) +- [Compile on FreeBSD](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-FreeBSD) +- [Compile on Ubuntu 14.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-14.04) +- [Compile on Ubuntu 16.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-16.04) +- [Compile on Ubuntu 18.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-18.04) +- [Compile on Ubuntu 20.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-20.04) + +Code development and bugfixes take place on the master branch. +It compiles with the current FreeRDP master branch, and will compile with [FreeDRP](http://www.freerdp.com/) 2.0 when released as stable. + +# Links + +- [Remmina website](https://www.remmina.org/) +- [Remmina subreddit](https://reddit.com/r/Remmina) +- [Remmina Development Doc](https://remmina.gitlab.io/remminadoc.gitlab.io) +- [Versions for various operating systems](https://repology.org/project/remmina/versions) diff --git a/Localisation/How-to-translate-Remmina.md b/Localisation/How-to-translate-Remmina.md new file mode 100644 index 0000000..5628a9a --- /dev/null +++ b/Localisation/How-to-translate-Remmina.md @@ -0,0 +1,29 @@ +Please follow the [CONTRIBUTING guide](https://gitlab.com/Remmina/Remmina/blob/master/CONTRIBUTING.md) for general info on how to contribute to Remmina. + +Remmina uses xgettext to generate the translated strings, you don't necessarily need to have a good understanding of it but in the case you need an high level overview check [this](https://www.gutenberg.org/wiki/Gutenberg:GNU_Gettext_Translation_How-To) + +# Using Weblate + +[](https://hosted.weblate.org/engage/remmina/?utm_source=widget) + +- [Translate](https://hosted.weblate.org/projects/remmina/) +- [View project languages](https://hosted.weblate.org/projects/remmina/#languages) + +# Using Git and and a text or PO Editor + + +## To add a new language + +Download the [remmina.pot](https://gitlab.com/Remmina/Remmina/blob/master/po/remmina.pot) and using a PO editor (Poedit, Gtranslator, …) create the PO file of your language. + +When you are done send it to l10n@lists.remmina.org , alternatively you can fork the Remmina repository and submit a merge request. + +## To update an existing translation. + +All the existing po files are under https://gitlab.com/Remmina/Remmina/blob/master/po + +Grab the one you want to update and use a PO editor to update it, than you can either send to us at l10n@lists.remmina.org, either submit a merge request. + +## Translations status + +[](https://hosted.weblate.org/engage/remmina/?utm_source=widget) diff --git a/Localisation/Update-gettext-messages.md b/Localisation/Update-gettext-messages.md new file mode 100644 index 0000000..420cf5a --- /dev/null +++ b/Localisation/Update-gettext-messages.md @@ -0,0 +1,31 @@ +This is a quick, dirty and no brainy procedure to update the PO files in Remmina. + +Please wait 10 seconds before copying and pasting it in the terminal. + +```bash +REMMINATOP=~/remmina_devel/Remmina +cd $REMMINATOP +find src plugins -name "*.c" | sed 's/^.\///' >| po/POTFILES.in +find data -name "*.glade" | sed 's/^.\///' >> po/POTFILES.in +find data -name "*.appdata.xml" | sed 's/^.\///' >> po/POTFILES.in +xgettext --from-code=UTF-8 -k_ -kN_ -ktranslatable --keyword=C_:1c,2 --keyword=NC_:1c,2 --keyword=g_dngettext:2,3 --add-comments --files-from=po/POTFILES.in --output=po/messages.pot --copyright-holder="2014–2020 Weblate translators" --package-name="Remmina" --package-version="1.2.31" --msgid-bugs-address="admin@remmina.org" +cd $REMMINATOP/po +for i in *.po; do +msgmerge -N --backup=off --update $i messages.pot +done +for i in $REMMINATOP/po/*.po ; do +TMPF=/tmp/f$$.txt +sed '/^#~/d' $i > $TMPF +awk 'BEGIN{bl=0}/^$/{bl++;if(bl==1)print;else next}/^..*$/{bl=0;print}' $TMPF >| $i +rm $TMPF +done +rm *.po~ +rm messages.pot + +``` + +To test Remmina in another language, you can start it from the commandline this way: + +```bash +LANGUAGE=ru remmina +``` diff --git a/Problems-and-tweaks.md b/Problems-and-tweaks.md new file mode 100644 index 0000000..7544260 --- /dev/null +++ b/Problems-and-tweaks.md @@ -0,0 +1,9 @@ +- [Black screen](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/Black-screen) +- [GTK versions on various distributions](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/GTK-versions-on-various-distributions) +- [Problems with Wayland](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/Problems-with-Wayland) +- [Remmina RDP and HiDPI scaling](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/Remmina-RDP-and-HiDPI-scaling) +- [Remmina VNC to Raspbian Stretch](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/Remmina-VNC-to-Raspbian-Stretch) +- [Squares insead of text](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/Squares-instead-of-text) +- [Systray menu](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/Systray-menu) +- [VNC key mapping configuration](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/vnc-key-mapping-configuration) +- [View and export passwords](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/View-and-export-passwords)
\ No newline at end of file diff --git a/Problems-and-tweaks/Black-screen.md b/Problems-and-tweaks/Black-screen.md new file mode 100644 index 0000000..cd9f005 --- /dev/null +++ b/Problems-and-tweaks/Black-screen.md @@ -0,0 +1,5 @@ +If you have a black screen when connecting to a remote Windows server and you have a recent version of Remmina (>v1.4.8), unset or change the microphone redirection option. + + + +Looks like in some border cases that string is set to 0 or other wrong values.
\ No newline at end of file diff --git a/Problems-and-tweaks/GTK-versions-on-various-distributions.md b/Problems-and-tweaks/GTK-versions-on-various-distributions.md new file mode 100644 index 0000000..b914ff9 --- /dev/null +++ b/Problems-and-tweaks/GTK-versions-on-various-distributions.md @@ -0,0 +1,70 @@ +Distribution|GTK+3 version|libssh version|libvncserver version| +---|---:|---:|---: +Debian 7 Wheezy|[3.4.2][gtk-wheezy]|[0.5.4][ssh-wheezy]|[0.9.9][vnc-wheezy] +Debian 8 Jessie|[3.14.5][gtk-jessie]|[0.6.3][ssh-jessie]|[0.9.9][vnc-jessie] +Debian 9 Stretch (current Raspbian)|[3.22.11][gtk-stretch]|[0.7.3][ssh-stretch]|[0.9.11][vnc-stretch] +Debian Sid|[3.22.30][gtk-sid]|[0.8.0][ssh-sid]|[0.9.11][vnc-sid] +CentOS 7/RHEL 7|[3.8][gtk-centos]|[0.6.4][ssh-centos]|[0.9.9][vnc-centos] +Fedora 26|[3.22.16][gtk-fedora]|[0.7.5][ssh-fedora]|[0.9.11][vnc-fedora] +Fedora 27|[3.22.24][gtk-fedora]|[0.7.5][ssh-fedora]|[0.9.11][vnc-fedora] +Fedora 28|[3.22.30][gtk-fedora]|[0.7.5][ssh-fedora]|[0.9.11][vnc-fedora] +Ubuntu 10.04 LTS (Lucid Lynx)|-|[0.4.2][ssh-lucid]|[0.9.7][vnc-lucid] +Ubuntu 12.04 LTS (Precise Pangolin)|[3.4.2][gtk-precise]|[0.5.2][ssh-precise]|[0.9.8.2][vnc-precise] +Ubuntu 14.04 LTS (Trusty Tahr)|[3.10.8][gtk-trusty]|[0.6.1][ssh-trusty]|[0.9.9][vnc-trusty] +Ubuntu 14.10 (Utopic Unicorn)|[3.12.2][gtk-utopic]|[0.6.3][ssh-utopic]|[0.9.9][vnc-utopic] +Ubuntu 15.04 (Vivid Vervet)|[3.14.7][gtk-vivid]|[0.6.3][ssh-vivid]|[0.9.9][vnc-vivid] +Ubuntu 16.04 (Xenial Xerus)|[3.18.9][gtk-xenial]|[0.6.3][ssh-xenial]|[0.9.10][vnc-xenial] +Ubuntu 17.04 (Zesty Zapus)|[3.22.11][gtk-zesty]|[0.7.3][ssh-zesty]|[0.9.11][vnc-zesty] +Ubuntu 18.04 (Bionic Beaver)|[3.22.30][gtk-bionic]|[0.8.0][ssh-bionic]|[0.9.11][vnc-bionic] +Arch Linux|[3.22.30][gtk-arch]|[0.7.5][ssh-arch]|[0.9.11][vnc-arch] +Solus|[3.22.26][gtk-solus]|[0.7.5][ssh-solus]|[0.9.11][vnc-solus] + +[gtk-wheezy]: https://packages.debian.org/wheezy/libgtk-3-0 +[gtk-jessie]: https://packages.debian.org/jessie/libgtk-3-0 +[gtk-stretch]: https://packages.debian.org/stretch/libgtk-3-0 +[gtk-sid]: https://packages.debian.org/sid/libgtk-3-0 +[gtk-centos]: https://git.centos.org/summary/rpms!gtk3.git +[gtk-precise]: http://packages.ubuntu.com/precise-updates/libgtk-3-0 +[gtk-trusty]: http://packages.ubuntu.com/trusty-updates/libgtk-3-0 +[gtk-utopic]: http://packages.ubuntu.com/utopic-updates/libgtk-3-0 +[gtk-vivid]: http://packages.ubuntu.com/vivid/libgtk-3-0 +[gtk-xenial]: http://packages.ubuntu.com/xenial/libgtk-3-0 +[gtk-zesty]: http://packages.ubuntu.com/zesty/libgtk-3-0 +[gtk-bionic]: http://packages.ubuntu.com/bionic/libgtk-3-0 +[gtk-arch]: https://www.archlinux.org/packages/extra/x86_64/gtk3 +[gtk-fedora]: https://apps.fedoraproject.org/packages/gtk3 +[gtk-solus]: https://dev.solus-project.com/source/libgtk-3/ + +[ssh-wheezy]: https://packages.debian.org/wheezy/libssh-4 +[ssh-jessie]: https://packages.debian.org/jessie/libssh-4 +[ssh-stretch]: https://packages.debian.org/stretch/libssh-4 +[ssh-sid]: https://packages.debian.org/sid/libssh-4 +[ssh-centos]: https://git.centos.org/summary/rpms!libssh.git +[ssh-lucid]: http://packages.ubuntu.com/lucid-updates/libssh-4 +[ssh-precise]: http://packages.ubuntu.com/precise-updates/libssh-4 +[ssh-trusty]: http://packages.ubuntu.com/trusty-updates/libssh-4 +[ssh-utopic]: http://packages.ubuntu.com/utopic-updates/libssh-4 +[ssh-vivid]: http://packages.ubuntu.com/vivid/libssh-4 +[ssh-xenial]: http://packages.ubuntu.com/xenial/libssh-4 +[ssh-zesty]: http://packages.ubuntu.com/zesty/libssh-4 +[ssh-bionic]: http://packages.ubuntu.com/bionic/libssh-4 +[ssh-arch]: https://www.archlinux.org/packages/extra/x86_64/libssh +[ssh-fedora]: https://apps.fedoraproject.org/packages/libssh +[ssh-solus]: https://dev.solus-project.com/source/libssh/ + +[vnc-wheezy]: https://packages.debian.org/wheezy/libvncserver0 +[vnc-jessie]: https://packages.debian.org/jessie/libvncserver0 +[vnc-stretch]: https://packages.debian.org/stretch/libvncserver1 +[vnc-sid]: https://packages.debian.org/sid/libvncserver1 +[vnc-centos]: https://git.centos.org/summary/rpms!libvncserver.git +[vnc-lucid]: http://packages.ubuntu.com/lucid/libvncserver0 +[vnc-precise]: http://packages.ubuntu.com/precise-updates/libvncserver0 +[vnc-trusty]: http://packages.ubuntu.com/trusty-updates/libvncserver0 +[vnc-utopic]: http://packages.ubuntu.com/utopic/libvncserver0 +[vnc-vivid]: http://packages.ubuntu.com/vivid/libvncserver0 +[vnc-xenial]: http://packages.ubuntu.com/xenial/libvncserver1 +[vnc-zesty]: http://packages.ubuntu.com/zesty/libvncserver1 +[vnc-bionic]: http://packages.ubuntu.com/bionic/libvncserver1 +[vnc-arch]: https://www.archlinux.org/packages/extra/x86_64/libvncserver +[vnc-fedora]: https://apps.fedoraproject.org/packages/libvncserver +[vnc-solus]: https://dev.solus-project.com/source/libssh/
\ No newline at end of file diff --git a/Problems-and-tweaks/Problems-with-Wayland.md b/Problems-and-tweaks/Problems-with-Wayland.md new file mode 100644 index 0000000..7e57306 --- /dev/null +++ b/Problems-and-tweaks/Problems-with-Wayland.md @@ -0,0 +1,3 @@ +* Composing a indicator menu with 250-300 elements takes a lot of time (up to 2-3 seconds some times). This composition is done outside Remmina: After Remmina sets the menu with app_indicator_set_menu() and builds it, Remmina returns to the event loop. Then something external to Remmina freezes the mouse cursor for 1-3 seconds when building that menu. Tested on ubuntu 18.04 with Wayland. +* Remmina is not receiving clipboard owner-changes when it doesn't have focus: https://gitlab.com/Remmina/Remmina/issues/2084 +* The Windows/Super key cannot be captured (to be verified). diff --git a/Problems-and-tweaks/Remmina-RDP-and-HiDPI-scaling.md b/Problems-and-tweaks/Remmina-RDP-and-HiDPI-scaling.md new file mode 100644 index 0000000..961e5d0 --- /dev/null +++ b/Problems-and-tweaks/Remmina-RDP-and-HiDPI-scaling.md @@ -0,0 +1,32 @@ +TL;DR all the RDP remote desktops are blurred on a HiDPI monitor with scaling enabled. And there is no way to fix it under Gnome Shell. Read issues #1778 #1878 to find a workaround for gnome shell, or switch to KDE desktop. + +## How is it supposed to work + +The RDP protocol, starting with Windows 8.1, requires that scaling be done at the server-side. Your local Remmina client should simply draw unscaled the bitmaps it receives from the server. + +## Why it does not work + +GTK3 and Gnome Shell have a horrible implementation of HiDPI scaling. +When you enable scaling on your Gnome Shell settings, you enable an integer scaling factor, i.e. 1x 2x 3x. After enabling scaling under Gnome Shell, GTK 3 will scale all bitmaps we draw to a GtkDrawingArea by that scaling factor. It will also scale all cursor bitmaps and mouse positions/movement. +As we told before, RDP requires that all those scaling operations to be done at the server-side by windows, not by the client. + +We tried to neutralize GTK integral scaling factor for Remmina application, but we did not reach acceptable results: + +* Neutralize bitmap scaling: can be done in code with cairo, but requires some dozen lines of code in various Remmina parts +* Neutralize cursor position scaling: can be done just by multiplying by the scaling factor, but we lose precision in mouse position. +* Neutralize window dimension/allocation scaling: again this can be done by multiplying or dividing by the scaling factor the GtkDrawingArea width and height. But we lose precision. +* Neutralize cursor scaling: seems to be impossible to do with GTK. So we could scale down the cursor bitmap, but it will be shown pixelated due to the duplication of pixels done by GTK. + +All this effort took around 100 lines of code, 3-4 hours of development and many hours of testing. And the result is really bad: cursor is still bad, code became more complex, a bit of mouse precision is lost. +Note that the first problem "neutralize bitmap scaling" could be also partially solved using the current Remmina scaler and a fix remote resolution, provided that every time you change the remote resolution you should recalculate your local window size. A simpler approach is to enable the Remmina scaler, set the remote resolution as your monitor full resolution and use Remmina full screen only. But cursors are still not scaled See [issue 1878](https://gitlab.com/Remmina/Remmina/issues/1878). + +## Even worse: fractional scaling experimental feature + +Recently an experimental feature has been added to Gnome Shell to enable fractional scaling (i.e: 1.7x), both for X.Org and Wayland. This feature seems to set GTK scaling to 2x and then apply a global screen scaling via Xrandr or similar. +This makes Remmina impossible to correctly deal with local scaling: Remmina can no longer disable scaling done by Xrandr, and is also unable to determine your current monitor scaling factor to send to the remote server. The result is very blurry. + +## How should it work + +Windows 10, MacOS, KDE/Qt have a simple approach to HiDPI: an application can declare itself to be HiDPI aware. When the application declares itself HiDPI aware, all graphical drawings to the monitor are not scaled, all pointer motions are not scaled, all mouse cursor are not scaled. But all wigets of the application, like buttons, texts are still correctly rendered at bigger dimensions. Under Qt this can obtained with a single line of code: `QGuiApplication::setAttribute(Qt::AA_DisableHighDpiScaling);` +Unfortunately, Remmina is not a Qt application, it's a GTK application. And Gnome Shell is not Plasma. + diff --git a/Problems-and-tweaks/Remmina-VNC-to-Raspbian-Stretch.md b/Problems-and-tweaks/Remmina-VNC-to-Raspbian-Stretch.md new file mode 100644 index 0000000..88d10d9 --- /dev/null +++ b/Problems-and-tweaks/Remmina-VNC-to-Raspbian-Stretch.md @@ -0,0 +1,27 @@ +The RaspberryPi Raspbian 9 default VNC server is RealVNC. RealVNC only supports 5 propertary security types: 5, 6, 13, 130 and 192. +According to the official RealVNC documentation for the "Authentication" parameter, Authentication=VncAuth is the only scheme that allows direct connections from VNC-compatible Viewer projects from third parties. + +In order to change to VncAuth scheme in your Raspbian and set a password to accept connections from Remmina VNC plugin, you have to: +1. Open a SSH session or a terminal window to the raspberry +2. As root, edit the file /root/.vnc/config.d/vncserver-x11 +```sudo leafpad /root/.vnc/config.d/vncserver-x11``` +3. Add the following lines at the end of the file +``` +Authentication=VncAuth +Password=aa8ba782c23aff7e +``` +4. Save the file. +5. Restart the VNC server service with +```sudo systemctl restart vncserver-x11-serviced``` + +The above encrypted password is **remmina**, if you want to change it, type +```sudo vncpasswd -service``` and restart the VNC server service with ```sudo systemctl restart vncserver-x11-serviced``` + + + +References: + +[1] IANA: [Remote Framebuffer Security Types](https://www.iana.org/assignments/rfb/rfb.xhtml#rfb-1) +[2] RealVNC: [VNC Server parameter reference](https://www.realvnc.com/en/connect/docs/server-parameter-ref.html) + + diff --git a/Problems-and-tweaks/Squares-instead-of-text.md b/Problems-and-tweaks/Squares-instead-of-text.md new file mode 100644 index 0000000..a54d4ce --- /dev/null +++ b/Problems-and-tweaks/Squares-instead-of-text.md @@ -0,0 +1,17 @@ +Sometimes, when you start Remmina, it shows squares instead of each character in all of Remmina' GUI elements. + + + +This is caused by a broken font cache. + +The quick-fix is: + +``` +pkill remmina +rm -rf ~/.cache/fontconfig +fc-cache -f -v +sudo rm -rf /var/cache/fontconfig/* +sudo fc-cache -f -v +``` + +Start Remmina again and the problem should have disappeared. diff --git a/Problems-and-tweaks/Systray-menu.md b/Problems-and-tweaks/Systray-menu.md new file mode 100644 index 0000000..b347c60 --- /dev/null +++ b/Problems-and-tweaks/Systray-menu.md @@ -0,0 +1,71 @@ +# Systray menu +Currently there is not a common way to create a systray menu compatible with all desktops. + +[GtkStatusIcon](https://developer.gnome.org/gtk3/stable/GtkStatusIcon.html) has been deprecated since GTK 3.14. +So we must move to something else. Unfortunately, this "something else" is different from a desktop environment to another. + +E.g.: read [this discussion](https://trac.transmissionbt.com/ticket/3685) for the same problem on Transmission client. + +Yet, we cannot use gtk_window_present() from a systray menu, see issue [#542](https://gitlab.com/Remmina/Remmina/issues/542). + +So, for each supported desktop environment, we must answer two questions: + +Q1. Where do we put the remmina systray menu, and which API do we use for it ? +Q2. Does this place also allow the user to raise a hidden window via gtk_window_present() ? + +### References + +* [freedesktop.org system tray spec](http://www.freedesktop.org/wiki/Specifications/systemtray-spec/) +* [Libunity source code](http://bazaar.launchpad.net/~unity-team/libunity/trunk/files), written in vala. + +# The desktop environments + +### Unity +In Ubuntu's Unity, we currently do not use GtkStatusIcon, but libappindicator. This almost works, but when the remmina windows are not on the top, we are unable to present its windows to users. This is explained in [issue #542](https://github.com/FreeRDP/Remmina/issues/542) and it's a problem of the window manager which prevents gtk_window_present() to stealing focus to other applications. +We could use DBusMenu and the [Launcher API](https://wiki.ubuntu.com/Unity/LauncherAPI) to move all the current remmina systray menu into Unity Launcher icon as **dynamic quicklist entries**. +Compatibility with gtk_window_present() must be tested. + +### Gnome Shell +Some functions of the [Shell](https://developer.gnome.org/shell/stable/) for ShellTrayIcon object should help for the icon (but no menu support ???). For correctly placing a menu, we can take a look to [Gnome Shell Extension Appindicator source code](https://github.com/rgcjonas/gnome-shell-extension-appindicator). + +Read [this page](https://wiki.gnome.org/Design/Whiteboards/StatusIcons) which contains a possible plan for GtkStatusIcon under Gnome Shell. + +In Gnome Shell, Status Icons (GtkStatusIcon) were hidden into the Message Tray at the bottom of the screen. +See https://help.gnome.org/misc/release-notes/3.6/users-message-tray.html.en +The Message Tray has been removed with Gnome Shell 3.16: https://help.gnome.org/misc/release-notes/3.16/ and it seems that a new drawer has been added to the bottom left of the screen to host all application status icons. Unfortunately I'm currently unable to find official changelog/documentation for this drawer. + + +Currently Remmina detects Gnome Shell and, if detected, remmina will quit when there are no visible windows on the screen. We did this because older Gnome Shells hides all deprecated GtkStatusIcons in a hidden place below the screen, and the user is unable to undestand when remmina is running. +Starting with [Gnome Shell 3.16](http://www.webupd8.org/2015/03/gnome-316-released-with-new.html) a new drawer has been introduced, which can give the user visual feedback of the GtkStatusIcon presence. + + +### KDE +In KDE [KStatusNotifierItem](http://api.kde.org/frameworks-api/frameworks5-apidocs/knotifications/html/classKStatusNotifierItem.html) + +### Plasma 5 + +In Plasma 5 they have removed completely the support of the xembed protocol, but you can run XEmbed SNI Proxy and work around it. + +The goal of this project is to make xembed system trays available in Plasma: + +https://github.com/KDE/plasma-workspace/tree/master/xembed-sni-proxy [-] + +Just run +```sh +xembedsniproxy +``` + +### XFCE +In XFCE ??? + +### LXDE/LXQT +In LXDE ??? + +### MATE +In MATE ??? + +### EXTERNAL SOURCES ### + +* [Proper implementation of system tray icons via libappindicator/StatusNotifierItem](https://code.google.com/p/chromium/issues/detail?id=419673) +* [Updated Tray to use libappindicator in Linux](https://github.com/nwjs/nw.js/pull/2327) Discussion that propose the same Google Chrome fix. + diff --git a/Problems-and-tweaks/View-and-export-passwords.md b/Problems-and-tweaks/View-and-export-passwords.md new file mode 100644 index 0000000..80fb74f --- /dev/null +++ b/Problems-and-tweaks/View-and-export-passwords.md @@ -0,0 +1,7 @@ +# Viewing passwords + +It is possible to view passwords with the [Remmina password exporter](https://pypi.org/project/remmina-password-exposer/), or as per one of the solutions in [Ubuntu Questions](https://askubuntu.com/questions/290824/how-to-extract-saved-password-from-remmina). + +# Exporting passwords + +It is possible to export passwords from mRemoteNG to Remmina using the [Remmina-mRemoteNG converter](https://github.com/mkud/Remmina_mRemoteNG_conv) Python script. diff --git a/Problems-and-tweaks/vnc-key-mapping-configuration.md b/Problems-and-tweaks/vnc-key-mapping-configuration.md new file mode 100644 index 0000000..c72a6e1 --- /dev/null +++ b/Problems-and-tweaks/vnc-key-mapping-configuration.md @@ -0,0 +1,26 @@ +# How to configure key mapping with the VNC plugin. + +Remmina has an hidden feature with which you can configure custom key mappings, this is useful if you need, for example, to map the local *Super* key to the remote macOS *Option* key *(leaving theexisting local *Alt* key to the remote macOS* Command *key map alone.)* + +See #1716 for a long discussion about this. + +Keys can be mapped according to a configurable map. There is a predefined map called "Map Meta Key" that seems to be exactly what we need for macOS. + +Edit your connection profile, under "Basic settings", you will find "Keyboard mapping". Choose "Map Meta Keys". + + + +Save and connect. + +**Map Meta Keys** is the following map: + +``` +[Map Meta Keys] +Super_L = Meta_L +Super_R = Meta_R +Meta_L = Super_L +Meta_R = Super_R +``` + +Other maps, using the same syntax, can be created in the `remmina.keymap` file, located in the same directory as the remmina.pref file, usually `~/.config/remmina/remmina.keymap` Key symbol names can be found on the GDK file [gdk/gdkkeysyms.h](https://gitlab.gnome.org/GNOME/gtk/raw/master/gdk/gdkkeysyms.h). + diff --git a/Testing/New-element.md b/Testing/New-element.md new file mode 100644 index 0000000..05eab42 --- /dev/null +++ b/Testing/New-element.md @@ -0,0 +1 @@ +What happens
\ No newline at end of file diff --git a/Testing/Testing-under-Ubuntu-with-the-remmina-next-daily-PPA.md b/Testing/Testing-under-Ubuntu-with-the-remmina-next-daily-PPA.md new file mode 100644 index 0000000..8c69c15 --- /dev/null +++ b/Testing/Testing-under-Ubuntu-with-the-remmina-next-daily-PPA.md @@ -0,0 +1,38 @@ +# Testing under Ubuntu with the remmina-next-daily PPA + +Remmina users using Ubuntu and derivatives are warmly invited to use our **remmina-next** PPA, as explained in the [Remmina wiki homepage](https://github.com/FreeRDP/Remmina/wiki). +The **remmina-next** PPA is updated every official [release](https://github.com/FreeRDP/Remmina/releases), therefore it can be considered **stable**. + +We also provide an **unstable** PPA, called **remmina-next-daily**. remmina-next-daily is updated daily and contains the latest patches pushed to the _next_ github branch. + +If you want to help testing Remmina before an official release, you can switch to the remmina-next-daily by doing the following: + + +1. Install the ppa-purge package +```sudo apt install ppa-purge``` +2. Purge the remmina-next PPA +```sudo ppa-purge ppa:remmina-ppa-team/remmina-next``` +3. Install the remmina-next-daily PPA +``` +sudo apt-add-repository ppa:remmina-ppa-team/remmina-next-daily +sudo apt update +``` +4. Install Remmina packages + +* if not installed previously +``` +sudo apt install remmina remmina-plugin-rdp libfreerdp-plugins-standard +``` + +* if installed previously, just do: +``` +sudo apt upgrade +``` +You might need to perform the following command to remove the previous Remmina from memory: +``` +sudo killall remmina +``` + + +Happy testing :) + diff --git a/Usage.md b/Usage.md new file mode 100644 index 0000000..57f1831 --- /dev/null +++ b/Usage.md @@ -0,0 +1,3 @@ +- [Remmina user’s guide](https://gitlab.com/Remmina/Remmina/-/wikis/Usage/Remmina-User%27s-guide) +- [Remmina usage FAQ](https://gitlab.com/Remmina/Remmina/-/wikis/Usage/Remmina-Usage-FAQ) +- [Remmina SSH terminal colour schemes](https://gitlab.com/Remmina/Remmina/-/wikis/Usage/Remmina-SSH-Terminal-colour-schemes)
\ No newline at end of file diff --git a/Usage/Remmina-SSH-Terminal-colour-schemes.md b/Usage/Remmina-SSH-Terminal-colour-schemes.md new file mode 100644 index 0000000..913a92f --- /dev/null +++ b/Usage/Remmina-SSH-Terminal-colour-schemes.md @@ -0,0 +1,23 @@ +# Using colour schemes in Remmina SSH protocol plugin + +## Choosing between the standard colour schemes + +You can chose a colour scheme directly in the advanced TAB of your SSH connection profile + + + +There are 6 predefined colour schemes + +## Importing a colour scheme + +You can import a colour scheme from the general preferences + + + +Several colour schemes are available to download on the [iTerm2-Color-Schemes repository on GitHub](https://github.com/mbadolato/iTerm2-Color-Schemes/tree/master/remmina). + +As soon as you have found one you like, you must set "Custom colour scheme" in the SSH profile advanced TAB. + + + + diff --git a/Usage/Remmina-Usage-FAQ.md b/Usage/Remmina-Usage-FAQ.md new file mode 100644 index 0000000..20ad887 --- /dev/null +++ b/Usage/Remmina-Usage-FAQ.md @@ -0,0 +1,34 @@ +# Remmina Usage FAQ + +1. **Where are all my connections and preferences stored ?** +**A:** Remmina stores its configuration file in directories identified according the [XDG Base Directory Specification](http://www.freedesktop.org/Standards/basedir-spec). +A main configuration file `remmina.pref` is stored into `$XDG_CONFIG_HOME/remmina/` directory, which defaults to `$HOME/.config/remmina/`. +Every single connection profile is stored into a `XXXXXXXXXXXXX.remmina` file under `$XDG_DATA_HOME/remmina` directory, which defaults to `$HOME/.local/share/remmina`. +Older versions of remmina used to store all `*.remmina` and `remmina.pref` files under `$HOME/.remmina`. If a newer version of remmina finds an existing `$HOME/.remmina/` legacy directory, then remmina will revert back to use it. + +2. **Can I start a connection using a shell command ?** +**A:** Yes, use `remmina -c filename`. + +3. **When I'm in fullscreen mode, I cannot see the "floating toolbar" (the bar at the top of the screen), or I can see part of it but it does not scroll down or receive my input.** +**A:** You are using Gnome Shell and an older version of remmina. This has been fixed under remmina 1.2.0-rcgit.3 compiled with GTK+ 3.10 or newer. Please restart your system after upgrading remmina. + +4. **The "Quality settings" in Remmina preferences -> RDP is not saving the default quality setting.** +**A:** This is a quality profile editor, not a quality chooser. See issue #521 + +5. **I'm unable to escape from VMware vSphere client console pressing Ctrl+Alt.** +**A:** You are probably pushing the Ctrl key on the right side of the keyboard. That key is reserved as Remmina Host key. Use the left Ctrl key or change the host key in the Remmina global settings. + +6. **Under Gnome Shell the Remmina systray menu is hidden in the hidden notification area** +**A:** Install this [AppIndicator Support Gnome Shell Extension](https://extensions.gnome.org/extension/615/appindicator-support/) to see the systray menu in a more confortable place. + +7. **After a Remmina upgrade, I'm unable to connect to some servers.** +**A:** Try to remove the file `~/.config/freerdp/known_hosts`. + +8. **After a Remmina upgrade, I have to reenter all passwords.** +**A:** Yes, with commit 57ec85d8e9bf773b8a08c17a0218b6cd643c828b we switched to libsecret, and passwords cannot be imported automatically. + +9. **Remmina cannot connect to Raspbian Stretch VNC server** +**A:** See our guide: [Remmina VNC to Raspbian Stretch](Remmina-VNC-to-Raspbian-Stretch) + +10. **Warning: This plugin requires GtkSocket, but it's not available** +**A:** This usually happens when running remmina under wayland: some plugins needs the GtkSocket support. GtkSocket makes use of the xembed protocol, which is not available under Wayland. If your system is running XWayland you can try to workaround the problem by running remmina with the environment variable GDK_BACKEND set to x11. For example in a terminal, after closing all running instances of remmina, you can start remmina with `GDK_BACKEND=x11 remmina`.
\ No newline at end of file diff --git a/Usage/Remmina-User's-guide.md b/Usage/Remmina-User's-guide.md new file mode 100644 index 0000000..d185cfd --- /dev/null +++ b/Usage/Remmina-User's-guide.md @@ -0,0 +1,50 @@ +# Introduction + +This manual is a work in progress. Feel free to contribute and help us to make this manual useful and pleasant to read. + +Screen shots are taken and modified with [Shutter](http://shutter-project.org) + +# Remmina Introduction + +Remmina is a feature rich Remote Desktop Application for GNU Linux(tm) and FreeBSD and possibly other Unixes. + +## Remmina features + +- Maintain a list of connection profiles, organized by groups +- Make quick connections by directly putting in the server address +- Remote desktops with higher resolutions are scrollable/scalable in both window and fullscreen mode. +- Viewport fullscreen mode: remote desktop automatically scrolls when the mouse moves over the screen edge. +- Floating toolbar in fullscreen mode, allows you to switch between modes, toggle keyboard grabbing, minimize, etc. +- Tabbed interface, optionally managed by groups. +- Tray icon, allows you to quickly access configured connection profiles +- Remote screen-shots + + + +## How to use Remmina +The following are typical use cases +### Quick connect using RDP +Use this if you don't need or want to save your connection. +Only RDP, SSH, VNC and NX are supported in the quick connect. + +1. Choose the protocol +2. Insert the server name +3. Click on connect +### Create a new Profile +1. Click on the "New Profile" icon + +2. Enter your server connection details + + +- You can ask Remmina to execute commands before and after the connection +- If you use Avahi, you can search available hosts as highlighted +- You can group different connections. + +# Options +* Name: this is the name you gave to this connection, it's just for you to recognize it easily. +* Group: +* Protocol: here you choose the protocol type: [[RDP]], [[SFTP]], [[SSH]] +* Pre-command: what to do before starting the connection +* Post-command: what to do after closing the connection +## General +* Server: here you put the IP address of the remote machine diff --git a/_sidebar.md b/_sidebar.md new file mode 100644 index 0000000..855c424 --- /dev/null +++ b/_sidebar.md @@ -0,0 +1,38 @@ +### Table of contents +- [Home](https://gitlab.com/Remmina/Remmina/-/wikis/Home) +- [Usage](https://gitlab.com/Remmina/Remmina/-/wikis/Usage) + - [Remmina SSH terminal colour schemes](https://gitlab.com/Remmina/Remmina/-/wikis/Usage/Remmina-SSH-Terminal-colour-schemes) + - [Remmina usage FAQ](https://gitlab.com/Remmina/Remmina/-/wikis/Usage/Remmina-Usage-FAQ) + - [Remmina user’s guide](https://gitlab.com/Remmina/Remmina/-/wikis/Usage/Remmina-User's-guide) +- [Compilation](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compilation) + - [Compilation guide for Red Hat/CentOS](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compilation-guide-for-RHEL) + - [Compile on Arch Linux](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Arch-Linux) + - [Compile on Debian 10 Buster](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Debian-10-Buster) + - [Compile on Debian 9 Stretch](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Debian-9-Stretch) + - [Compile on Fedora 20 ~ 26](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Fedora-20-~-26) + - [Compile on FreeBSD](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-FreeBSD) + - [Compile on Ubuntu 14.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-14.04) + - [Compile on Ubuntu 16.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-16.04) + - [Compile on Ubuntu 18.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-18.04) + - [Compile on Ubuntu 20.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-20.04) +- [Development](https://gitlab.com/Remmina/Remmina/-/wikis/Development) + - [Development Notes](https://gitlab.com/Remmina/Remmina/-/wikis/Development/Development-Notes) + - [multi-monitor support](https://gitlab.com/Remmina/Remmina/-/wikis/Development/multi-monitor-support) +- [Contribution](https://gitlab.com/Remmina/Remmina/-/wikis/Contribution) + - [Contribute to the Remmina documentation](https://gitlab.com/Remmina/Remmina/-/wikis/Contribution/Contribute-to-the-Remmina-documentation) + - [HOWTO generate the changelog](https://gitlab.com/Remmina/Remmina/-/wikis/Contribution/HOWTO-generate-the-changelog) +- [Localisation](https://gitlab.com/Remmina/Remmina/-/wikis/Localisation) + - [How to translate Remmina](https://gitlab.com/Remmina/Remmina/-/wikis/Localisation/How-to-translate-Remmina) + - [Update gettext messages](https://gitlab.com/Remmina/Remmina/-/wikis/Localisation/Update-gettext-messages) +- [Testing](https://gitlab.com/Remmina/Remmina/-/wikis/Testing) + - [Testing under Ubuntu with the remmina next daily PPA](https://gitlab.com/Remmina/Remmina/-/wikis/Testing/Testing-under-Ubuntu-with-the-remmina-next-daily-PPA) +- [Problems and tweaks](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks) + - [Black screen](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/Black-screen) + - [GTK versions on various distributions](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/GTK-versions-on-various-distributions) + - [Problems with Wayland](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/Problems-with-Wayland) + - [Remmina RDP and HiDPI scaling](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/Remmina-RDP-and-HiDPI-scaling) + - [Remmina VNC to Raspbian Stretch](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/Remmina-VNC-to-Raspbian-Stretch) + - [Squares insead of text](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/Squares-instead-of-text) + - [Systray menu](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/Systray-menu) + - [VNC key mapping configuration](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/vnc-key-mapping-configuration) + - [View and export passwords](https://gitlab.com/Remmina/Remmina/-/wikis/Problems-and-tweaks/View-and-export-passwords) diff --git a/uploads/05b5a44815444cabe7912831010f0c48/image.png b/uploads/05b5a44815444cabe7912831010f0c48/image.png Binary files differnew file mode 100644 index 0000000..ccfd09f --- /dev/null +++ b/uploads/05b5a44815444cabe7912831010f0c48/image.png diff --git a/uploads/4509e9948a20ab208e70dfedde3edb4c/image.png b/uploads/4509e9948a20ab208e70dfedde3edb4c/image.png Binary files differnew file mode 100644 index 0000000..38d4dc6 --- /dev/null +++ b/uploads/4509e9948a20ab208e70dfedde3edb4c/image.png |
