tpsr3700

Linux and macOS driver for the KING JIM TEPRA PRO SR3700P label printer.

Print text labels directly from the command line — no Windows, no vendor software required.

Japanese / 日本語版は下部にあります。 → 日本語 README

Disclaimer: This project is independent and is not affiliated with, endorsed by, or supported by KING JIM Co., Ltd. Please do not contact KING JIM regarding this software.

Features

Print arbitrary text on 6 mm, 12 mm, and 18 mm tapes
Auto-detect the loaded tape width by querying the printer
Auto-select the largest font size that fits the tape
Multi-line printing via explicit \n line breaks — works with or without --max-tape-length-mm
Wrap-to-length: wrap text to a fixed label length, with a configurable maximum line count derived from the tape width (minimum line height: 3 mm)
Left / center / right alignment per line (with --max-tape-length-mm)
Dump the raw job bytes to a file (useful for debugging without hardware)
SVG print preview before sending the job to the printer (shown by default; --skip-preview to bypass it)

Requirements

Rust toolchain (edition 2024)
libusb:
- Debian/Ubuntu: sudo apt-get install libusb-1.0-0-dev
- macOS: brew install libusb

No font installation is required — BIZ UDPゴシック Regular is bundled directly in the binary. To use a different font, pass --font <PATH> with any .ttf/.otf/.ttc file.

Build

cargo build --release

The preview feature (SVG print preview, see below) is enabled by default. To build without it, use:

cargo build --release --no-default-features

Usage

tpsr3700 [OPTIONS] <TEXT>

Options

Option	Default	Description
`--tape-mm <MM>`	auto-detect	Tape width in mm. Supported: `6`, `12`, `18`, and experimental `24`. Omit to query the printer.
`--size <PT>`	auto	Font size in points (as shown in the TEPRA app, e.g. `36`). Omit for the largest size that fits.
`--left-margin-mm <MM>`	`10.0`	Blank feed margin (mm) added before the printed content (left side as the label exits the printer).
`--right-margin-mm <MM>`	`3.0`	Blank feed margin (mm) added after the printed content (right side).
`--top-margin <DOTS>`	`2`	Non-printing margin at the top edge of the tape, in dots.
`--bottom-margin <DOTS>`	`8`	Non-printing margin at the bottom edge of the tape, in dots.
`--max-tape-length-mm <MM>`	—	Total label length in mm (including margins). Enables multi-line wrapping when the text does not fit in one line.
`--align <ALIGN>`	`left`	Per-line alignment: `left`, `center`, or `right`. Only meaningful with `--max-tape-length-mm`.
`--font <PATH>`	bundled BIZ UDPゴシック	Path to a `.ttf`/`.otf`/`.ttc` font file. Overrides the bundled font.
`--dump <PATH>`	—	Write the raw job bytes to a file (in addition to, or instead of, printing).
`--no-print`	—	Skip sending the job to the printer. Useful with `--dump`.
`--skip-preview`	—	Skip the SVG print preview and print immediately. A preview is shown by default (requires the `preview` build feature, enabled by default).

Examples

# Print "Hello" on the loaded tape (width auto-detected)
tpsr3700 "Hello"

# Print on 12 mm tape, explicit font size
tpsr3700 --tape-mm 12 --size 24 "Hello"

# Two lines with \n — no --max-tape-length-mm needed; font size is
# automatically halved so each line fits its band
tpsr3700 --tape-mm 18 "Line1\nLine2"

# Multi-line: wrap to a 50 mm label, center-aligned
tpsr3700 --tape-mm 18 --max-tape-length-mm 50 --align center "Hello World"

# Explicit line break with \n inside a fixed-length label
tpsr3700 --tape-mm 18 --max-tape-length-mm 40 "Line1\nLine2"

# Dump job bytes without printing (useful for debugging)
tpsr3700 --tape-mm 12 --no-print --skip-preview --dump job.prn "Test"

Print preview

By default, before sending a job to the printer, an SVG preview file is written to the system temp directory and opened with the OS default viewer when possible. It shows exactly what will be printed — the feed direction runs left-to-right (as the label exits the printer), and the non-printing top/bottom/left/right margins are shaded gray so the printable area is easy to spot.

