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

$ qlmanage -t -x -o out sample.txt
Testing Quick Look thumbnails with files using server:
	sample.txt
* /path/to/sample.txt produced one thumbnail
Done producing thumbnails

-xはサムネイルとプレビューのどちらにも使える。実行例はmacOS 27.0.1のもの。

表示から使用の有無を確認する

-xを付けると、1行目の表示がwith files using server:になる。付けない場合はwith files:である。

$ qlmanage -t -o out sample.txt | head -n 1
Testing Quick Look thumbnails with files:
$ qlmanage -t -x -o out sample.txt | head -n 1
Testing Quick Look thumbnails with files using server:

-pでも同様に、Testing Quick Look preview with files using server:と表示される。

画像ファイルの結果はローカル生成と同じになる

画像ファイルでは、-xの有無でサムネイルの内容は変わらない。PNGファイルのハッシュ値が一致する。

$ qlmanage -t -s 200 -o local pic.png
$ qlmanage -t -x -s 200 -o server pic.png
$ md5 -q local/pic.png.png server/pic.png.png
e007271e8264632273ba644a8eeb0c20
e007271e8264632273ba644a8eeb0c20

テキストファイルは見た目が変わる

テキストファイルでは、-xの有無でサムネイルの見た目が変わる。ダークモードの環境で、3行のテキストファイルから生成したサムネイルを比べる。

$ qlmanage -t -s 300 -o local memo.txt

-xなしのテキストファイルのサムネイル

-xなしでは、背景が暗く、文字が小さく表示される。

$ qlmanage -t -x -s 300 -o server memo.txt

-xありのテキストファイルのサムネイル

-xありでは、背景が白く、文字が読める。

-xの有無で結果が異なるため、quicklookd経由の結果を確認したいときは-xを付ける。

プレビューの出力は変わらない

-p -oで出力されるプレビューは、-xの有無で変わらない。ファイルの種類ごとの.qlpreviewディレクトリの中身は、どちらも同じである。

$ qlmanage -p -o local memo.txt pic.png s.docx
$ qlmanage -p -x -o server memo.txt pic.png s.docx
$ ls local/s.docx.qlpreview server/s.docx.qlpreview
local/s.docx.qlpreview:
Preview.html
PreviewProperties.plist

server/s.docx.qlpreview:
Preview.html
PreviewProperties.plist

-zで所要時間を測る

-zと組み合わせると、quicklookd経由の所要時間を測れる。

$ qlmanage -t -x -z pic.png sample.txt
..
Thumbnails produced: 2
Duration: 0.164191 seconds (average 0.0820954 seconds per file)

所要時間は、Macの負荷で大きく変わる。ローカル生成と比べるときは、同じ条件で数回繰り返す。

参考: 【qlmanage】サムネイルの生成にかかる時間を測る (-z)