Kura
Kura（蔵）はイラスト制作に使う参考画像をパソコンの中だけで取り込み、整理・検索するための個人用の macOS アプリです。外部のサービスを使わないため、サービスの規約や判断によって資料を失うことがありません。
スクリーンショットはモックの画面に見本の写真を表示したものです。写真：Unsplash
できること
- ライブラリ（画像を置くフォルダ）を作る・開く。画像は普通のフォルダにファイルとして保存するので、Kura がなくても Finder で開ける
- 画像やフォルダを取り込む。フォルダの構成はカテゴリとして再現する。内容が同じ画像は重複して取り込まない
- カテゴリ（フォルダに対応）とタグで分類する。複数の画像にまとめて設定できる
- 縦横比を保った一覧で見る。並べ替え、サムネイルの大きさの変更、拡大表示ができる
- カテゴリ、タグ（AND・OR）、ファイル名、メモで絞り込む
- メモと5段階の星評価を付ける
- アプリ内のゴミ箱。ゴミ箱を空にするまで画像を元に戻せる
- Finder での変更（画像の追加・移動・削除）を検出して反映する
- 管理情報（データベース）をバックアップ用に書き出す
- 主な操作のキーボードショートカット
- アイデアボード：参考画像を専用のウィンドウに自由に並べる。動かす・拡大縮小する・重ねる・反転・回転・グレースケール・トリミングができ、元の画像ファイルは変えない。ほかのアプリの手前に固定し、透かして使える。設定で使わないこともできる
- ブラウザでダウンロードした画像のダウンロード元（画像URLと掲載ページURL）を記録し、詳細パネルから開く
使い方は ユーザーガイド を見てください。
まだできないこと
フェーズ3以降で作る予定です。詳しくは 要件定義書 の「開発フェーズと優先度」を見てください。
- フェーズ3：ポーズ、構図、内容が似た画像の検索
- フェーズ4：検索条件の保存（スマートフォルダ）、縦横比や追加した日での絞り込み、クリップボードからの取り込みなどの改善
- フェーズ5：画像以外の資料（CLIP STUDIO PAINT の .clip、フォント、動画）
動く環境
- macOS（Apple シリコン）。Windows には対応しない
- ライブラリは内蔵ディスクか外付けドライブ（APFS、HFS+、exFAT）に置く。iCloud Drive とネットワークドライブは動作を保証しない。選ぶと警告が出る
インストール
- Releases から、最新バージョンの
Kura-<バージョン番号>-arm64.zip をダウンロードする
- zip をダブルクリックして展開し、展開した
Kura.app を「アプリケーション」フォルダに移す
Kura.app を開く
Kura は Apple の開発者署名と公証を受けていません。そのため、初回起動時は macOS が「開発元を確認できない」などと表示し、起動をブロックします。次のどちらかの方法で開きます。一度開けば、次回からは通常どおり起動できます。
- Finder で
Kura.app を右クリック（control キーを押しながらクリック）し、「開く」を選ぶ。確認が出たら「開く」を押す。macOS 15 以降ではこの方法で開けないので、次の方法を使う
- 一度起動を試してブロックされたあと、システム設定の「プライバシーとセキュリティ」を開く。下の方にある Kura の表示の横の「このまま開く」を押し、確認が出たら「開く」を押す
各バージョンの変更内容は CHANGELOG.md にあります。ソースからビルドするときは、下の「開発の始め方」を見てください。
開発の始め方
必要なもの
- Node.js（CI は 24 を使う）
- Rust（stable）と、Tauri 2 の macOS 開発に必要な環境（Xcode の Command Line Tools）
- uv（Python の環境管理。ダミーライブラリの生成に使う）
準備と起動
npm install
npx playwright install webkit
npm install を実行すると、コミット前に整形と検査を実行するフック（lefthook）もインストールされます。
| コマンド | 内容 |
|---|
npm run tauri dev | 開発用のアプリを起動する。Rust を最適化せずにビルドするので、取り込みが遅い（1枚1秒以上） |
npm run dev:mock | Tauri のコマンドをモックに差し替えた画面だけを http://localhost:5173 で開く |
npm run dev-library -- <枚数> | ダミー画像のライブラリを dev-library/ に作る |
npm run tauri build | リリース用にビルドする。.app は src-tauri/target/release/bundle/macos/ にできる |
npm run tauri dev で起動すると、「Kura について」やウィンドウの切り替えのアイコンがファイルの絵になります。.app では正しいアイコンが表示されます。
開発やテストに、本物の資料フォルダを使わないでください。npm run dev-library で作ったダミーのライブラリを使います。
テスト、Lint、整形のコマンドと、開発の決まりは CLAUDE.md にまとめています。
ドキュメントのスクリーンショット
docs/images/ のスクリーンショットは次のコマンドで撮り直します。モックの開発サーバーを使って撮影するため、ポート 5173 を空けておいてください。
KURA_DOCS_PHOTOS=<見本の写真のフォルダ> npm run docs:screenshots
KURA_DOCS_PHOTOS には、商用利用できる写真をカテゴリ名のフォルダに分けて入れたフォルダを渡します（子のフォルダは子のカテゴリになります）。写真はリポジトリに入れません。縮小した写しを .claude/tmp/docs-photos/ に作って使います。写真を足したり消したりしたら、そのまま撮り直せます。
ドキュメント
ライセンス
MIT
