前提条件
  • Windows, macOS, Linux のいずれかの PC
  • 管理者権限(ソフトウェアのインストールが可能なアカウント)
  • インターネット接続
1. QZ Tray のダウンロード
  • 1. ブラウザで公式サイトにアクセス
https://www.qz.io/download/
  • 2. ページ内の「Download QZ Tray」ボタンをクリック
  • 3. 利用する OS を選択
    • Windows 64-bit(.exe)
    • macOS(.dmg)
    • Linux(.deb / .rpm)
2. QZ Tray のインストーラーの実行

Windows の場合

  • 1. ダウンロードした QZTray-Setup-<version>.exe をダブルクリック
  • 2. ユーザーアカウント制御(UAC)が出たら「はい」をクリック
  • 3. セットアップウィザードに沿って進む
    • • ライセンス条項の同意
    • • インストール先フォルダの確認(デフォルト推奨)
  • 4. 「Install」をクリックし、完了したら「Finish」を押す

macOS の場合

  • 1. ダウンロードした QZTray-<version>.dmg をダブルクリック
  • 2. マウントされたボリューム内の QZ Tray.app を Applications フォルダにドラッグ&ドロップ
  • 3. Finder の Applications フォルダから QZ Tray.app を起動

Linux の場合

• Debian/Ubuntu (.deb)
sudo dpkg -i qz-tray_<version>_amd64.deb sudo apt-get install -f # 依存関係の自動解決
• RedHat/CentOS (.rpm)
sudo rpm -i qz-tray-<version>.x86_64.rpm
3. 初回起動とブラウザ連携
  • 1. QZ Tray を起動
    • Windows:スタートメニュー → QZ Tray
    • macOS:Launchpad/Applications → QZ Tray
    • Linux:qz-tray コマンドまたはメニューから
  • 2. タスクトレイ/メニューバーに QZ Tray アイコンが表示されることを確認
  • 3. ブラウザ(Chrome, Firefox, Edge など)を再起動
  • 4. デモページで動作確認
https://demo.qz.io/
  • •「Connect」を押して QZ Tray と接続
  • • プリンター一覧が取得できれば成功
4. セキュア接続の準備(任意)
  • 1. QZ Tray の設定画面を開く
  • 2.「Security」タブで発行済みの証明書(qz-tray.pem)をインポート
  • 3. ウェブアプリからも同一証明書を参照するよう、JavaScript 側で設定
おわりに
  • • 以上で「ダウンロード→インストール→接続確認」まで完了です。
  • • 実際の印刷サンプルコードや生コマンド(Raw Printing)の設定は公式ドキュメントの Raw Printing ガイド をご参照ください。