Sparklux Library ヘルプ

Sparklux Library は何をするアプリか

自分で撮った・集めた動画を、フォルダのまま一覧にして、タグとお気に入りで探せるようにします。再生には Sparklux と同じ再生の仕組みを使い、SDR の動画を HDR にして、解像度を拡大して表示します。

• 動画ファイルは動かさず、書き換えません。タグは本アプリの中だけに保存します（Finder のタグは使いません）
• 10 万本を超えるライブラリでも、一覧は止まらずに表示します

動作条件

はじめに — フォルダを追加する（⌘O）

1. 「フォルダを追加…」を押して、動画の入ったフォルダを選びます。最初は「ムービー」フォルダが開くので、そのまま［追加］を押せば「ムービー」を登録できます（ウィンドウにフォルダをドラッグしても追加できます）
2. 中の動画を探して一覧に出します。見つかった順に出るので、終わるのを待たずに使えます
3. 次からは、追加したフォルダを自動で見に行きます

• 既に追加したフォルダ（やその中のフォルダ）を選び直すと、そのフォルダを表示します
• 他のアプリの保存領域・一時的な場所・パッケージの中のフォルダは追加できません
• 追加をやめるときは、サイドバーのフォルダを右クリック →「登録を外す…」。動画ファイルには触りません

一覧と検索

• 見た目はツールバーの「グリッド ／ アルバム」で切り替えます（⌘1 / ⌘2。表の形のリストは「表示」メニューか ⌘3）。選んだ見た目はライブラリごとに覚えます（この Mac の中だけ）
  • グリッド: 同じ大きさの絵が並びます。探す・選ぶときに。絵の大きさはツールバーの「大きさ」のスライダーで変えられます
  • アルバム: 撮った日ごとに章になります。章の先頭はいちばん評価の高い 1 本を大きく、続けて 8 本。もっとある日は「+N 本 この日の残りを見る」を押すと、その日だけのグリッドになります（条件バーの日付を押すと戻ります）
  • 撮った日と場所は、動画に記録された撮影日時と位置から読みます（タグは作りません）。場所の名前は、アプリに入っている地名の一覧で、この Mac の中だけで引きます。撮影日時の無い動画は最後の「撮影日なし」の章に入ります
• 並べ替えは名前・追加日・ファイルの更新日・長さ・評価
• 検索欄はファイル名とタグ名の一部で探せます（「京都」のような 2 文字でも当たります）
• 条件バーで絞り込めます
  • タグ: サイドバーのタグをクリック。⌘ クリックで足す（「すべてを含む」「どれかを含む」を切り替え）・⌥ クリックで除外
  • 解像度・HDR・長さ・利用可だけ: チップから選びます。長さは「範囲を指定…」で片方だけでも指定できます
  • メタデータをまだ読めていない動画は、解像度・HDR・長さの条件の対象外になります（件数を表示します）
• 絞り込みの条件は、次に開いたときもそのまま残ります

タグとお気に入り

• 動画を選んで ⌘T（タグを付ける…）。名前を打って Return で付けます。新しい名前なら新しいタグになります
• 複数の動画を選んでまとめて付けられます
• お気に入り は ⌘D（または ♥）。もう一度で外れます
• タグの名前を変える・削除するときは、サイドバーのタグを右クリック。既にある名前に変えると 1 つにまとまります
• タグは動画の中身に付きます。同じ動画のコピーには同じタグが付き、動画を別のフォルダに移してもタグは付いたままです
• タグは親子にまとめられます。家族/子ども のように / で区切って打つと、「家族」の下の「子ども」になります（無い親はその場でできます）。親を選ぶと、その下のタグが付いた動画も全部出ます。動画に付くのは子のタグだけです
• 親を変えるときは、タグ ▸ タグ…（⇧⌘T）の［一覧］でタグをドラッグします（複数をまとめて・右クリックで「新しい親を作ってまとめる…」）。親を消すと、下のタグは 1 つ上に上がります

動画が見えないとき（状態の表示）

