Remmina: The GTK+ Remote Desktop Client

Initially developed by Vic Lee

Description

Remmina is a remote desktop client written in GTK+, aiming to be useful for system administrators and travellers, who need to work with lots of remote computers in front of either large monitors or tiny netbooks. Remmina supports multiple network protocols in an integrated and consistent user interface. Currently RDP, VNC, SPICE, NX, XDMCP, SSH and EXEC are supported.

Remmina is released in separated source packages:

"remmina", the main GTK+ application
"remmina-plugins", a set of plugins

Remmina is free and open-source software, released under GNU GPL license.

Installation

Binary distributions

Usually remmina is included in your linux distribution or in an external repository. Do not ask for distribution packages or precompiled binaries here. This is a development site.

Debian

Remmina is not available on the default Debian 9 (Stretch) repositories. It can be installed from the Backports repository.

The Debian Backports repository must be enabled to install it, see this blog post for more information.

To install Remmina from Debian Backports, just copy and paste the following lines on a terminal window:

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 libfreerdp-plugins-standard

Ubuntu

Using Snap Package (also for other supported distros)

You can install the last release from the Ubuntu Software center, looking for remmina, otherwise you can install it from terminal with:

sudo snap install remmina

If you want to install latest git revision of remmina, you can use it from the edge channel:

sudo snap install remmina  --edge

Or update the current installed version with the selected channel:

sudo snap refresh remmina --channel=edge # use --channel=stable otherwise

To enable some advanced features such as mount-control (to manage mount positions), avahi-observer (to automatically look for local servers to connect to), cups-control (to manage printing), password-manager-service (to use gnome-keyring) you should run something like:

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 # gnome-keyring

Snap packages will be updated automatically and will include both latest FreeRDP git and latest libssh 0.7 release (for better security).

From PPA

Ubuntu ppa:remmina-ppa-team/remmina-next

To install it, just copy and paste the following three lines on a terminal window

sudo apt-add-repository ppa:remmina-ppa-team/remmina-next
sudo apt-get update
sudo apt-get install remmina remmina-plugin-rdp libfreerdp-plugins-standard

By default the RDP, SSH and SFTP plugins are installed. You can view a list of available plugins with apt-cache search remmina-plugin

If you want to connect to more securely configured SSH servers on Ubuntu 16.04 and below, you have to upgrade libssh to 0.7.X. This can be achieved by adding the following PPA containing libssh 0.7.X by David Kedves and upgrading your packages:

sudo add-apt-repository ppa:kedazo/libssh-0.7.x
sudo apt-get update

Fedora and Red Hat

As of March 2018 Remmina is available on most fedora testing and stable, we still have a (not updated) copr provided by Hubbitus (Pavel Alexeev), to install just execute as root:

dnf copr enable hubbitus/remmina-next
dnf upgrade --refresh 'remmina*' 'freerdp*'

On Red Hat you can enable the EPEL repository:

wget http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
rpm -ivh epel-release-latest-7.noarch.rpm

Arch Linux based

Install remmina-git from AUR

openSUSE

Remmina is in the offical repositories for all openSUSE distributions. In case the version in the released stable branch of openSUSE is too old you can install the latest one from the devel project via:

zypper ar -f obs://X11:RemoteDesktop/remmina remmina
zypper ref
zypper in remmina

For users with a distro that supports Flatpak, including Ubuntu

flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install --user flathub org.remmina.Remmina
flatpak run --user org.remmina.Remmina

If you use SSH agent (flatpak/flatpak#1438 )

flatpak run --filesystem=$SSH_AUTH_SOCK --env=SSH_AUTH_SOCK=$SSH_AUTH_SOCK org.remmina.Remmina

Just be aware that flatpak store data for installed applications (the XDG config/data folders) under $HOME/.var So for instance, if you previously have 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

External not supported plugins

There are also some external, not supported plugins provided by Muflone :

remmina-plugin-folder A protocol plugin for Remmina to open a folder.
remmina-plugin-open A protocol plugin for Remmina to open a document with its associated application.
remmina-plugin-rdesktop A protocol plugin for Remmina to open a RDP connection with rdesktop.
remmina-plugin-teamviewer A protocol plugin for Remmina to launch a TeamViewer connection.
remmina-plugin-ultravnc A protocol plugin for Remmina to connect via VNC using UltraVNC viewer.
remmina-plugin-url A protocol plugin for Remmina to open an URL in an external browser.
remmina-plugin-webkit A protocol plugin for Remmina to launch a GTK+ Webkit browser.

From the source code

Follow the guides available on the wiki:

Wiki and compilation instructions

Usage

Just select Remmina from your application menu or execute remmina from the command line

Remmina support also the following options:

  -a, --about                 Show about dialog
  -c, --connect=FILE          Connect to a .remmina file
  -e, --edit=FILE             Edit a .remmina file
  -n, --new                   Create a new connection profile
  -p, --pref=PAGENR           Show preferences dialog page
  -x, --plugin=PLUGIN         Execute the plugin
  -q, --quit                  Quit the application
  -s, --server=SERVER         Use default server name
  -t, --protocol=PROTOCOL     Use default protocol
  -i, --icon                  Start as tray icon
  -v, --version               Show the application's version
  -V, --full-version          Show the application's version, including the plugin versions
  --display=DISPLAY           X display to use

Configuration

You can configure everything from the graphical interface or editing by hand the files under $HOME/.remmina or $HOME/.config/remmina

Contributing

See CONTRIBUTING.md for a better overview.

If you want to contribute with code:

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

If you want to contribute in other ways, drop us an email using the form provided in our web site.

Donations

If you rather prefer to contribute to Remmina with money you are more than welcome.

For more informations See the Remmina web site donation page.

See the THANKS.md file for an exhaustive list of supporters.

Paypal

Bitcoin

If clicking on the line above does not work, use this payment info:

Remmina bitcoin address: 1298H2vaxcbDQRuRYkDjfFbvGEgxE1CNjk
Message: Remmina Donation

Authors

Remmina is maintained by:

See the AUTHORS for an exhaustive list. If you are not listed and you have contributed, feel free to update that file.

Resources

Wiki and compilation instructions
G+ Remmina community
Website
IRC we are on freenode.net , in the channel #remmina, you can also use a web client in case

License

Licensed under the GPLv2 license

zhuomingliang / remmina Goto Github PK

remmina's Introduction