Support

Contact us

Contact us for more info on our products and licensing models!

tsprint KnowledgeBase

frequently asked questions for “tsprint”

How to install TSPrint?

Please follow the video instructions on how to install TSPrint.

How to map a TSPrint printer to another local printer besides the default printer?

(Minimum Version: 1.8.6.0) TSPrint is mostly used with two types of TSPrint printer: TSPrint Default and TSPrint Printer. The TSPrint Default printer will print everything to the local default printer without any dialogs. The TSPrint Printer in return will show each time a dialog where you can select the desired printer and its settings.

Now sometimes you would like to create a new printer and tell TSPrint to automatically transfer the printjob to another local printer besides the default printer.
This can be done with the new type of TSPrint printer named TSPrint User Defined. By default the TSPrint installation does not create such a printer.

To map a local printer to a TSPrint printer log-in to your terminal server and go to:
Start -> Programs -> TerminalWorks -> TSPrint Server -> Print Manager


This is the Printer Manager of TSPrint which enables you to create new TSPrint printers and assing them to different users or groups.


Now to create a new user defined printer which we can map to a local printer we press the green plus button on the lower left corner of the dialog. This will the show us the following dialog:


The new printer dialog enables to define the name and functionality of the tsprint printer.


Enter the desired name of the printer and under TSPrint Function select TSPrint User Defined. Now under the Printer Security field you can add different users or groups which should be able to see and print to this printer. If you leave this field empty then only YOU and the server Administrator will see this printer and be able to print to it.

After we save the new printer it should appear as any other printer in our list:



Now the first time you print to this printer a dialog will show up which will ask you to select the desired local printer. If another user on the terminal server prints to the same printer he will also receive this dialog the first time and he will able to select his local printer. By printing on the terminal server to the user defined TSPrint printer TSPrint will check if the user has selected a local printer to which print jobs should be transfered. In case he has not the earlier mentioned dialog will show up.


Here you select the desired local printer to which the server printer should be mapped to.


Now print to the printer and your print job will automatically be transfered to the earlier selected local printer. Using this scheme you can for examle create a new printer and assign to him form sizes of your local POS printer and each time when printing on the terminal server the print job with the correct form size will be printed on your local POS printer.

Do i need to configure anything to get TSPrint to work?

No. TSPrint is a plug and play solution. After the simple installation procedure (next,next,next)TSPrint will be ready to go. Compared to the standard way of supporting local printers our way needs just a fraction of the time required to enable clients to use their local printers.

How to use TSPrint on another local printer?

The TSPrint Default printer always prints on your default local printer. In case you wish to print on another printer please select the TSPrint Printer which will show you a print dialog where you can select the desired printer.

Do i need to install any drivers on my server?

There is no need to install any printer drivers on your server. You will be able to use TSPrint to print from your remote desktop on any printer that you have installed on your local computer. All types of printers are supported as long as you are able to print on them on your local computer. So you don't compromise the stability of the server by installing dozens of different printer drivers for each client workstation.

What ports does TSPrint require to work?

TSPrint uses the Microsoft Virtual Channels technology, so all traffic goes through the secured RDP connection. No need to forward or open any ports for TSPrint to work. It is really a plug and play solution.

TSPrint Communication Error

Please visit this link: Communication Error

Does TSPrint Server works on Windows XP,7 Terminal Server.

Yes, you can use TSPrint on Windows client operating systems, acting as remote desktop servers.

Can i use TSPrint over the internet?

Yes. You can use TSPrint both on a internet connection and your local area network. Now clients that work outside the office will be able to print out documents to their home printer without you having to first install that printer on your Terminal Services server.

My margins are a little bit off.

Please let the client login to the terminal server and then go to:
Start -> Programs -> TerminalWorks -> TSPrint Server -> Client Options/Options

A dialog should show up where you should change the Print Engine from Default to TSPrint Engine.
This should resolve this issue.

Important! Since version 1.9.0.0 of TSPrint you also have to select the Fit To Page option on the client dialog.

How to turn off the printer mapping of Microsoft

