Scroll to navigation

XFREERDP(1) xfreerdp XFREERDP(1)

NAME

xfreerdp - FreeRDP X11 client

SYNOPSIS

xfreerdp [file] [options] [/v:server[:port]]

DESCRIPTION

xfreerdp is an X11 Remote Desktop Protocol (RDP) client which is part of the FreeRDP project. An RDP server is built-in to many editions of Windows. Alternative servers included xrdp and VRDP (VirtualBox).

OPTIONS

/v <server>[:port]
Server hostname
/port <number>
Server port
/w <width>
Width
/h <height>
Height
/size <width>x<height>
Screen size
/f
Fullscreen mode
/bpp <depth>
Session bpp (color depth)
/kbd 0x<layout id> or <layout name>
Keyboard layout
/kbd-list
List keyboard layouts
/kbd-type <type id>
Keyboard type
/kbd-subtype <subtype id>
Keyboard subtype
/kbd-fn-key <function key count>
Keyboard function key count
/admin
Admin (or console) session
/multimon
Use multiple monitors
/workarea
Use available work area
/monitors <0,1,2...>
Select monitors to use
/monitor-list
List detected monitors
/t <title>
Window title
/decorations
Window decorations
/smart-sizing
Scale remote desktop to window size
/a (null)
Addin
/vc (null)
Static virtual channel
/dvc (null)
Dynamic virtual channel
/u [<domain>\]<user> or <user>[@<domain>]
Username
/p <password>
Password
/d <domain>
Domain
/g
Gateway Hostname
/gu [<domain>\]<user> or <user>[@<domain>]
Gateway username
/gp <password>
Gateway password
/gd <domain>
Gateway domain
/load-balance-info <info string>
Load balance info
/app ||<alias> or <executable path>
Remote application program
/app-name <app name>
Remote application name for user interface
/app-icon <icon path>
Remote application icon for user interface
/app-cmd <parameters>
Remote application command-line parameters
/app-file <file name>
File to open with remote application
/app-guid <app guid>
Remote application GUID
/compression
Compression
/shell (null)
Alternate shell
/shell-dir (null)
Shell working directory
/sound
Audio output (sound)
/microphone
Audio input (microphone)
/audio-mode (null)
Audio output mode
/multimedia
Redirect multimedia (video)
/network (null)
Network connection type
/drive (null)
Redirect drive
/drives
Redirect all drives
/home-drive
Redirect home drive
/clipboard
Redirect clipboard
/serial (null)
Redirect serial device
/parallel (null)
Redirect parallel device
/smartcard (null)
Redirect smartcard device
/printer
Redirect printer device
/usb (null)
Redirect USB device
/multitouch
Redirect multitouch input
/echo
Echo channel
/fonts
Smooth fonts (ClearType)
/aero
Desktop composition
/window-drag
Full window drag
/menu-anims
Menu animations
/themes
Themes
/wallpaper
Wallpaper
/gdi <sw|hw>
GDI rendering
/rfx
RemoteFX
/rfx-mode <image|video>
RemoteFX mode
/frame-ack <number>
Frame acknowledgement
/nsc
NSCodec
/jpeg
JPEG codec
/jpeg-quality <percentage>
JPEG quality
/nego
protocol security negotiation
/sec <rdp|tls|nla|ext>
force specific protocol security
/sec-rdp
rdp protocol security
/sec-tls
tls protocol security
/sec-nla
nla protocol security
/sec-ext
nla extended protocol security
/cert-name <name>
certificate name
/cert-ignore
ignore certificate
/pcb <blob>
Preconnection Blob
/pcid <id>
Preconnection Id
/vmconnect
Hyper-V console (use port 2179, disable negotiation)
/authentication
authentication (hack!)
/encryption
encryption (hack!)
/grab-keyboard
grab keyboard
/toggle-fullscreen
Alt+Ctrl+Enter toggles fullscreen
/mouse-motion
mouse-motion
/parent-window <window id>
Parent window id
/bitmap-cache
bitmap cache
/offscreen-cache
offscreen bitmap cache
/glyph-cache
glyph cache
/codec-cache <rfx|nsc|jpeg>
bitmap codec cache
/fast-path
fast-path input/output
/max-fast-path-size
maximum fast-path update size
/async-input
asynchronous input
/async-update
asynchronous update
/async-transport
asynchronous transport (unstable)
/async-channels
asynchronous channels (unstable)
/wm-class <class name>
set the WM_CLASS hint for the window instance
/version
print version
/help
print help
/play-rfx <pcap file>
Replay rfx pcap file
/auth-only
Authenticate only.

EXAMPLES

xfreerdp connection.rdp /p:Pwd123! /f
Connect in fullscreen mode using a stored configuration connection.rdp and the password Pwd123!
xfreerdp /u:CONTOSO\\JohnDoe /p:Pwd123! /v:rdp.contoso.com
Connect to host rdp.contoso.com with user CONTOSO\\JohnDoe and password Pwd123!
xfreerdp /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:192.168.1.100:4489
Connect to host 192.168.1.100 on port 4489 with user JohnDoe, password Pwd123!. The screen width is set to 1366 and the height to 768
xfreerdp /u:JohnDoe /p:Pwd123! /vmconnect:C824F53E-95D2-46C6-9A18-23A5BB403532 /v:192.168. 1.100
Establish a connection to host 192.168.1.100 with user JohnDoe, password Pwd123! and connect to Hyper-V console (use port 2179, disable negotiation) with VMID C824F53E-95D2-46C6-9A18-23A5BB403532
+clipboard
Activate clipboard redirection
/drive:home,/home/user
Activate drive redirection of /home/user as home drive
/smartcard:<device>
Activate smartcard redirection for device device
/printer:<device>,<driver>
Activate printer redirection for printer device using driver driver
/serial:<device>
Activate serial port redirection for port device
/parallel:<device>
Activate parallel port redirection for port device
/sound:sys:alsa
Activate audio output redirection using device sys:alsa
/microphone:sys:alsa
Activate audio input redirection using device sys:alsa
/multimedia:sys:alsa
Activate multimedia redirection using device sys:alsa
/usb:id,dev:054c:0268
Activate USB device redirection for the device identified by 054c:0268

LINKS

http://www.freerdp.com/

AUTHOR

The FreeRDP Team
2017-07-28 freerdp