アマチュア無線愛好家の皆様、BH5HIEと申します。QSLカードを作成する数年間の経験から、通信相手への返信用封筒の作成は大変でした。住所形式が様々で、日本語と英語を混在させたり、郵便番号の位置がずれたり、一度に10～15通もの手紙を書く必要があったためです。そこで、私はクロスプラットフォームに対応した簡単なツールを作成しました。 QSL の郵送、特に「封筒に住所をきちんと印刷する」という問題を解決します。現在のバージョン 1.2.7、オープンソース（MITライセンス）で、無料でダウンロードして利用できます。
1. これは何ですか？
QSL メールは、～です封筒の製作・印刷用ワークステーション、アマチュア無線向けのQSLカードの郵送シーンにも適用され、標準サイズの封筒に返信用アドレスを記載する必要があるあらゆる場面に適しています。以下のような機能に対応します：
- 送受信者の氏名、コールサイン、住所、郵便番号、携帯電話番号完全に記入してください。
- 国内／国際2つの配送方法：国内モードでは、右上隅に6桁の郵便番号欄が自動的に表示されます。
- DL、C5、#10、C6 の4つの一般的な封筒のサイズ。完全にカスタマイズされたサイズ；
- 水平/垂直方向のレイアウト、住所自動改行、フレームの高さを自動調整。
- 封筒の表面リアルタイムでの可視化プレビュー、送受信の担当者が利用できる直接ドラッグ位置調整も、スライダーの数値による微調整が可能です。
- 連絡先リスト：主要ラジオ連絡先の追加、削除、変更、検索、ワンクリックでの適用機能。
- CSV/TXT形式での大量インポート、中国語および一般的な英語のリストに対応し、バッチ印刷キュー機能も搭載。
- レイアウトテンプレート：よく使うレイアウトをテンプレートとして保存し、次回はワンクリックで適用する。
- タスクの履歴：編集内容を自動で保存し、いつでも復元できます。
- 印刷前にプレビュー印刷時に、プレビュー用の補助線、グラフ、スタンプ、装飾パターンを自動的に非表示にし、実際のコンテンツのみを印刷します。
- プリンターのキャリブレーション：印刷時の拡大、X/Y軸のオフセット、安全範囲の設定、用紙選択。
- デスクトップ版では、タスクと連絡先をローカルデータファイルに保存します。再インストールまたはデスクトップ版（Electron ↔ Lite）への変更時に、データが失われることはありません。。
コールサインが未入力の場合、共通表示 通話は不要これにより、見た目が悪くなるような空白は発生しません。
2. メインインターフェースの概要
ソフトウェアを開くと、左側にサイドバー（制作台/アドレス帳/テンプレート/印刷設定+最近のタスク）、中央に情報入力欄、右側に… が表示されます。リアルタイムの封筒プレビュー— 紙面の比率やコンテンツの位置は、実際の印刷サイズに合わせて表示されます。
プレビューエリアの下では、封筒のサイズ（DL/C5/#10/C6/カスタム）、縦横方向、および「正確な位置」パネル（X座標、Y座標、フォントサイズ、枠の幅）を直接変更できます。
3. 簡単な導入：最初のメールを送信する5つのステップ
ステップ１：送受信者の情報を入力してください
「宛先情報」には、相手の名前、コールサイン、住所、郵便番号（携帯電話番号は任意）を入力します。「送信者情報」には、ご自身の返信用アドレスを入力します。サイドバーの下部に、お使いのラジオ局の情報が表示されます。「私の情報から入力 ↗」をクリックすると、保存されているラジオ局の情報がワンクリックで入力できます。
住所が長い場合でも大丈夫です。「プレビュー」で自動的に改行され、入力欄の高さは内容に合わせて調整されます。
ステップ2：発送方法と封筒のサイズを選択
国際郵便での発送について国際、郵便番号は宛先住所の欄に表示されます。国内宛の郵便物の場合は、国内、封の右上には6桁の郵便番号欄が表示され、「国内郵便番号」パネルも追加され、個別に調整可能。位置、文字サイズ（1文字あたり）、行間。
封筒のサイズは、お持ちの封筒から選択してください：DL（220×110）、C5（229×162）、#10（241×105）、C6（162×114）、「カスタム」を選択し、印刷設定で幅と高さを入力してください。
ステップ3：正確なレイアウトの特定
プレビューの宛先/送信者欄は、直接マウスでドラッグまた、「精密位置」パネルのスライダーで、X/Yの位置、フォントサイズ、およびボックスの幅を微調整することも可能です。「宛先/送信元」タブでそれぞれ調整し、「↺」ボタンをクリックすると、デフォルト設定に復元されます。
ステップ４：プレビューと印刷
右上隅にある「封筒の印刷」をクリックすると、まず表示されます。印刷プレビュー内容とサイズを確認し、その後印刷機に送付してください。プレビューには、安全境界線（破線）、封筒の折り返し線、切手、および装飾パターンが表示されます。印刷できません。、印刷ページをきれいに保ちます。
印刷前に、「印刷設定」でプリンター、用紙、およびキャリブレーションパラメータ（第6章を参照）を確認することをお勧めします。初めて印刷する際は、まず通常のA4サイズの紙で1枚試し印刷してから、封筒を使用するのがより確実です。
4. アドレス帳とクイック適用
よく使っているラジオの保存先をアドレス帳に追加した後、以下の2つの方法で簡単に適用できます。
- 制作台の右側にある「クイック入力」エリアで、最近連絡を取り合った相手をワンクリックで入力できます。
- 「アドレス帳」で名前、コールサイン、都市などを検索し、「適用」をクリックしてください。
担当者が新規作成、編集、削除をサポートします。項目には、氏名、コールサイン、住所、郵便番号、携帯電話番号、および備考（例：「日本・東京」）が含まれます。
5. CSV形式での大量インポートと大量印刷
一度に複数のラジオ局と連携する場合、CSV形式でまとめてインポートするのが最も簡単です。
- 「ダウンロード」ボタンを使用して、宛先リストのテンプレートを標準CSV形式で取得します。
- テンプレートに従って入力 (または、LOTW/ログソフトウェアからエクスポートしたアドレス表を編集して、列名を修正)
- 「CSVインポート」を選択し、ファイルを選択します。最初の行が自動的に日本語または英語の列名を認識します（氏名、コールサイン、住所、郵便番号、携帯電話番号など）。また、name / callsign / address / zipなどの形式にも対応しています。
- インポート後に表示されるまとめて印刷キュー印刷したい記録を選択し、「1件ずつ」でプレビューを確認してから、「まとめて印刷」を実行してすべての封筒を印刷します。各封筒は1枚ずつ切り出し、実際のサイズを維持します。
標準のCSV形式（最初の行がヘッダー、UTF-8）
氏名、コールサイン、住所、郵便番号、携帯電話番号
タカハシケン、JA7QXG、東京都千代田区1-2-3、100000、090-1234-5678
マイケル・レーン、VK3LQ、ビクトリア州メルボルン、コリンズ通り15番地、3000、+61 400 123 456
6. 印刷設定と調整
「印刷設定」には、プリンター、用紙、およびラジオに関する情報がまとめられています。
- プリンター：デスクトップ版でシステムに登録されているプリンターの一覧を表示し、特定のプリンターを選択可能。
- プリンターへの用紙の投入：封筒の実際のサイズ、またはA4/Letterサイズ（手差し印刷）で対応。
- 封筒の仕様：DL / C5 / #10 / C6 / カスタム（サイズ＋mm単位の寸法）
- プリンターのキャリブレーション：水平オフセット X、垂直オフセット Y（単位 mm、正の値は右/下に）
印刷縮尺：80%～120%
- 安全境界：プレビュー時に、安全領域の補助線が表示されます。
- 私のラジオ情報氏名、コールサイン、返送先住所、郵便番号、携帯電話番号を登録後、ワンクリックで送信者情報に自動入力されます。
全体がずれている場合：ずれコンテンツを正しい場所に移動する。もしコンテンツのサイズが合わない場合は、次の方法を使用してください。拡大/縮小微調整は、プリンターの設定を色々変えるよりも、はるかに分かりやすいです。
7. 私のテンプレート
調整されたレイアウト（封筒のサイズ + 送受信者の住所の文字サイズ + モード + 印刷設定）をテンプレートとして保存できます。「日本 QSL 横向き」「国内手配 C5」など。次回は「私のテンプレート」から直接使用し、再調整する必要はありません。
8. ダウンロードとインストール
プロジェクトのオープンソースリポジトリ：https://github.com/net3pang/QSLMailPrint
公開ページには、インターフェースと操作が完全に一致する2つのシリーズを提供しています。
QSL メール (Electron フルバージョン)、デバイスレベルの印刷パラメータと完全なインストール体験が必要な場合に適しています。
| プラットフォーム | ファイル |
|---|
| Windows | QSL.Mail.Setup.1.2.7.exe（インストール版）QSL.Mail.1.2.7.exe（インストール不要、携帯用版） |
| macOS | QSL.Mail-1.2.7-arm64.dmg（アップルシリコン）QSL.Mail-1.2.7.dmg / - mac.zip（インテル） |
| Linux | QSL.Mail-1.2.7.AppImage、qsl-mail_1.2.7_amd64.deb |
QSL メール ライト (Wails の軽量版)小型で起動が速く、システム WebViewを使用しており、同様に実印刷と大量印刷をサポートします。
| プラットフォーム | ファイル |
|---|
| Windows | QSL-Mail-Lite-windows-x64.exe |
| macOS | QSL-Mail-Lite-macos-arm64.zip / QSL-Mail-Lite-macos-x64.zip |
| Linux | QSL-Mail-Lite-linux-x64 |
macOS のユーザーへ：このアプリは、開発者IDによる署名と認証プロセスが設定されています。「システム設定 → プライバシーとセキュリティ」で実行を許可するか、右クリックして開いてください。
9. データの保存場所は？
- ドラフト、レイアウト、テンプレート、テンプレート、印刷設定：アプリのローカルストレージに保存。
- タスクの履歴と連絡先：デスクトップ版では、Go JSON形式のデータファイルに同時に書き込みます。デフォルトの保存場所は：
- macOS：
~/Library/Application Support/QSLMail/qsl-mail-データ.json
- Windows：
%AppData%\QSLMail\qsl-mail-データ.json
- Linux：
~/.config/QSLMail/qsl-mail-data.json
- 利用可能な環境変数
QSL_MAIL_DB 指定するデータファイルの場所を指定してください。
Electron版とLite版は、同じデータファイルを共有するため、使い分けることでタスクや連絡先を失うことはありません。
10. よくあるご質問
Q：ブラウザ版の使い方を教えてください。
A：「ブラウザ版は、プロジェクトのディレクトリ内で実行し、迅速な体験を目的としています。」 python3 -m http.server 4173 その後、開けます http://127.0.0.1:4173直接ダブルクリックすることを推奨しません。 index.html。ブラウザ版の印刷は、常にシステムプリンターダイアログが表示され、データはブラウザのlocalStorageに保存されます。
Q：「印刷の位置がずれている」「サイズがおかしい」ということですか？
A：「まず、通常の用紙で1枚印刷して確認します。全体的なずれは、「印刷設定」のX/Yオフセット調整（mm）を使用し、サイズが少しずれている場合は印刷のスケーリングを使用します。安全境界線の補助線を使うと、内容が印刷可能な範囲を超えていないか判断できます。」
Q：Lite版とフル版の違いは何ですか？
A：機能とインターフェースは整合されています。フルバージョンではChromiumが同梱されており、デバイスレベルの印刷設定（プリンターの指定、静音印刷など）を提供します。Lite版ではシステムWebViewを使用しており、サイズが小さく起動も速いため、macOSでの印刷はシステムのネイティブなプロセスを利用します。
Q：料金はかかりますか？
A：完全に無料でオープンソースであり、MITライセンスを採用しています。GitHubでIssueや提案、プルリクエストを送信していただければ幸いです。
73 デービーエイチファイエイチイー
闽ICP备2021006864号-7
闽公网安备35020602002794号