UniPic

UniPicは、重複画像の検出と削除を行うElectronベースのデスクトップアプリケーションです。バイナリハッシュ比較（MD5）とパーセプチュアルハッシュ（pHash）比較の両方を使用して、同一画像と視覚的に類似した画像を検出します。

主な機能

• 重複画像検出: バイナリ同一とパーセプチュアルハッシュによる視覚的類似性の両方を検出
• ドラッグ&ドロップ: フォルダをアプリにドラッグするだけで簡単スキャン
• 高速処理: 並列処理による高速ハッシュ計算
• 画像ビューア: 重複画像を比較できる拡大表示機能
• キーボードショートカット: 効率的な画像選別と削除
• 進捗表示: リアルタイム進捗とファイル処理状況の表示

対応フォーマット

JPEG, PNG, WebP, AVIF, TIFF, BMP, GIF, HEIC など主要な画像フォーマットに対応

インストール

開発者向け

git clone <repository-url>
cd UniPic
npm install
npm start

エンドユーザー向け

1. Releasesから最新版をダウンロード
2. macOS: UniPic-x.x.x-arm64.dmgをダウンロードしてインストール
3. アプリケーションフォルダにドラッグ&ドロップでインストール完了

使用方法

1. フォルダ選択: 画像フォルダをアプリにドラッグ&ドロップ
2. 類似度調整: スライダーで視覚的類似性の感度を調整（0-20）
3. スキャン実行: 自動的にスキャンが開始されます
4. 結果確認: 重複画像が一覧表示されます
5. 画像比較: 画像をクリックして拡大表示で詳細比較
6. 削除: 不要な画像を削除してスペースを節約

キーボードショートカット（画像ビューア）

• ← / A: 前の画像
• → / D: 次の画像
• Delete: 画像を削除
• Space: ズーム切り替え
• F: フルスクリーン
• Esc: ビューアを閉じる

技術仕様

• フレームワーク: Electron
• 画像処理: Sharp
• 重複検出: MD5ハッシュ + pHash（DCTベース）
• UI: HTML/CSS/JavaScript
• 対応OS: macOS, Windows, Linux

開発

開発環境のセットアップ

npm install
npm run dev  # 開発者ツール有効

ビルド

npm run build-mac    # macOS向け
npm run build-win    # Windows向け
npm run build-linux  # Linux向け

VS Code

F5キーで直接デバッグ実行が可能です。

ライセンス

MIT License

貢献

プルリクエストやIssueを歓迎します。

注意事項

• 削除された画像は復元できません
• 大量の画像処理時はメモリ使用量にご注意ください
• 初回スキャン時は時間がかかる場合があります