There are two ways to use the URL Label server to print labels - interactive and batch.

Interactive
To manually input and print labels:

• Use a computer, phone, or device on the same network as the computer running the URL Label server.
• Start an Internet browser like Chrome, Safari, etc.
• In the browser address bar, type in the ip address that was displayed in white when the URL Label server was started.
• The following label input screen should appear.

• Complete the Name and Id fields with any information.
• If Barcode is set to Yes then the Id will be printed as a barcode on the following line.
• If DateTime is set to Yes then it will be printed on the label above the name.
• If the title was configured then an additional blank appears allowing selection or suppression of the title.
• Click Print to print the label on the label printer connected to the URL Label server computer.

If the label input screen does not appear the likely causes are:

• Using the wrong ip address or optional port number. Check that it matches the ip address displayed when the URL Label server was started.
• You are not connected to the same network as the computer running the URL Label server. Are you running a device that needs to be connected via local wifi?
• The URL Label server isn't running on its computer.
• The firewall on the URL Label server computer is blocking you.

Use the Log button to view the history of the printed labels. It is expected that custom label interfaces will be added.

Batch
There are two ways to run in batch - from an URL or the command line.

Batch URL
To print a batch label by URL use this format:

...http://serverIpAddress/format/line1/line2/line3/...

Substitute the ip address of your URL Label server. Substitute the label text for line1, line2, ... If your URL Label server was configured to use https, use https instead of http and your domain name in place of the server IP address.

Use the format parameter to indicate the format of the label text. This is typically ascii so use either ascii or label to indicate the input is standard ascii text. But if the input label text is formatted as epl or zpl, then use epl or zpl for the format parameter.

Don't send more lines than will fit on the label. The URL can be submitted via the address bar of a browser or sent with commands like curl. Example of a possible batch URL:

URLs are not allowed to have spaces in them. So an encoding system is used called "escaping" which turns spaces to %20 as above. At the server the %20s are converted back to spaces. The batch client command below eliminates this issue.

Batch client command
An URL Label client command is available for download. The client can be run manually from the command line or called from applications to integrate label printing. Using the client avoids the need to obtain and learn curl. The Windows and Linux versions of the server and client are compatible.

The client is called urllabcl.exe on Windows and urllabcl on Linux. The command syntax is:

...>urllabcl [-epl|-zpl] [-s] [-v] ipAddress "line1" "line2" "line3" ...
...>urllabcl [-epl|-zpl] [-s] [-v] ipAddress < inputFileName

• The first example shows the label text being provided as command line arguments. The second example shows the label text being provided as a file.
• The ipAddress and line1, or file input, is required.
• The format of the label text defaults to ascii. If the label text is already formatted to epl or zpl then indicate that by adding the -epl or -zpl option.
• The ipAddress can also be a domain name with optional port.
• The label text lines should be enclosed in double quotes in case they contain spaces or special characters. Use "" for blank lines.
• If the server is using https then add the -s option so the client uses https instead of http.
• Add the -v verbose option to see run-time information.

The urllabcl client assembles the batch URL above and submits it to the URL Label server. It also encodes characters that would cause the URL to fail, like having a / as part of the text to be printed.

If the URL Label client command succeeds it returns 0, if it fails it returns 1, which is standard. The URL Label client also returns the server result as a string which is displayed on stdout so it can be captured. If it begins with 0 then that indicates a failure at the server. If it begins with 1 then that indicates the label was successfully printed.

Next: Configuration, Contents