server=192.168.1.1
server=ts1.local
server=ts3.local:4000

server=vi:192.168.1.5
server=xpu:tsxpu3.local:5000

server=192.168.1.1,NLA

server=192.168.1.6;192.168.1.7;
server=xpu:tsxpu1.local,tsxpu2.local,192.168.1.11:5000

server=--new--

server=192.168.1.1,--new--

application = chrome

application = vlc

application = shutdown

application = reboot

connection
server=192.168.1.1
displayName=RDP Connection
connection
application=shutdown
displayName=Turn off the computer

autostart_delay = 60

Automatically starts connection in 60 seconds (value specified in autostart_delay= option), if user won't press any keys and won't move mouse.

1. Definite values. The values you won't set user will have to specify in login window. Parameters user and domain are used:

   user = vasyapupkin
   domain = MYDOMAIN

   Also you can specify password:

   user = petja:password

2. Selection from menu.User can select login parameters from menu. Possible values for login parameters:

   DOMAIN\user[display_name]:password
   DOMAIN\user:password
   user[display_name]:password
   user:password
   DOMAIN\user[display_name]
   DOMAIN\user
   user

   display_name - is the to display in menu. When display_name is not specified user name is displayed in menu. These blocks are separated by semicolons. For example, this line creates menu with 5 items (users vasja and peter from DOMAIN2, basil's password is 'joke', john's password is '1'):

   user = DOMAIN2asil[Basil Washington]:joke;DOMAIN2\peter;john:1;july;Guest;--new--

   Keyword --new-- tells terminal to leave username empty. You can create as many items as can be placed on the screen. Terminal automatically shows them in columns.

user = vasya; peter; john; --only-listed--

shell = c:\windows\system32\cmd.exe

shell = C:\Program Files\Microsoft Office\Office10\winword.exe "c:\temp\document 1.doc"

By default Windows Server restricts running arbitrary programs. To make shell work you should add this program into RemoteApp Manager (remoteprograms.msc) list.

Another way: in policied you may allow to run arbitrary program. Run gpedit.msc, Computer Configuration, Administrative Templates, Windows Components, Remote Desktop Services, Remote Desktop Session Host, Connections, Allow remote start of unlisted programs.

To make sure that server is configured to sun needed program, create on Windows computer test.rdp file containing one line:

alternate shell:s:c:\windows\system32\calc.exe

Start this file in Windows. mstsc.exe will start and try to execute specified program. If instead of calculator you'll receive error, configure Windows Server as mentioned above.

shell = ||RMySuperRemoteApp

directory = c:\windows\temp

keyboard parameter determines default keyboard language in "Windows login" window and keyboard layout in RDP session. This parameter works only inside RDP session in Windows interface. Keyboard for login and password dialogs in WTware interface and for local Chromium is determined by language parameter. Keyboard for VNC client is determined by vncclient_keyboard parameter.

Default value is english layout ("en-us"), also you can set german:

keyboard = de

Or any other from listed below:

Also US International layboard layout may be specified, it grave in a different way:

keyboard = en-us-int

keyboard = pt-br-int

To turn on Japan IME layout set in configuration file:

keyboard = ja-ime

keyboard = 0xb0060409

HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\Keyboard Layouts

numlock = off

graphic = abcdefg

graphic = a

Windows 2003 Server shows desktop wallpaper only if you set to "Disabled": Start > Run > gpedit.msc > Computer configuration > Administrative templates > Windows components> Terminal services > Enforce removal of remote desktop wallpaper.

graphic = disable-gfx
graphic = disable-h264

loadbalanceinfo:s:tsv://MS Terminal Services Plugin.1.NameSC

loadbalanceinfo = tsv://MS Terminal Services Plugin.1.NameSC

rdpcompression = on

scale_factor = 125

The scale factor (as a percentage) applied to Windows Desktop Applications. Possible values: 100 (default), 125, 150.

Remote Desktop Gateway. will be done in the next version.

In order to set VNC client keyboard layout specify vncclient_keyboard. RDP client keyboard layout is set by keyboard option. Keyboard layout for WTware login dialogue and for local Chromium is set by language option.

By default WTware sends keys scan-codes. It works for VNC server, embedded into VMware Player and VMware Workstation. For VNC servers, that you install on Windows (UltraVNC, TightVNC), symbols, not scan-codes, should be sent. Num Lock should work with this setting:

vncclient_keyboard = en

chrome_url=http://wtware.com/doc.html

chrome_mode = window

