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

\m[blue]http://www.freerdp.com/\m[]

AUTHOR

The FreeRDP Team