一個專為 HAM 設計的開源無線電台記錄管理系統
簡介
HamLog 是一款專為業餘無線電愛好者設計的軟體。(HAM)開發了用於本地電子日誌管理的軟體,採用 Python + PyQt6 + SQLite3 進行開發,並遵守 GPL-3.0 開源協議。
無論你是剛入門的新手還是資深的愛好者,HamLog 都能幫助你高效地管理 QSO 記錄、追蹤 QSL 卡片的收發狀態。
功能:狀態
📝 QSO 記錄輸入:支援呼號、頻率、模式、功率、RST 報告等完整欄位。
🔍 智慧搜尋:支援按呼號、QTH(廣播站位置)、設備、備註等進行模糊搜尋。
📊 即時統計:總共已建立聯線數、今日已建立聯線數即時顯示
🎴 QSL 卡片管理:記錄收發日期、追蹤卡片狀態
⚙️ 本台資訊設定:包含頻道名稱、姓名、廣播站位置(QTH)、網格座標等個人化設定。
🌓 深色/淺色主題:只需一鍵即可切換,適用於不同的使用環境。
💾 資料本地儲存:所有資料都儲存在本地的 SQLite 資料庫中,確保隱私安全。
📤 數據匯出:支援 ADIF/CSV 格式匯出 (開發中)
🖼介面預覽
HamLog 的主介面

在深色主題下,主要介面包含:呼號資訊欄、實時時鐘、搜尋工具以及記錄表格。
🚀 快速入門
環境要求
作業系統:Windows 10 / 11 (64 位)
Python:3.7 或更新版本
依賴的函式庫:PyQt6, SQLite3
安裝與執行
複製倉庫
複製 Git 倉庫 https://github.com/ARPRC-BA8AQA/HamLog.git
進入 HamLog
安裝依賴元件
使用 pip 安裝 PyQt6
執行程式
Python "HAMLOG GUI.py"
將其打包成可執行檔案
使用 pip 安裝 pyinstaller
使用 pyinstaller,以單一檔案形式執行,並啟用全螢幕模式,「HAMLOG GUI.py」
📁 專案架構
HamLog/
├── program\_files #程式碼資料夾
├── 版本
├── HAMLOG_GUI.py # 主要程式 (使用 PyQt6 的 GUI)
├── AutoDeal.py # 後端模組 (資料庫、驗證、設定管理)
├── Log.db # 本機 SQLite 資料庫 (在執行時產生)
├── 截圖/ # 介面截圖
├── LICENSE # 使用 GPL-3.0 授權
└── README.md # 本文件
🗄資料庫說明
HamLog 使用 SQLite 本地資料庫,預設儲存路徑:
系統:路徑
Windows: `%APPDATA%\HamLog\Log.db`
macOS:~/Library/Application Support/HamLog/Log.db
Linux: ~/.local/share/HamLog/Log.db
⚠️ 建議定期備份 Log.db 檔案,以免資料遺失!
資料庫欄位
欄位 說明
頻率/識別碼:對方呼號
頻率
年/月/日 聯絡日期
時間 通聯時間 (HHMM)
模式:(例如 FM/SSB/CW/FT8)
電力_自測 我的電力
電源側 對方功率
Rst_self 對方提供的報告
Rst\_side 我給對方的那份報告
QTH:通訊地點
設備 使用設備
收到 QSL 的日期
發送 QSL 的日期
備註 備註
🤝 參與貢獻
我們歡迎所有 HAM 以及開發者的貢獻!
如何貢獻
複製本倉庫
個人化調整
提交變更並推送到 Dev 分支
開啟拉取請求
建立問題
發現錯誤或有新的功能建議?歡迎提交問題!
📜 開源協議
本專案遵循 GNU 通用公共授權協定 v3.0。
HamLog – 業餘無線電台的日誌管理系統
Copyright (C) 2026 BA8AQA、BG5JQN 以及所有貢獻者
這款程式為開源軟體:您可以重新發布此軟體以及/或修改此軟體。
只要您遵守 GNU 通用公共授權(GPL)第三版,或(依照您的決定),任何之後的版本。
這款程式是為了提供協助而發布的,但沒有任何保證。
對於特定用途的適用性所隱含的擔保;甚至可能沒有符合可出售性。詳細請參閱 GNU 通用公共許可證。
🙏 感謝
特別感謝以下人員與組織對 HamLog 開發所提供的支持:
BA8AQA — 項目發起人和核心開發者
BG5JQN — 核心開發
所有提交 issue 和 pull request 的 HAM 貢獻者
開源社群提供的優質工具與函式庫
📬 聯絡我們
平台:連結
GitHub:ARPRC-BA8AQA/HamLog
嗶哩哔哩 @C盤研究所-中國_BA8AQA
BA8AQA 的 73 & BG5JQN 🎙️
希望無線電訊永遠不會消失,友誼在空中長存。