デバイスとネットワーク

SpaceMosaic

フォルダーごとの読み取り専用ストレージマップ。フォルダー内で何が容量を使っているかをサイズマップで確認。何も削除・変更しません。

リリース
v0.2.0, 2026年11月1日
動作環境
デスクトップアプリ、Android 8.0 以降の APK。iOS は独自の署名が必要
ライセンス
Apache-2.0

画面

macOS の SpaceMosaic で node_modules をスキャンした画面。合計 165.4 MiB とサイズ不明の 16 項目、サイズ順のフォルダーツリー、大きなパッケージのフォルダーを矩形で示す色付きマップ。
macOS 上の SpaceMosaic 0.1.2 で、このサイトの依存関係フォルダーをスキャン。本カタログ用に撮影。 原寸で開く SpaceMosaic のスクリーンショット

できること

フォルダーを選ぶと、SpaceMosaic がサイズの内訳をツリー、矩形マップ、大きなファイルの一覧、ファイル形式別の集計で表示します。保存した JSON 結果はフォルダーを読み直さずに開け、新しいスキャンとも比較できます。読むのはメタデータだけで、ファイルの内容は読みません。削除やクリーンアップの機能もありません。

対象

  • ディスクの空き容量が少なく、削除を決める前に大きなフォルダーを調べたい方。
  • フォルダーのサイズを JSON や CSV で報告したい方。
  • クリーンアップツールに不安がある方。ファイルを削除する操作はありません。

制限事項

  • 測定するのは選んだフォルダーで、ディスク全体ではありません。ハードリンク、APFS クローン、圧縮があるため、表示サイズがそのまま解放できる容量とは限りません。
  • デスクトップでは 500,000 オブジェクトまたは約 256 MiB のメタデータ、モバイルでは 100,000 オブジェクトで停止し、不完全な結果と表示します。
  • Windows と macOS のビルドには発行元証明書がありません。macOS は ad-hoc 署名で、公証されていません。
  • シンボリックリンクと Windows の再解析ポイントはたどりません。

主な使い方

大きなフォルダーを見つける

プロジェクト、ダウンロード、メディアのフォルダーをスキャンし、大きな矩形をたどります。ダブルクリックでフォルダーを拡大でき、小さな項目は検索可能な一覧にまとめられます。

不明なサイズをゼロにしない

読めないフォルダーや不明なサイズは 0 B ではなく不明と表示します。論理サイズと割り当て済み容量は別々に示し、不完全なスキャンには理由を添えます。

結果を保存して比較する

形式のバージョン付き JSON を書き出し、後で開いて同じフォルダーの新しいスキャンと比較できます。確認できた変化と不明な変化を区別し、名前変更は消えた項目と追加された項目として扱います。出力にはファイル名とパスが含まれるため、共有前に確認してください。

ダウンロード

最新の安定版 v0.2.0(2026年11月1日 公開)。 リリースノート (v0.2.0). リリース情報は 2026年11月2日 に GitHub Releases から取得しました。

macOS

ディスクイメージ(.dmg)をダウンロード, macOS Apple Silicon (arm64), 11 MB
  • Apple Silicon (arm64)
  • Apple Silicon 搭載 Mac
  • アドホック署名、公証なし
  1. DMG を開き、SpaceMosaic.app をアプリケーションへドラッグします。
  2. 初回起動を macOS がブロックした場合は、システム設定のプライバシーとセキュリティで許可します。
その他の形式(1)

Windows

インストーラー(.exe)をダウンロード, Windows x86-64, 9 MB
  • x86-64
  • 署名なし
  1. インストーラーを実行します。管理者権限なしで現在のユーザーにインストールします。
  2. Authenticode 署名がないため、Windows が不明なアプリとして警告することがあります。
その他の形式(1)

Linux

Debian パッケージ(.deb)をダウンロード, Linux x86-64, 9.2 MB
  • x86-64
  • Ubuntu 24.04 でビルド
  • 署名なし
  1. 依存関係も解決するため apt でインストールします: sudo apt install ./spacemosaic-linux-x86_64.deb
その他の形式(1)

Android

APKをダウンロード, Android arm64-v8a, x86_64, 42 MB
  • arm64-v8a, x86_64
  • Android 8.0+
  • 作者のリリース鍵で署名
  1. ブラウザーまたはファイルマネージャーからのインストールを許可し、APK を開きます。
  2. 以前に alpha.2 または alpha.3 のデバッグ APK を入れた場合は、先に削除してください。署名証明書が異なります。

iOS

通常のインストール方法はありません。 iOS 向けに公開されているのは次のビルドのみです:

  • spacemosaic-device.zip: 独自の署名とプロビジョニングが必要. インストール可能な IPA ではありません。Xcode で自分の開発チームを使って署名します。
  • spacemosaic-simulator.zip: シミュレーター専用(実機不可). Apple Silicon Mac の iOS シミュレーター専用です。

開発者はリリースページから入手するか、ソースからビルドできます。

iOS ビルドは開発者向けにのみ公開しています。実機用ビルドは Xcode で署名が必要で、シミュレーター用ビルドは iPhone では動作しません。

ダウンロードの検証

SHA256SUMS にはリリースファイルの SHA-256 ハッシュが記載されています。ハッシュが一致すれば、ファイルはリリースで公開されたものと同一です。これはチェックサムであり作者の署名ではないため、誰がビルドしたかは証明しません。

shasum -a 256 -c --ignore-missing SHA256SUMS

初めて使うとき

  1. ダウンロード欄から、お使いのシステム用ビルドをインストールします。

  2. macOS では公証がないため初回起動がブロックされることがあります。システム設定のプライバシーとセキュリティで許可してください。

  3. ボタンでフォルダーを選ぶか、ウィンドウにドラッグするか、コマンドラインでパスを渡します。

    spacemosaic /path/to/folder
  4. 大きな矩形をたどります。項目を選んで詳細を表示するか、大きなファイルやファイル形式の一覧を開きます。

対応環境と確認方法

  • macOS、Apple Silicon動作確認済み

    リポジトリには macOS arm64 での動作確認の記録があります。今回のカタログ点検では再実施していません。Intel 用ビルドはありません。

  • Android 8.0+ユーザーが 1 台の端末で確認

    以前の利用者報告では Pixel 8 と Android 17 で比較的安定して動作しています。署名、上書き更新、スクリーンリーダー、すべてのストレージプロバイダーでの動作は未確認です。

  • Windows x86-64CI でビルドと自動チェックに合格

    CI でビルドしています。以前のアルファ版は Windows 11 で試されましたが、その後の修正は同環境で再確認が必要です。

  • Linux x86-64CI でビルドと自動チェックに合格

    Ubuntu 24.04 でビルド。実行時の動作は実験的です。ポータブル版にも互換性のあるシステムライブラリが必要です。

  • iOS 16+CI でビルドと自動チェックに合格

    実験的な署名なし実機ビルドとシミュレータービルドのみです。iPhone へのインストールには Xcode、開発チーム、署名が必要です。

質問やバグ報告はプロジェクトのIssue トラッカーへ。セキュリティ上の問題はセキュリティポリシーに従って報告してください。