There are two ways you can disable this option. The first one would be to disable it globally on the terminal server by setting the right group policy. For more details about the please visit:

Printer Redirection

The second step would be to disable this locally on the workstation from which you connect. To do this please execute MSTSC.exe by going:
Start -> Run -> mstsc.exe

When the mstsc.exe dialog shows up click on the Options button on the bottom left side:



Now click on the Local Resources tab and uncheck the Printers box from the Local Devices and resources group.

TSPrint is always being the default printer. How can i change that?

TSPrint offers two different dialogs to configure the default printer. The first one is working on a per user basis and each individual user can set his own default printer by logging in to the terminal server and going to:

Start -> Programs -> TerminalWorks -> TSPrint Server -> Default Printer


If you wish to disable the defaulting of printers by TSPrint and leave it to Windows then select None as the default printer.

The second dialog is working on a per server basis and allows the system administrator to configure the default printer for all users on the terminal server. You can reach that dialog by going to:

Start -> Programs -> TerminalWorks -> TSPrint server -> Server Options


The server options dialog will allow you to select the default printer for all users on the terminal server. As with the per user default printer dialog here you can also select None to tell TSPrint to leave the defaulting of printers to Windows.

Do i need to reboot my server after installing TSPrint Server?

No. The product installation doesn't require any reboots before you can use it.

How to Install a Windows driver printer?

Sometimes, very special printers, which can also include special page sizes are hard to map with our virtual TSPrint printers. Results can be such as a blank page, bad positioning etc. Resolve is to create a Windows driver printer on the server side which will map local settings perfectly with our Windows driver printer.

To create a Windows driver printer, please follow the steps describe in this document.

Log in to your terminal server and open:
Start -> Programs -> TerminalWorks -> TSPrint Server -> Print Manager



Press the green "+" sign to add a new printer.



Name the printer as you wish, we named it TSPrint TEST in our example.



Select Windows Driver as a TSPrint Function.



Select the printer driver you installed to your Terminal Server. Make sure that you have correct drivers that corresponds to the actual printer installed at the client workstation. We used Epson FX-870 in our example.
Set up the security options as needed by adding new Users or Groups. You can do so by pressing the green button showing a "+" or the red button showing a "-" sign.



Set up the security options as needed by adding new Users or Groups. We added the Everyone Group in this example. Press OK to confirm.



Press Save to complete the process.

Now just print to the newly created printers and the printed pages should now properly print out.



How to install TSPrint on Mac?

Take a look at this short video tutorial on how to install the TSPrint Client for MacOS.

What can I change in the Client Options window?

TSPrint Client Options



Here you can change several options:

- Print Engine
Print engine defines the way data is sent to the printer. Changing this option can help you correct the errors with fauly margins, fonts and similar. If everything prints out OK, there is no need to change this option from the 'Default' value.

- Default Printer
Use the dropdown menu to select a printer you wish to use as the default one.

- Show Printer Settings
Selecting this option causes the printer's User Interface to be shown before printing.

- Map Settings
Selecting this option will allow you to set printer preferences when printing form the remote session and causing them to map to the local printer. If you do not select this option, and you set up some options (orientation for example) they will be discarded when printing takes place. In this case local printer preferences will be used.

- Print as Image
Selecting this option will result with the print job being printed out as a picture, instead of a group of characters. This may solve problems when fonts are not printed out correctly, but will cause larger print jobs and longer printing times.

- FitToPage
Selecting this option will result with the print result being enlarged or shrinked to the page size. You can use this option in case you experience problems withs margins.

- Printer Mappings
Custom printers created by Print Manager module of TSPrint Server will be shown here. Printers can be edited by pressing the 'Edit' button. You are able to delete the unwanted printer by pressing the 'Delete' button.

Save selected options and close the window by pressing the 'Save' button.

Pressing the 'Help' button will open TerminalWorks Support pages.

How to load a license

TSPrint license
Please try the following steps:
1) Connect to your Server side.
2) Go Start->All Programs->Terminal Works->TSPrint Server->License registration
3) Don't open the .license file! Just download it and remember the location
4) In the License registration select the "Load License File" button and select the license file from the downloaded location

