.Dd 2018-08-01
.Dt REMMINA 1
.Sh NAME
.Nm remmina
.Nd Remmina the GTK+ Remote Desktop Client
.Sh SYNOPSIS
.Nm
.Op Fl a|i|n|q|v
.Op Fl c Ar FILE
.Op Fl e Ar FILE
.Op Fl p Ar TABINDEX
.Op Fl s Ar SERVER
.Op Fl t Ar PROTOCOL
.Op Fl x Ar PLUGIN
.Op Fl -update-profile
.Op Fl -set-option Ar OPTION[=VALUE]
.Op Fl -display Ar DISPLAY
.Sh 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, SSH, SPICE, NX, XDMCP, and WWW are supported.
.Lp
Remmina is released in separated source packages:
.Lp
    "remmina", the main GTK+ application
    "remmina-plugins", a set of plugins
.Lp
Remmina is free and open-source software, released under GNU GPL license.
.Sh FILES
\(Do\(lCXDG_CONFIG_DIRS\(rC/remmina.pref or \(Do\(lCXDG_CONFIG_HOME\(rC/remmina/remmina.pref :
.Lp
Remmina configuration files.
.Lp
At the first Remmina execution the system wide Remmina configuration files,
will be copied in the \(Do\(lCXDG_CONFIG_HOME\(rC
.Lp
\(Do\(lCXDG_DATA_DIRS\(rC/FILE.remmina or \(Do\(lCXDG_DATA_HOME\(rC/remmina/FILE.remmina :
.Lp
Remmina profiles, the file name is autogenerated, but you can create manually your
own files with the \fBFILE\fR name you prefer. It's possible to specify a custom profile name and location.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl h, -help
Show help options
.It Fl a
Show about dialog
.It Fl c, -connect\fR=\fIFILE\fR
Connect directly either to a desktop using options described in a file, or a supported URI (RDP, VNC, SSH or SPICE). The filetype can be ".remmina" or one supported by a plugin capable of importing files
.It Fl e, -edit\fR=\fIFILE\fR
Open and edit desktop connection using options described by file, file type can be either .remmina or one supported by a file import capable plugin
.It Fl k, -kiosk\fR
Start Remmina in kiosk mode (thin client)
.It Fl n, -new\fR
Create a new connection profile
.It Fl p, -pref\fR=\fITABINDEX\fR
Show preferences dialog page
.It Fl x, -plugin\fR=\fIPLUGIN\fR
Execute the plugin
.It Fl q, -quit\fR
Quit the application
.It Fl s, -server\fR=\fISERVER\fR
Use default server name (for \fB\-\-new\fR)
.It Fl t, -protocol\fR=\fIPROTOCOL\fR
Use default protocol (for \fB\-\-new\fR)
.It Fl i, -icon\fR
Start as tray icon
.It Fl v, -version\fR
Show the application's version
.It --update-profile\fR
Modify connection profile, require also \-\-set\-option
.It --set-option \fIOPTION[=VALUE]\fR
Set one or more profile settings, to be used with \-\-update\-profile
.It --encrypt-password\fR
Encrypt a password
.It --display\fR=\fIDISPLAY\fR
X display to use
.El
.Sh EXAMPLES
.Lp
To connect using an exisitng connection profile use:
.RS
.nf
\fBremmina -c FILE.remmina\fP
.fi
.RE
.Lp
To quick connect using a URI:
.RS
.nf
remmina -c rdp://username@server
remmina -c rdp://domain\\\\username@server
remmina -c vnc://username@server
remmina -c vnc://server?VncUsername=username
remmina -c ssh://user@server
remmina -c spice://server

To quick connect using a URI along with an encrypted password:
remmina -c rdp://username:encrypted-password@server
remmina -c vnc://username:encrypted-password@server
remmina -c vnc://server?VncUsername=username\\&VncPassword=encrypted-password

To encrypt a password for use with a URI:
remmina --encrypt-password

.fi
.RE
.Lp
To update username and password and set a different resolution mode of a remmina connection profile use:
.RS
.nf
\fBecho "ausername\\napassword" | remmina --update-profile /PATH/TO/FOO.remmina --set-option username --set-option resolution_mode=2 --set-option password\fP
.fi
.RS
.Lp
.Lp
.Sh SEE ALSO
.Xr remmina-file-wrapper 1
.Sh AUTHORS
Antenore Gatta <antenore at simbiosi dot org> and Giovanni Panozzo <giovanni at panozzo dot it>
.Lp
See the THANKS file for a more detailed list.
.Lp
Remmina was initially written by Vic Lee <llyzs@163.com>
.Lp
This manual page was written by Antenore Gatta <antenore at simbiosi dot org>.
.Lp
.Sh COPYRIGHT
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2, or (at your option) any
later version.