Please follow the video instructions on how to install TSPrint.

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

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.

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.

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.

Please visit this link: Communication Error

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.

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

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.

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.

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

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

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

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.

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.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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"

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:
[client_NEXT_NUMBER_IN_LINE]
BuildNumber= here enter the ClientBuildNumber from the logs
Directory=
productID=1

Save the file and try to print again.

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 1.7.0.5 here.
And the server version 3.0.6.11 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!