PTOUCH-PRINT(1)

NAME
ptouch-print - a command line tool to use Brother Ptouch label printers

SYNOPSIS
ptouch-print [options] <print command options>

DESCRIPTION
ptouch-print is a command line tool that can be used to print labels with several Brother Ptouch label printers.

OPTIONS
General options, font selection options and optput options are valid for the whole printout and should be given only once. Each duplication will override the previous argument value. Any of the printing command options can be given more than once in any order, and will be executed in the given order.

  General options

--debug
    Enables printing of debugging information.

--timeout <time>
    Set the seconds ptouch-print is waiting for finishing a previous ptouch-print command. Default is 1 second. 0 (zero) means wait forever. Useful if ptouch-print is used in a script multiple times, and the device is waiting for the user to use the mechanical cutter.

  Font selection options

--fontmargin <size>
    When auto-detecting font size account for a margin above and below the text.

--fontsize <size>
    Disable auto-detection of the font size and force the font size to the size given as argument. Please note that text will be cut off if you specify a too large font size here.

--font <fontname>
    Set the font to the fontname given as argument.

  Output control options

--writepng <file>
    Instead of printing to the label printer, write the output in a PNG image file (which can be printed later using the --image printing command option).

  Printing command options

--text text
    Print the given text at the current position. Text including spaces must be enclosed in question marks. Literal '\n' or actual newline characters in the text will be treated as line breaks. To print a text in multiple lines, either use '\n' or use the -n argument. Also see the EXAMPLES section.

--image image.png
    Print the image file at the current position. The image file must be a two color, palette based image in PNG format.

--cutmark
    Print a cutmark (dashed line) at the current position.

--pad <n>
    Print <n> pixels of white space at the current position. Useful for printers that would otherwise cut off parts of the printed text or image.

  Getting help and display information

-?, --help
    Print a help message and exit.

--version
    Display version information and exit.

--info
    Show info about the tape detected (like printing width etc.) and exit.

--list-supported
    List all supported printers

DEFAULTS
The default font used is 'DejaVuSans'.

The default fontsize is auto-detected, depending on the used tape width and font.

EXIT STATUS

0   Successful program execution.

1   Usage syntax error.

5   Printer device could not been opened.

EXAMPLES

ptouch-print --text 'Hello World'
    Print the text 'Hello World' in one line

ptouch-print --text 'Hello' -n 'World'
    Print the text 'Hello World' in two lines ('Hello' in the first line and 'World' in the second line).

ptouch-print --image icon.png
    Print the image contained in the PNG image file 'icon.png'. The image file must be palette based PNG format with two colors.

AUTHOR
Written by Dominic Radermacher (dominic@familie-radermacher.ch). Also see https://dominic.familie-radermacher.ch/projekte/ptouch-print/