Do i need to upgrade the client installations when upgrading the server installation?

No, there is no need for that as all versions of TSPrint are compatible with each other. The only drawback is that you will be missing the features from the current TSPrint client releases.

How can I change the Print Engine?

Changing the Print Engine

Connect to the terminal server through a remote session and open:

Open: Start -> All Programs -> TerminalWorks -> TSPrint Server -> Client Options

The following window will be shown on your screen:



Change the Print Engine using the dropdown menu as shown below. Select the print engine you wish to use and press the 'Save' button.



Tunneling TSPrint through multiple RDP sessions


Dear Reader, we would like to explain you how to Tunnel TSPrint through multiple RDP sessions.
We would like to show you an example to demonstrate its functionality:




The environment which is described in the picture above is an example on how to install TSPrint to achieve tunneling through multiple RDP sessions.
The most important part is to enable “Enable Session in Session” in the TSPrint Client Options on the "Middle Client".

The TSPrint Client Options can be found at: Start\All Programs\TerminalWorks\TSPrint\Client Options.




NOTE: “Enable session in session” must be enabled on the middle client only.

Adobe Reader X (10) crashes after installing TSPrint

This only happens in case you have installed Adobe Reader 10 but have not rebooted your server as requested by the Adobe installer.

Adobe Reader will then crash once you go to File -> Print. Once you reboot your server as required Adobe Reader X will work just fine with TSPrint.

This issue is only present in Adobe Reader 10.

If this does not resolve your issue then another bug could be causing this. To resolve it disable Enable Protected Mode at startup.

You can disable this by opening Adobe Reader and going to Edit -> Preferences. Now a new dialog shows up where on the left side you should make sure that General is selected. Once selected on the bottom of the dialog you should find the Enable Protected Mode at startup.

Does TSPrint offer an API?

Yes, you can use some of the TSPrint binaries to execute actions usually done through TSPrint. For example you can just execute the following command line command:
C:\PROGRAM_FILES\TerminalWorks\TSPrint Server\pdfwriter.exe open "YOUR_FILE"

This would then invoke the same procedure which you is done when you right click on a file and select TSPrint Open Locally.

Besides the open option you can also use:
-send - To send the file to the local workstation. (A file save dialog will appear)
-mail - To send the file as a new e-mail with the file attached to the e-mail.

Does TSPrint support Citrix?

Yes, TSPrint has full support for your Citrix based environment. Just install it as you would on a normal terminal server (RDP) environment and you will be able to use TSPrint.

Why are my documents printing out in a random order?

Random printing order

If your documents are not printing in the order they were sent to the printer, please open the printer properties of the TSPrint printer you are sending the print job to (TSPrint Printer, TSPrint Default or TSPrint PDF).

Under the 'Advanced' tab, check the box next to 'Print spooled documents first'.



After doing the above, your documents will be printed out in the correct order.

How to set default client printer is not the default printer in a session(Microsoft printer redirection)

The full path of this node in the Group Policy Management Console is: Computer Configuration\Policies\Administrative Templates\Windows Components\Terminal Services\Terminal Server\Printer Redirection This policy setting allows you to specify whether the client default printer is automatically set as the default printer in a Terminal Services session. By default, Terminal Services automatically designates the client default printer as the default printer in a Terminal Services session. You can use this policy setting to override this behavior. If you enable this policy setting, the default printer is the printer specified on the remote computer. If you disable this policy setting, the terminal server automatically maps the client default printer and sets it as the default printer upon connection. If you do not configure this policy setting, the default printer is not specified at the Group Policy level. However, an administrator can configure the default printer for client sessions by using the Terminal Services Configuration tool. Untitled

Does TSPrint work with Ericom Blaze RDP?

Ericom Blaze RDP

In order for Ericom Blaze RDP to be working with TSPrint or TSScan, you have to do the following:

Start Ericom Blaze RDP client and open the 'Local Resources' tab. Press the '3rd party addins' button.



