qlmanageはmacOS標準搭載のQuick Look管理・デバッグ用コマンドである。Quick Lookのプレビューやサムネイルをターミナルから生成でき、-oを使えばウィンドウを開かずにファイルへ出力できる。ここでは各オプションの使い方を解説した記事へリンクする。

Quick Lookのジェネレータの一覧を再読み込みしたいときや、サムネイルのキャッシュを作り直したいときは、qlmanage -rでQuick Lookをリセットする。

Quick Lookにどのファイル形式のジェネレータが登録されているかを調べたいときは、qlmanage -m pluginsを使う。 $ qlmanage -m plugins plugins: org.openxmlformats.wordprocessingml.document -> /System/Library/QuickLook/Office.qlgenerator (48) com.apple.iwork.keynote.sffkey -> /System/Library/QuickLook/iWork.qlgenerator (249) ... -mに統計の名前を続けると、Quick Lookのサーバーであるquicklookdの情報も表示できる。実行例はmacOS 27.0.1のもの。

Quick Lookのサーバーであるquicklookdを経由してサムネイルを生成したいときは、qlmanageに-xを付ける。-xを付けない場合は、qlmanageのプロセス内で生成される。

拡張子から種類を判別できないファイルや、拡張子と違う種類として扱いたいファイルでサムネイルを生成したいときは、qlmanageに-c <コンテンツタイプ>を付ける。使うジェネレータまで固定したいときは、-g <ジェネレータのパス>も付ける。

Quick Lookのサムネイルを生成するのにかかる時間を測りたいときは、qlmanage -tに-zを付ける。 $ qlmanage -t -z pic.png sample.txt t.html ... Thumbnails produced: 3 Duration: 0.223575 seconds (average 0.074525 seconds per file) 生成したサムネイルの数と、全体の所要時間、1ファイルあたりの平均時間が表示される。実行例はmacOS 27.0.1のもの。

枠や影の付いたアイコン形式のサムネイルを生成したいときは、qlmanage -tに-iを付ける。 $ qlmanage -t -i -s 200 -o out pic.png sample.txt $ ls out pic.png.png sample.txt.png -iは、-tでサムネイルを作るときだけ使えるオプションである。実行例はmacOS 27.0.1のもの。

qlmanage -tで生成するサムネイル画像の大きさを変えたいときは、-s <サイズ>でピクセル数を、-f <拡大率>で倍率を指定する。

Quick Lookのウィンドウを開かず、サムネイル画像やプレビューのデータをファイルとして保存したいときは、qlmanageに-o <出力先ディレクトリ>を付ける。

Finderでファイルを選んでスペースキーを押すと表示されるQuick Lookのプレビューを、ターミナルから開きたいときはqlmanage -pを使う。