chrome_mode = kiosk

chrome_mode = kiosk-nopointer

chrome_language = nl

chrome_profile=empty

chrome_pac=http://192.168.1.1/proxy.pac

chrome_proxy=192.168.1.1:3128
chrome_proxy="https=proxy1:80;http=socks4://baz:1080"

chrome_share=\\10.1.2.3\sharename

chrome_share=\\10.1.2.3\sharename, user vasja, password 123

chrome_share=\\10.1.2.3\sharename, ro

chrome_share=\\10.1.2.3\sharename, vers 1.0

chrome_camera=on

vlc_cmdline=-I dummy rtsp://10.1.1.32:8556/6

vlc_files=background.jpg,vlm.txt

vlc_restart=4

vlc_timeout=off

One of terminal server settings: in group policy (Start -> Run -> gpedit.msc) goto Computer Configuration -> Administrative Templates -> Windows Components -> Remote Desktop Services -> Remote Desktop Session Host -> Device and Resource Redirection and specify policy "Do not allow drive redirection" to "Disabled".

disk = cdrom

disk = usb

disk = usb(r/o)

disk = cdrom;usb(r/o)

shared_disk = cdrom

shared_disk = usb

shared_disk = usb(r/o)

shared_disk = cdrom;usb(r/o)

There are four ways of using printer that is connected to terminal. They are managed by printer=, rdp_printer=, vhusb= and usb= parameters. Select the most suitable for you and use it. For more details read article about printers.

Possible parameter values:

printer = lpt1

printer = usb

printer = usb(1234:abcd), usb(5678:cdef)

printer = usb(delay 300)

printer = com1

printer = com1(38400)

Terminal with attached printer should have fixed IP address. For more details about how to make Microsoft DHCP to give fixed terminals addresses see this article. About printer drivers installation on the server read at this article.

How to print from DOS on terminal read here

WTware terminal emulates HP JetDirect hardware print-server (hardware print-server is a small box, that connects computer network and printer). With WTware terminal:

• work all printers able to work with hardware print-server HP JetDirect (as well as with any other print-server, all hardware print-servers are HP JetDirect copies),
• work all printers which drivers are included into Window distributive,
• work all printers able to print from DOS without additional drivers,
• don't work so called Win-printers. Some of win-printers: HP 700c, 820c, 1000c, 3300c, 3400c, DJ 820cxi, LJ 3100; Canon LBP-250/810/1110/1120/1210/2410; Epson LP1300,EPL 5800/2050+/6200L, C900; Lexmark X5150;Dell A920/940/960, J740; Minolta 1350W/1250W/2300W.

Up to 4 printers can work on the terminal. Blocks containing each printer data are separated by semicolons. 2nd printer uses port 9101, 3rd printer uses port 9102 and 4th printer uses port 9103. If you connect more than one printers of the same type (lpt1 and lpt2, or usb and usb), then check experimentally physical naming order by printing test pages.

printer  = lpt1;lpt2;usb;com1(38400)

To turn on printer debug information logging specify in configuration file:

printer = usb, debug

Send full terminal log to support@wtware.com. In this mode a lot of debug messages will be saved into terminal log. Turn on only when needed.

There are four ways of using printer that is connected to terminal. They are managed by printer, rdp_printer, vhusb= and usb= parameters. Select the most suitable for you and use it. For more details read article about printers.

rdp_printer=HP LaserJet 1020

rdp_printer=HP LaserJet 1020:usb 03f0:2b17

rdp_printer=auto

rdp_printer=TSC TDP-225:com1

rdp_printer=HP LaserJet 400 MFP M425dn:tcp 192.168.1.50:9100

rdp_printer=HP LaserJet 400 MFP M425dn [Printer at reception]:tcp 192.168.1.50:9100

rdp_printer=HP LaserJet 1020:usb 03f0:2b17, HP LaserJet 1022:usb 03f0:2c17, TSC TDP-225:com1, HP LaserJet 400 MFP M425dn:tcp 192.168.1.50:9100

To turn on debug information logging specify in configuration file:

usb=0403:6001, debug

Send full terminal log to support@wtware.com. In this mode a lot of debug messages will be saved into terminal log. Turn on only when needed.

sound = on

sound = on, hw:1:0

Specify sound=on and reboot terminal. On terminal web-interface you'll see the list of all sound devices, that terminal has drivers for, and buttons for testing sound.

sound = oss

sound = remote

sound = on, stereo

sound = on, raw

Terminal sound level:

sound_level = 50

Possible values - from 0 (sound muted) to 100 (maximum level). You may show volume control in popup window:

sound_level = 75, infobox

Drivers for some sound cards can't manage hardware sound level. In such cases you can use software sound level control:

sound_control = sw

Some drivers for some sound cards set sound speed incorrectly. For example old AMD Geode GX1 (Cyrix Kahlua). As a result sound is much faster then it should be. To correct it we added parameter sound_rate. Specify one of the next values in configuration file:

sound_rate = 32000
sound_rate = 44100
sound_rate = 48000

sound_buffer = 300

Possible values - from 50 (minimal) to 500 (maximum).

Microphone redirection. Supported only by Windows 7 Ultimate, Windows Server 2008r2 and newer:

microphone = on

USB microphone (only microphone without headphones):

microphone = on, hw:1:0

Terminal microphone sound level:

microphone_level = 50

Possible values - from 0 (microphone muted) to 100 (maximum level). You may show volume control in popup window:

microphone_level = 100, infobox

serial = com1

serial = com1;com2

serial = com1(usb)

If you need to redirect two or more devices with USB to Serial converter, you should specify USB ID (unique USB device model ID, it's common for similar USB to Serial adapters) or bus ID (physical USB connector address on computer) for each of these devices. Terminal needs to determine corresponding port for each device. Connect all needed devices to terminal. Boot terminal. On another windows-computer in network open web-browser and enter terminal IP in address line. In "USB Bus" section you'll see list of all devices, USB ID (marked green) and bus ID (marked orange) of each device. Syntax of serial= parameter in such case is:

serial = com2(usb 0403:6001), com3(usb 0c2e:0720), com6(usb 11ca:0207)

Or for bus ID (Do not mix! Specify either USB IDs of all devices or bus IDs of all devices):

serial = com1(usb 2-1.1), com3(usb 1-1)

Some USB devices represent two COM ports. It is configured so:

serial = com1(usb), com2(usb second)

Some advanced programs require COM-ports' names for different terminals to be unique. To work with these programs specify in configuration file:

serial = com25(com1),eklmn10(com2),com45(usb)

This line redirects com1 port from terminal, it will be named com25 on server. com2 terminal port on server will be named eklmn10 (yes, it's possible). Connected to USB device with com-usb interface (barcode scanner, receipt printer, scales etc.) on server will be named com45.

Redirected by RDP COM ports are not displayed in Device Manager! To make sure, that everything is right: connect to terminal server, start command line prompt and execute change port command. Correct result is (redirected COM1 port):

COM1 = \Device\RdpDrPort\;COM1:1\\tsclient\COM1
COM11 = \Device\Serial0
COM12 = \Device\Serial1

To turn on debug information logging specify in configuration file:

serial = com1, debug

Send full terminal log to support@wtware.com. In this mode a lot of debug messages

In this mode a lot of debug messages will be saved into terminal log. Turn on only when needed.

ser2net = com1 115200
ser2net = usb 9600
ser2net = usb 0c2e:0720 9600 NONE 1STOPBIT 8DATABITS XONXOFF LOCAL -RTSCTS

USB ID, BUS ID and serial number of the USB device (if there is one, not every USB device manufacturer identifies devices by serial number) can be found on terminal web interface.

scanner = on

To turn on debug information logging specify in configuration file:

scanner = on, debug

Send full terminal log to support@wtware.com. In this mode a lot of debug messages

In this mode a lot of debug messages will be saved into terminal log. Turn on only when needed.

To redirect smartcards to terminal in configuration file specify:

smartcard = etoken

Terminal can understand 2 or three (not more than three) card types:

smartcard = etoken, rutoken, omnikey

Next devices are supported:

• auto - Autodetect connected reader
• etoken - eToken 72K Java (0529:0620)
• jacarta - JaCarta, JaCarta LT (24dc:0101, 24dc:0102)
• rutoken - Rutoken ECP, lite, iBank2 A (0a89:0060, 0a89:0030, 0a89:0025)
• acr122 - ACR122 (072f:2200)
• acs - ASC CCID USB (072f:90cc)
• acr128u - ACR1281U (072f:2224)
• acr3901u - ACR3901U (072f:b000)
• acr39u - ACR39U, some devices are not supported (072f:b100)
• acr38u - ACR38U (072f:9000)
• ezzccid - EZCCID, EZ100PU (0ca6:00a0)
• gempctwin - Gemplus (08e6:3437)
• gempckey - Gemplus (08e6:3438)
• ibank2_blue - iBank2Key blue token (23a0:0002, 23a0:0004)
• omni1021 - OMNIKEY CardMan 1021 (076b:1021)
• omnikey - OMNIKEY (076b:5321)
• omni3021 - OMNIKEY (076b:3021, 076b:3022)
• omni3x21 - OMNIKEY (076b:3031)
• asedrive - ASEDrive (0dc3:1004)
• multisoft - MultiSoft SCR2 (2a0c:0001)
• trustscreen - BIFIT Trustscreen (23a0:0005)
• watchdata - Watchdata (163c:0407, 163c:0417)
• cryptomate64 - ACS CryptoMate64 (072f:90db)
• esmart - ESMART Token (2ce4:7479)
• safetouch - SafeTouch (24a2:0102)
• identive_5710 - Identive CLOUD 2700 F (04e6:5710)
• angara - BIFIT ANGARA (23a0:0008)
• starsign - G&D StarSign (1059:0017, 1059:0019)
• vdtoken - vdToken (2bb1:0f10)
• avtor - Avtor (15cf:0019)
• ezio - Gemalto Ezio Shield (08e6:34c0, 08e6:34c1)
• dell - Dell Keyboard (413c:2101)
• kobil - Kobil Smart Token (0d46:3014)
• minilector - Bit4id miniLector EVO (25dd:3111)
• avbign - AVEST AvBign (28a1:0601)
• scr3311 - SCM SCR3311 (04e6:5116, 04e6:511d)
• au9540 - Alcor AU9540 (058f:9540)
• ePass2003 - Feitian ePass2003 (096e:0807)
• ePass2003Auto - Feitian ePass2003Auto (096e:080a)
• scr301 - Feitian SCR301 (096e:0503)
• acr1252 - ACR1252 (072f:223b)
• almaz1c - IIT Almaz-1C (03eb:9324)
• JCR721 - Aladdin JCR721 reader (24dc:0428)
• yubikey_ofc - YubiKey OTP+FIDO+CCID (1050:0407)

Terminal may autodetect smartcard reader, if it's from the list of supported readers and is connected before terminal turned on:

smartcard = auto

Only one smartcard can be redirected, two cards at once can't be redirected.

To turn on debug information logging specify in configuration file:

smartcard = etoken, debug

Send full terminal log to support@wtware.com. In this mode a lot of debug messages will be saved into terminal log. Turn on only when needed.

clienthostname = terminal1

clienthostname = ca*MAC

clienthostname = wt*IP1

clienthostname = wt*IP3

turnoffmenu = on

turnoffmenu = always

turnoffmenu = on,msg:Turn it off NOW!

turnoffmenu = poweroff

autoshutdown = 5

sleep = 10
sleep = 20,standby

infobox = lctrl
infobox = rctrl
infobox = lalt
infobox = ralt
infobox = lshift
infobox = rshift
infobox = never

infobox = nomac

infobox = noinfo

infobox = ralt,noinfo

infobox = shutdown

infobox = reboot

screenswitch = Win-Ctrl-N

screenswitch = none

onerror = 60

onerror = quiet

redraw_delay = 50

connect_timeout = 5..60

TCP keepalive timer configuration, it determines when to drop connection if network link broke:

keepalive = 10,3,5

Better not to change this parameter. Numebers - TCP_KEEPIDLE, TCP_KEEPINTVL, TCP_KEEPCNT - are described in TCP/IP documentation. By default =on, is the same as =10,3,5. With these settings terminal will show that link is broken in 10 + 3 * 5 = 25 seconds. To turn off this timer specify:

keepalive = off

Firmware for drivers.

Load and launch external files.

language = de, default

keyswitch = alt-shift

clipboard = on

ask_password = on

ask_password = nopin

ask_password = username:Nom d'utilisateur, password:Mot de passe

Animation speed during switching screens:

animation_speed = 3

timezone = hawaii

timezone = local:America/Sao_Paulo

timezone = hawaii, local:Pacific/Honolulu

ntp = pool.ntp.org

ntp = disable

• menu.png - background for server selection menu, user selection menu login window.
• wait.png - background for wait screen with "Please, wait" text.
• saver.png - screensaver.
• popup.png - logo for popup window in right bottom corner. If there's custom logo, WTware logo and version won't be printed. Size should be not more than 280х38 pixels.

C:\Program Files (x86)\WTware\TFTPDROOT\Graphic\sample\

skin = sample