Confirm in the terminal with y / yes to send the job to the printer.
Press Enter or type anything else to abort without printing.
Pass --skip-preview to print immediately without showing the preview.
The preview requires the crate to be built with the preview Cargo feature, which is enabled by default. If built without it (cargo build --no-default-features), you must always pass --skip-preview.

Multi-line rules

The minimum height of one printed line is 3 mm. A 6 mm tape fits at most 2 lines; 12 mm fits 4; 18 mm fits 6.
\n in the text always forces a line break, regardless of whether --max-tape-length-mm is set. Each line is rendered into an equal vertical band.
When --size is omitted and the text contains \n, the font size is automatically divided by the number of lines so each band gets the largest size that fits.
When --max-tape-length-mm is given and the text overflows one line, the tool automatically increases the line count (up to the tape's maximum) until everything fits, wrapping character by character.
--align applies to each line independently (only meaningful with --max-tape-length-mm).

USB permissions (Linux)

The tool communicates with the printer via libusb. On most Linux systems, regular users do not have read/write access to USB device nodes by default. Without it you will get a "permission denied" error when running the tool.

macOS: IOKit grants userspace access to USB devices automatically — no extra configuration is needed.

The recommended fix on Linux is a persistent udev rule that grants read/write access to members of the lp group. Create the file:

# /etc/udev/rules.d/99-tepra.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="0d8a", ATTRS{idProduct}=="0103", GROUP="lp", MODE="0660"

GROUP="lp" restricts access to the lp group and MODE="0660" grants read/write to that group only (safer than opening it to all users).

Or create it in one command:

echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="0d8a", ATTRS{idProduct}=="0103", GROUP="lp", MODE="0660"' \
    | sudo tee /etc/udev/rules.d/99-tepra.rules

Then add your user to the lp group, reload the rules, and re-trigger the device:

sudo usermod -aG lp $USER
sudo udevadm control --reload && sudo udevadm trigger

After that, unplug and re-plug the printer and start a new login session (or run newgrp lp in the current shell). The rule persists across reboots.

Project layout

src/
  main.rs           CLI entry point (clap argument parsing)
  font/mod.rs       Font rendering: text → raster rows (fontdue)
  preview.rs        SVG print preview (`preview` feature)
  tepra/
    mod.rs          TapeWidth enum and tape geometry constants
    builder.rs      Assembles the full print job byte stream
    frame.rs        ESC { } command frame encoder
    header.rs       Fixed 2179-byte job header builder
    raster.rs       Single raster row encoder
  usb/              libusb/rusb transport (bulk write + tape detection)
assets/
  header_18mm_template.bin   Base template for the job header
captures/           Raw USB capture of the tape-width probe (.pcap)
docs/protocol.md    Protocol documentation
src/font/
  BIZUDPGothic-Regular.ttf   BIZ UDPゴシック Regular, bundled in the binary
  OFL.txt                    Font license (SIL Open Font License 1.1)
tests/fixtures/     Golden .prn files used in byte-exact reconstruction tests

Running the tests

cargo test

License

Licensed under the Apache License, Version 2.0.

tpsr3700（日本語）

Linux・macOS 用 KING JIM TEPRA PRO SR3700P ラベルプリンタードライバーです。

Windows も純正ソフトも不要で、コマンドラインから直接テキストラベルを印刷できます。

免責事項: 本プログラムは KING JIM 株式会社とは無関係です。本ソフトウェアについて KING JIM 社へお問い合わせをしないでください。

機能

6 mm・12 mm・18 mm テープへの任意テキスト印刷
プリンターへの問い合わせによるテープ幅自動検出
テープ幅に収まる最大フォントサイズの自動選択
複数行印刷: テキスト中の \n で改行 — --max-tape-length-mm の有無に関わらず使用可能
ラベル長指定による折り返し（テープ幅から最大行数を自動計算、最低行高さ 3 mm）
行ごとの左寄せ / 中央揃え / 右寄せ（--max-tape-length-mm 使用時）
生のジョブバイト列をファイルにダンプ（ハードウェアなしでのデバッグに便利）
印刷前の SVG プレビュー表示（デフォルトで表示。--skip-preview で無効化可能）

必要なもの

Rust ツールチェーン（edition 2024）
libusb:
- Debian/Ubuntu: sudo apt-get install libusb-1.0-0-dev
- macOS: brew install libusb

フォントのインストールは不要です。BIZ UDPゴシック Regular をバイナリに直接埋め込んでいます。別のフォントを使いたい場合は --font <PATH> で .ttf/.otf/.ttc ファイルを指定してください。

ビルド

cargo build --release

preview フィーチャー（SVG 印刷プレビュー、後述）はデフォルトで有効です。無効にしてビルドする場合は以下を使用してください:

cargo build --release --no-default-features

使い方

tpsr3700 [オプション] <テキスト>

オプション一覧

オプション	デフォルト	説明
`--tape-mm <MM>`	自動検出	テープ幅（mm）。`6`・`12`・`18`、実験的に `24` をサポート。省略時はプリンターに問い合わせ。
`--size <PT>`	自動	フォントサイズ（ポイント、TEPRA アプリの表示と同じ。例: `36`）。省略時はテープに収まる最大サイズ。
`--left-margin-mm <MM>`	`10.0`	印字内容の前（ラベルがプリンターから出る側＝左端）に追加する余白（mm）。
`--right-margin-mm <MM>`	`3.0`	印字内容の後（右端）に追加する余白（mm）。
`--top-margin <DOTS>`	`2`	テープ上端の非印字マージン（ドット数）。
`--bottom-margin <DOTS>`	`8`	テープ下端の非印字マージン（ドット数）。
`--max-tape-length-mm <MM>`	—	ラベル全長（mm、マージン込み）。指定すると、1 行に収まらないテキストを複数行に折り返す。
`--align <ALIGN>`	`left`	各行の横方向揃え: `left`（左寄せ）・`center`（中央）・`right`（右寄せ）。`--max-tape-length-mm` 指定時のみ有効。
`--font <PATH>`	バンドル済み BIZ UDPゴシック	フォントファイルのパス（`.ttf`/`.otf`/`.ttc`）。バンドルフォントを上書きします。
`--dump <PATH>`	—	生のジョブバイト列をファイルに書き出す（印刷と併用可）。
`--no-print`	—	プリンターへの送信をスキップ。`--dump` と組み合わせて使用。
`--skip-preview`	—	SVG 印刷プレビューを表示せず、すぐに印刷する。デフォルトではプレビューを表示する（`preview` ビルドフィーチャーが必要。デフォルトで有効）。

使用例

# テープ幅を自動検出して "Hello" を印刷
tpsr3700 "Hello"

# 12 mm テープ、フォントサイズ 24pt を指定して印刷
tpsr3700 --tape-mm 12 --size 24 "Hello"

# \n で 2 行印刷 — --max-tape-length-mm 不要
# --size 省略時はフォントサイズを行数で自動分割
tpsr3700 --tape-mm 18 "1行目\n2行目"

# 50 mm のラベルに複数行・中央揃えで折り返し印刷
tpsr3700 --tape-mm 18 --max-tape-length-mm 50 --align center "Hello World"

# ラベル長を指定して \n で明示的に改行
tpsr3700 --tape-mm 18 --max-tape-length-mm 40 "1行目\n2行目"

# 印刷せずにジョブバイト列をファイルにダンプ（デバッグ用）
tpsr3700 --tape-mm 12 --no-print --skip-preview --dump job.prn "Test"

印刷プレビュー

デフォルトでは、プリンターにジョブを送信する前に SVG プレビューファイルをシステムの一時ディレクトリへ書き出し、可能であれば OS の既定ビューアで開きます。実際に印刷される内容がそのまま表示されます。送り方向は左から右（ラベルがプリンターから出てくる方向）で、上下左右の非印字マージン部分はグレーで表示されるため、印字可能な範囲が一目でわかります。

端末で y / yes を入力すると、プリンターにジョブを送信します。
Enter のみ、またはそれ以外の入力では印刷を中止します。
--skip-preview を指定すると、プレビューを表示せずに即座に印刷します。
プレビュー機能を使うには preview Cargo フィーチャー（デフォルトで有効）が必要です。無効にしてビルドした場合（cargo build --no-default-features）は、常に --skip-preview を指定する必要があります。

複数行印刷のルール

1 行の最低高さは 3 mm です。 6 mm テープは最大 2 行、12 mm は 4 行、18 mm は 6 行まで印字できます。
テキスト中の \n は常に改行として扱われます（--max-tape-length-mm の有無を問いません）。各行はテープの縦方向を等分したバンドに描画されます。
--size を省略した場合、\n の行数に応じてフォントサイズを自動的に分割し、各バンドに収まる最大サイズを使用します。
--max-tape-length-mm を指定した場合、1 行に収まらないテキストは自動的に行数を増やして（最大行数まで）文字単位で折り返します。
--align は各行に個別に適用されます（--max-tape-length-mm 使用時のみ有効）。

USB アクセス権の設定（Linux）

このツールは libusb 経由でプリンターと通信します。多くの Linux 環境では、一般ユーザーはデフォルトで USB デバイスノードへの読み書きアクセス権を持っていません。権限がない場合、ツール実行時に "permission denied" エラーが発生します。

macOS: IOKit がユーザー空間への USB アクセスを自動で許可するため、追加設定は不要です。

推奨される対処法は Linux での udev ルール設定です。lp グループのメンバーに読み書きアクセスを付与する永続的なルールを作成してください：

# /etc/udev/rules.d/99-tepra.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="0d8a", ATTRS{idProduct}=="0103", GROUP="lp", MODE="0660"

GROUP="lp" でアクセスを lp グループに限定し、MODE="0660" でそのグループにのみ読み書き権限を付与します（全ユーザーに開放するより安全です）。

次のコマンド 1 行で作成することもできます：

echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="0d8a", ATTRS{idProduct}=="0103", GROUP="lp", MODE="0660"' \
    | sudo tee /etc/udev/rules.d/99-tepra.rules

続けて、自分のユーザーを lp グループに追加し、ルールを反映してデバイスを再トリガーします：

sudo usermod -aG lp $USER
sudo udevadm control --reload && sudo udevadm trigger

プリンターを抜き差しし、新しいログインセッションを開始してください（または現在のシェルで newgrp lp を実行）。ルールは再起動後も有効です。

プロジェクト構成

src/
  main.rs           CLI エントリーポイント（clap 引数解析）
  font/mod.rs       フォントレンダリング: テキスト → ラスタ行（fontdue 使用）
  preview.rs        SVG 印刷プレビュー（`preview` フィーチャー）
  tepra/
    mod.rs          TapeWidth 列挙型とテープのジオメトリ定数
    builder.rs      印刷ジョブのバイト列を組み立て
    frame.rs        ESC { } コマンドフレームエンコーダー
    header.rs       固定長 2179 バイトのジョブヘッダービルダー
    raster.rs       ラスタ行エンコーダー
  usb/              libusb/rusb トランスポート（バルク書き込みとテープ幅検出）
assets/
  header_18mm_template.bin   ジョブヘッダーのベーステンプレート
captures/           テープ幅検出時の USB キャプチャ（.pcap）
docs/protocol.md    プロトコル仕様書
src/font/
  BIZUDPGothic-Regular.ttf   バイナリに埋め込まれる BIZ UDPゴシック Regular
  OFL.txt                    フォントのライセンス（SIL Open Font License 1.1）
tests/fixtures/     バイト完全一致テスト用ゴールデン .prn ファイル

テストの実行

cargo test

ライセンス

Apache License, Version 2.0 の下で提供されます。

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
assets		assets
captures		captures
docs		docs
examples		examples
src		src
tests/fixtures		tests/fixtures
.gitignore		.gitignore
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
LICENSE		LICENSE
README.md		README.md

Navigation Menu

Repository navigation

About

Repository files navigation

tpsr3700

Features

Requirements

Build

Usage

Options

Examples

Print preview

Multi-line rules

USB permissions (Linux)

Project layout

Running the tests

License

tpsr3700（日本語）

機能

必要なもの

ビルド

使い方

オプション一覧

使用例

印刷プレビュー

複数行印刷のルール

USB アクセス権の設定（Linux）

プロジェクト構成

テストの実行

ライセンス

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

tpsr3700

Features

Requirements

Build

Usage

Options

Examples

Print preview

Multi-line rules

USB permissions (Linux)

Project layout

Running the tests

License

tpsr3700（日本語）

機能

必要なもの

ビルド

使い方

オプション一覧

使用例

印刷プレビュー

複数行印刷のルール

USB アクセス権の設定（Linux）

プロジェクト構成

テストの実行

ライセンス

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages