Got feedback or spotted a mistake?

Leave a comment at the end of this page or email

Label printing configuration


OpenSpecimen supports printing labels for specimen. On configuring printing, OpenSpecimen generates the labels as CMD or CSV files on the file system. Printer software like NiceLabel/Bartender can be configured to read and print these files in an automated fashion.

OpenSpecimen print rules support is very flexible. It supports:

  • Different types of label types
  • Different formats for different rules
  • Different folders for different rules

For configuring the printing in OpenSpecimen please refer configuration section.

Below is the block diagram of the workflow:


Q: Which printers and scanners are supported by OpenSpecimen?

OpenSpecimen works with any printer or scanner. The interaction with the printer is done via printer software which is explained below.

Q: Which printer software should we use?

A: BarTender and NiceLabel are two well known options. You are free to choose any other option as long as they support automated printing. Most of them follow similar approaches and should work with OpenSpecimen.

Q: Does any user that would like to print labels from OpenSpecimen would need a separate printer?

A: No. There could be a single printer for multiple users based on the group/network requirements. If using multiple printers, it can be configured in the automation software to read the labels and send them to different printers as per the requirement.

Q: How to configure OpenSpecimen to generate labels for multiple printers?

A: One can create different rules based on the collection site, IP address. For each rule you can specify a different directory for property 'Output Directory'. Then configure the automation software to link the different directories with appropriate printers.

Q: Can only one user print per CP or do we create multiple lines for each person who would print in that CP?

A: Any number of users can print. Rules are not based on user. Ignore this field, this is just a legacy from old print rules which we are checking if we really need it.

Q: How is IP address of users used?

A: You might need to configure the same user to print to different printers located at different sites or buildings. E.g., there are two printers in two floors. Use Joe needs to print to first floor's printer when he is on the first floor and second floor's printer when he is on the second floor. This can be achieved using the IP addresses or ranges. 

You can configure printing based on IP addresses of users. E.g. some sites assign dynamic IP addresses based on location of users. You can specify range of IP address. You can leave this blank if you do not want to use this feature.

Q: Are values for label types dictated by the printer software?

A: No. It is just configurable keywords that you configure in the printer software and then use it in the rules. Example include whether label is printed for cap or slide etc

Q: Are label designs dictated by the printer?

A: No. This is same as above. However, historically, this has been used to specify the path of printer label design template

Q: How to handle printing from remote sites?

For sites which will operate OpenSpecimen remotely from multiple geographical locations, below are the options to handle printing:

Option 1: Via shared folder on the cloud like DropBox

For example, when user prints from 'Site A', OpenSpecimen sends label information into DropBox/SharedFolderA. BarTender is installed on a cloud server which is listening to this DropBox folders. The printers should also be accessible on the cloud so that BarTender is able to route the printing job to specific printer. 

Option 2: Download printed labels file CSV from OpenSpecimen UI

By enabling 'Download Labels Print File' in 'Settings' of OpenSpecimen, users can download the CSV with labels information to be printed. This CSV can be manually fed to printer to print labels. Refer to 'Download specimen labels print file' section in 'Print Rules' wiki page for more details. 

Q. Bartender Videos

Refer to the files below for help setting up a File Integration:

Also, we have two webinar with additional information: 

Q Sample output files

  1. Sample file in CSV format.
  2. Sample file in CMD format.


Step 1: Configure what needs to be printed on the specimen label

OpenSpecimen uses print rules to decide the contents of the specimen label. Refer to Print Rules for more details. 

Step 2: Configure printer software to read generated labels

Based on print rules, label files are creates as CMD or CSV files and saved in directory identified by 'Output Directory' value specified in the rules.

Printer software like Bartender/NiceLabel can be configured to poll the 'Output Directory' at periodic intervals for new files and print labels. 

Sample Specimen Label Formats 

Example 1: Label printed with barcode, specimen label and location

Example 2: Label printed with barcode and specimen label

Example 3: Label printed with site name, barcode and specimen label

Got feedback or spotted a mistake?

Leave a comment at the end of this page or email