Check the box next to TSPrint and/or TSScan and press the 'OK' button.



How to enable TSPrint Server logging

To enable logging, follow below steps:
1) Log in to your terminal server and open:
Start -> Programs -> TerminalWorks -> TSPrint Server -> Server Options.
2) Check "Enable Logging" checkbox.

Note that:
1) Log files will be created in %APPDATA%\TSPrint\logs folder. This means that every user will have separate log files.
2) Logging can be configured in LoggerSetting.ini located in %APPDATA%\TSPrint folder.

Option Description
Level Possible values are INFORM, MEDIUM and ERROR
MaxLogFile Maximum number of log files that will be created.
MaxFileSize Maximum size of one log file in megabytes.

When printing multiple documents the print order is invalid

When printing multiple documents and the print order is invalid on your printer you have to set the Print spooled documents first option on the TSPrint printer where you experience this issue.

This option can be accessed by right clicking on the TSPrint printer on your terminal server and selecting Printer Properties. After that click on the Advanced tab and check the option.

How to make TSPrint work in DOS?

Dear Reader,

DOS recognizes physical ports instead of printers, and since TSPrint installs virtual ports which cannot be recognized, by default TSPrint is not compatible with DOS applications.
Our solution is to map a physical port to a TSPrint printer.
There are two ways:

1) Run following commands in Command Prompt on the Server side for each user:

rundll32 printui.dll,PrintUIEntry /Xs /n "TSPrint Printer" Sharename "TSPrintPrinter"
rundll32 printui.dll,PrintUIEntry /q /Xs /n "TSPrintPrinter" Attributes Shared
net use lpt2 \\localhost\TSPrintPrinter -p

Listed commands make TSPrint Printer to act as a shared printer and then maps it to the LPT2 port. Furthermore, you can switch TSPrint Printer with any TSPrint Printer and switch LPT2 port with any free LPT port.

2) We created a simple .bat file, which must be applied on Server for each user.

Download link: http://www.terminalworks.com/downloads/tsprint/DOS.rar

Our batch file makes TSPrint Printer to act as ashared printer and then maps it to the LPT2 port. User will be able to use TSPrint Printer in DOS applications.

What is my default page size?

The Default page size depends on the Windows Region which is set during the Windows Installation.
When installing a new printer driver or adding a new printing device to your PC if the default
page size can be altered between letter and A4 it will depend on the region set on your PC.
The image below shows the default page size setting per region.



TSPrint ubuntu guide


When you downloaded 'tsprint.tar.gz' from our site, you will need to extract it in the terminal with 'tar xvzf tsprint.tar.gz'.
That will create a sub-directory named 'tsprint'. Go to that directory with e.g. 'cd tsprint'.
In that directory, run our rdesktop with './rdesktop -u -p ' - substitute the parameters with your own.
Note: In case you get an error stating that libcrypto is not the right version please download this package:
http://terminalworks.com/downloads/tsprint/linux/libcrypto.so.0.9.zip and place it in "home/usr/lib"

Does TSPrint support PCoIP?

Yes, TSPrint has full support for your PCoIP based environment. Just install it as you would on a normal terminal server (RDP) environment and you will be able to use TSPrint. Note that this is supported on Windows 7/Windows 2008 version and higher.

Need Additional Help?

In case you haven't found the answer to your question feel free to contact us using the form on the right side. We will answer all questions in less then 24 hours after we receive them.

Your Name: *
Your Email: *
Subject: *
Message: *
We provide support only in English.


License Expired?

Request a free trial license extension in case you need more time to evaluate our product. You will receive your new trial license shortly after you fill out the application.

Partner Program

Cloud services and managed services providers can benefit with our products.
The TerminalWorks Partner Program enables you to buy license packages of TerminalWorks products and resell them.

Contact information

Tehnical Support Phone:
+14077451844
Sales Phone:
+14157997852
Telephone support available from 10 AM till 10 PM CET

Home | Support | Terms & Conditions | Privacy | Blog | About Us | Customer Login

Copyright © 2017 TerminalWorks. All Rights Reserved