matometor

蔵書記録・管理デスクトップアプリケーション

本の内容をインターネットの掲示板風スレッド形式でまとめることができる個人用ツールです。読み返し・振り返りを容易にし、読書日記としても活用できます。

---

スクリーンショット

---

機能

• スレッド形式で本の内容をまとめられる
• レスへのアンカー機能（>>番号 でジャンプ）
• 100レスで自動的に過去ログへ移動・次スレ作成
• ISBN入力でGoogle Books APIから書誌情報を自動補完
• タグ（ジャンル）による蔵書管理
• お気に入り登録
• タイトル・著者・ISBN・本文の横断検索
• スレッド・蔵書リストのPDF出力
• データのバックアップ・JSONエクスポート

---

動作環境

• macOS（動作確認済み）
• Windows（未確認。動作報告歓迎）
• Python 3.9以上

注意: macOS 26（Tahoe）ベータ版では.appファイルが正常に動作しない場合があります。その場合はpython main.pyでの起動をお試しください。

cd ~/dev/matometor source .venv/bin/activate python main.py

またはrun.commandをダブルクリックで起動してください。

---

セットアップ

macOSユーザー向けクイックスタート

1. ソースコードをダウンロード

GitHubの「Code」→「Download ZIP」でダウンロードして解凍してください。

2. Pythonをインストール

python.orgから3.9以上をダウンロードしてインストールしてください。

3. ターミナルで以下を実行

cd ダウンロードしたフォルダのパス
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

このときセキュリティの関係でアプリを開けませんが、 設定の「プライバシーとセキュリティ」から 許可すれば”run.command”をダブルクリックで開けます。

4. 起動

セットアップ完了後はrun.commandをダブルクリックするだけで起動できます。

注意

macOS 26（Tahoe）ベータ版では.appファイルが正常に動作しない場合があります。

1. リポジトリをクローン

git clone https://github.com/あなたのユーザー名/matometor.git
cd matometor

2. 仮想環境を作成・有効化

python3 -m venv .venv

# Mac
source .venv/bin/activate

# Windows
.venv\Scripts\activate

3. 依存パッケージをインストール

pip install -r requirements.txt

4. Google Books APIキーを設定（任意）

ISBNによる書誌情報の自動補完を使う場合は、Google Books APIキーを取得して設定してください。

Google Cloud ConsoleでAPIキーを取得後、プロジェクトルートに.envファイルを作成してください。

GOOGLE_BOOKS_API_KEY=あなたのAPIキー

APIキーがなくても手動入力で本を登録できます。

5. 起動

python main.py

---

Macでワンクリック起動

run.commandをダブルクリックするだけで起動できます。

---

技術スタック

項目	内容
言語	Python
UIフレームワーク	PyQt6
データベース	SQLite（ローカル）
外部API	Google Books API
PDF出力	PyQt6 QPrinter

---

ライセンス

MIT License

---

次に`requirements.txt`を作成してください。

PyQt6 PyQt6-Qt6 PyQt6-sip PyQt6-WebEngine python-dotenv