• フォルダごと別のディスクに移したときは、サイドバーのフォルダを右クリック →「場所を指定し直す…」
• 見つからない動画を一覧から消すときは「ライブラリから削除…」（⌘⌫）。動画ファイルには触りません
• 動画が移されたことに気付いて付け替えたときは、画面の下に短く表示して自然に消えます

再生

• ダブルクリック（またはインスペクタの「再生」）で再生します。再生の操作は Sparklux と同じです（Space・←→・⌘K の画面のキャリブレーションなど）
• 続きから再生: 10 秒以上見た動画は、止めた所から始まります。最後の 5% まで見ると「視聴済み」になり、次は先頭から
• 「視聴済みにする」「未視聴に戻す」はインスペクタから
• ほかのアプリで開く（⇧⌘O）: 選んだ動画を、ふだん使っている動画プレイヤーで開きます。インスペクタのボタン・一覧の右クリック・ファイルメニューから。複数を選ぶとまとめて渡します（10 本を超えると確かめます）
  • 使うアプリは「このアプリで開く ▸」の「既定のアプリを選ぶ…」で選びます（最初は macOS の既定のアプリ）。「このアプリで開く ▸」から、その場で別のアプリも選べます
  • つながっていないディスク・共有の動画と、iCloud にだけある動画は渡しません（理由を表示します）。iCloud にだけある動画は、このアプリで一度再生するか Finder でダウンロードしてから開いてください
• Finder で表示（⌥⌘R）: 選んだ動画を Finder で選んだ状態にします。インスペクタのボタン（1 本のとき）・一覧の右クリック・ファイルメニューから。複数を選ぶと、まとめて Finder で選んだ状態にします（10 本を超えると確かめます。フォルダが違えば、フォルダごとに Finder の窓が開きます）
  • つながっていないディスク・共有の動画と、見つからない動画は表示しません（理由を表示します）。iCloud にだけある動画は表示できます
• 場所（フルパス）: 1 本を選ぶと、インスペクタの長さ・サイズ・フォルダなどの並びの最後に「場所」として動画のフルパス（例 /Volumes/外付け/旅行/2024/IMG_0001.MOV）が出ます。長いときは途中を省略し、ポインタを重ねると全体が出ます（NAS の動画ではサーバー名も）。文字を選んでコピーするか、右クリック →「パスをコピー」（⌥⌘C）
  • つながっていない・見つからない動画は「最後に見た場所」として、最後に分かっていた場所と今の状態を出します。iCloud にだけある動画はその旨を添えます
  • パスワードを掛けたライブラリでも、開いている間は出ます。コピーしたパスは、施錠してもクリップボードに残ります
• パスワードを掛けたライブラリでは、「ほかのアプリで開く」「Finder で表示」を使うと、ほかのアプリや Finder の最近の項目に残ります（押す前にその旨を表示します）

ライブラリを分ける・パスワードを掛ける

• 「新しいライブラリ…」（⌘⇧N）で、フォルダ・タグ・お気に入りを別にしたライブラリを作れます
• ライブラリを切り替えるときは、サイドバーのいちばん上のライブラリの名前（⌄ の印）を押してメニューから選ぶか、「ライブラリ」メニュー ▸「ライブラリを切り替える」。フォルダをまだ追加していないライブラリの画面にも「別のライブラリ ▾」が出ます
• 名前を変える・消すときは、サイドバーのいちばん上のライブラリの名前を押す（または「ライブラリ」メニュー）→「名前を変更…」「ライブラリを削除…」。効くのは開いているライブラリです
  • 消すと、そのライブラリのタグ・お気に入り・評価・棚・再生位置・追加したフォルダの一覧・サムネイルがこの Mac から消えます（元に戻せません）。動画ファイルには触りません
  • ライブラリが 1 つだけのときは消せません（先に新しいライブラリを作ってください）
  • 同期している別の Mac では、そのライブラリは消えずに残り、同期から外れます
• 作るときにパスワードを掛けると、一覧・タグ・サムネイルを暗号化して保存します
  • 「ライブラリを施錠」（⌘⌃L）・Mac のスリープ・15 分操作しないと施錠します
  • 開いている間は、最近開いた項目・再生中の題名の表示などに名前を残しません
  • ⚠️ パスワードを忘れると、そのライブラリは開けません（動画ファイルは無事です）。パスワードはどこにも保存していないので、開発者にも戻せません
