Call us:+1 (407) 567-0096
Open a ticket
Chat with us
En De Es


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: 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.

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.

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.

TSPrint Communication Error

Please visit this link: Communication Error

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.

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 of TSPrint you also have to select the Fit To Page option on the client dialog.

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

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.

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 install TSPrint on Mac?

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

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.

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.

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.

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.

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 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 mode in the Group Policy Management Console on Server 2003/2003R2:
"Computer Configuration\Policies\Administrative Templates\Windows Components\Terminal Services\Terminal Server\Printer Redirection"

and Server 2008/2008R2/2012/2012R2/2016:
"Computer Configuration\Policies\Administrative Templates\Windows Components\Remote Desktop Services\Remote Desktop Session Host\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.

The policy has 3 options.
Enabled->The default printer is the printer specified on the remote computer.
Disabled->The terminal server automatically maps the client default printer and sets it as the default printer upon connection.
Not Configured->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.

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.

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:

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.

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 add support for RD clients in MAC

Firstly we need to find out the version build of the client you use to connect to the server, to do so connect from the MAC to the server using administrator credentials. Then open Server Options of TSPrint and enable logging for Print.

Now try to print and reproduce the issue, this will generate the logs on the server in "C:\Users\USER_NAME\AppData\Roaming\TSPrint Server\logs\DOMAIN_NAME.USER_NAME-0.dbg.log".
Open the log file and locate ClientBuildNumber this is the information you need.

Now navigate to "C:\Program Files (x86)\TerminalWorks\TSPrint Server"
Open mac_clients.ini file in the Notepad.

Add the following information:
BuildNumber= here enter the ClientBuildNumber from the logs

Save the file and try to print again.

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.

Why is my print window going behind the session on my MAC?

To resolve this issue caused by the latest Microsoft Remote Desktop application version, please follow the steps below:

1. Make sure you're running the latest version of the TSPrint Client as well as the TSPrint Server.
You can download the latest client version here.
And the server version here.

After you have installed the latest version, before you connect to the remote session, please do the following:

2. Open the Microsoft Remote Desktop application and click on the small edit button as marked on the image below.

3. Redirect the TSPrintDrive folder into the remote session by clicking on a "plus" sign in the bottom left corner, as marked on the image below. Make sure to select the folder called TSPrintDrive located in your Documents folder. Click on "Save."

That should do the trick. Now connect to the remote session and start printing!

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.

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: and place it in "home/usr/lib"

Can TSPrint be used on Chromebook or Android?

Yes, Chrome OS and Android are fully supported.
You can download the TSPrint client application directly from the Google Playstore:

Click here to download TSPrint Client

As always, just make sure that you have both parts of the TSPrint installed - server part on the remote desktop server and the client part, in this case, on your Chromebook or Android mobile phone/tablet.

TSPrint Server part or higher is required.

How do I install and use TSPrint on my Chromebook?

TSPrint client installation is very simple (as always) in this case:

1. Download and install TSPrint Client on your Chromebook or Android phone/tablet
You can download it from the following link: Click here

2. Make sure TSPrint Client application is running in the background
Once the application has been installed from the Google Playstore, simply open it up and keep it open in the background.

3. Set up folder redirection
Before connecting to the server using any remote desktop application of your preference, make sure to enable the folder redirection so the TSPrint can communicate with your mobile phone without any issues. For example, in the picture below, we have enabled the folder redirection in the Microsoft Remote Desktop application.

4. Connect to the server and start printing
Once the folder redirection has been set up, connect to the server and print to one of the TSPrint virtual printers. As all of our virtual printers will behave the same when printing from mobile app, we would recommend printing directly to TSPrint Printer

Once the print job has been initiated, the following notification will arrive on your mobile phone or Chromebook. All you have to do is tap on it and then select the print jobs you wish to print (you can print all or one by one).

That's pretty much it. You're now all set for printing. Enjoy!

Copies in Microsoft Word don't work

Microsoft Word had a bug, which resulted that you cannot get a copy functionality working, including TSPrint. The resolve: On the Server, click Start, click Run, type regedit in the Open box, and then click OK. Locate and then select the following registry subkey: HKEY_CURRENT_USER\Software\Microsoft\Office\14.0\Word\Options On the Edit menu, point to New, and then click DWORD (32-bit) value. Type ForceSetCopyCount, and then press Enter. In the Details pane, right-click ForceSetCopyCount, and then click Modify. In the Value data box, type 1, and then click OK. Exit Registry Editor.

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

Technical Support Phone:
+1 (407) 567-0096
Sales Phone:
+1 (407) 567-0097
Telephone support available from 10 AM till 10 PM CET

This website uses cookies

This website uses cookies to improve user experience. By using our website you consent to all cookies in accordance with our Cookie Policy.
Read more

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

Copyright © 2020 TerminalWorks. All Rights Reserved