• 作った後でも、「ライブラリ」メニューか、サイドバーのいちばん上のライブラリの名前を押してパスワードを掛ける…／変える…／外す…を選べます（開いているライブラリに効きます）
  • 掛ける・外すは中身を保存し直すので、大きいライブラリでは数分かかります。途中で［中止］すると元のままです
  • 掛け終わると、暗号化する前のファイルはこの Mac から消します（Time Machine のバックアップには残っていることがあります）
  • 同期している別の Mac には、パスワードの掛かった新しいライブラリとして届きます。その Mac にある今のライブラリはその Mac に残るので、要らなければその Mac でそのライブラリを開き、サイドバーのいちばん上の名前を押して →「ライブラリを削除…」で消してください（動画ファイルには触りません）

iCloud 同期

同じ Apple ID の Mac どうしで、タグ・お気に入り・再生位置・視聴済みがそろいます。

• 動画は中身で見分けるので、Mac ごとに置き場所（フォルダの場所・共有のつなぎ方）が違ってもそろいます
• ファイル名・フォルダの場所は iCloud に送りません。送る中身は Mac の中で暗号化してから送ります
• パスワードを掛けたライブラリは、別の Mac でも同じパスワードで開けます
• iCloud にサインインしていなくても、同期以外はすべて使えます

料金

買い切りです。 3 日間の無料期間のあと、一度購入すると、同じ Apple ID のすべての Mac で使えます。月額料金はありません。

• 初めて起動したときに 1 回だけ、無料期間の日数と、終わると止まる機能と、価格をお知らせします（［購入…］［あとで］）
• 無料期間中は、ライブラリのウィンドウの下に残りの日数と［購入…］が出ます（購入すると消えます）
• 購入の画面は［閉じる］で閉じられます。無料期間が終わったあとは、再生しようとしたときにまた出ます
• 別の Mac で使うときは、メニューの「購入を復元」を選んでください（復元できると「購入を復元しました」と出ます）
• 無料期間の管理に iCloud を使います（開始日のみ。→ プライバシーポリシー）
• 無料期間が終わっても、ライブラリとタグは消えません。再生・「ほかのアプリで開く」・「Finder で表示」は、押したときに購入の案内が出ます（項目は灰色で残ります）。一覧・タグ付け・検索はそのまま使えます

データを消す

• 本アプリのデータ（ライブラリ・タグ・サムネイル）は、Mac の ~/Library/Containers/dev.monneural.sparklux.library にあります。アプリを削除しても macOS が残すことがあるので、消すときはこのフォルダを削除してください
• iCloud のデータは、システム設定の「Apple アカウント」→「iCloud」→ 保存容量の管理 から削除できます

謝辞

本アプリには次のソフトウェアが含まれています（アプリのメニュー「謝辞…」でも見られます）。

• SQLCipher Community Edition（Zetetic LLC）— BSD 3-Clause License。全文は下
• SQLite — パブリックドメイン（SQLCipher の一部として含まれています）
• 自動タグ付けの「名前で判定」の部品 — MLX Swift・MLX・MLX C・MLX Swift LM・{fmt}・JSON for Modern C++・yyjson・EventSource（MIT License）、metal-cpp・Swift Transformers・Swift Jinja・Swift Hugging Face・Swift Collections・Swift Crypto・Swift Numerics（Apache License 2.0）。全文はアプリのメニュー「謝辞…」で見られます
• Qwen3-VL（Alibaba Cloud）のモデルの重み — Apache License 2.0。アプリには含まれず、［ダウンロード］を押したときだけ Hugging Face から落とします

再生・HDR 変換・拡大の部分は、同じ開発者（mon neural）の Sparklux から取り込んだもので、第三者のコードを含みません。

Copyright (c) 2025, ZETETIC LLC
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.
    * Neither the name of the ZETETIC LLC nor the
      names of its contributors may be used to endorse or promote products
      derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY ZETETIC LLC ''AS IS'' AND ANY
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL ZETETIC LLC BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

お問い合わせ

hello@monneural.dev

事業者: mon neural