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

$ qlmanage -r
qlmanage: resetting quicklookd
$ qlmanage -r cache
qlmanage: call reset on cache

qlmanage -hには、-rがForce reloading Generators list、-r cacheがReset thumbnail disk cacheと説明されている。実行例はmacOS 27.0.1のもの。

-rでQuick Lookのサーバーをリセットする

qlmanage -rは、quicklookdをリセットする。qlmanage -hにはForce reloading Generators listと説明されている。man qlmanageには、Quick Look Serverとすべてのクライアントのジェネレータのキャッシュをリセットすると書かれている。

$ qlmanage -r
qlmanage: resetting quicklookd
$ echo $?
0

ジェネレータの一覧を再読み込みしたいときに実行する。リセット後にqlmanage -m pluginsで一覧を確認する。

参考: 【qlmanage】Quick Lookのジェネレータ一覧と統計情報を表示する (-m)

-r cacheでサムネイルのキャッシュを破棄する

-rの後ろにcacheを付けると、サムネイルのディスクキャッシュをリセットする。qlmanage -hにはReset thumbnail disk cacheと説明されている。

$ qlmanage -r cache
qlmanage: call reset on cache
$ echo $?
0

サムネイルのキャッシュを作り直したいときに実行する。メッセージがresetting quicklookdとcall reset on cacheで異なるように、-rと-r cacheは別の処理である。

リセットの結果は-mでは確認できない

-rや-r cacheを実行しても、qlmanage -mの表示は変わらない。serverの稼働時間はリセットされず、pluginsの一覧も実行の前後で同じである。

$ qlmanage -m plugins | md5 -q
0465317accc728af952f55c5f4d5f484
$ qlmanage -r
qlmanage: resetting quicklookd
$ qlmanage -m plugins | md5 -q
0465317accc728af952f55c5f4d5f484

quicklookdのプロセスIDも変わらない。

$ pgrep -x quicklookd
11927
$ qlmanage -r
qlmanage: resetting quicklookd
$ pgrep -x quicklookd
11927

-rや-r cacheは、終了コードが常に0である。終了コードは、リセットの成功を保証しない。

引数の制限

-rの引数に使えるのはcacheだけである。それ以外を指定すると、エラーになり、終了コードは1になる。

$ qlmanage -r bogus
qlmanage: invalid argument bogus
Usage: qlmanage [OPTIONS] path...
...
$ echo $?
1

-rと-mは同時に指定できない。qlmanage -r -m serverはinvalid argument -mで失敗する。リセットと確認は別々のコマンドで実行する。

サムネイルのキャッシュの場所

サムネイルのキャッシュは、ユーザーのキャッシュディレクトリの下にある。ディレクトリのパスはgetconf DARWIN_USER_CACHE_DIRで調べられる。

$ ls "$(getconf DARWIN_USER_CACHE_DIR)com.apple.quicklook.ThumbnailsAgent"
com.apple.QuickLook.thumbnailcache
com.apple.quicklook.ThumbnailsAgent

com.apple.QuickLook.thumbnailcacheの中身は、lsを実行してもOperation not permittedになり、一覧できない。キャッシュを手作業で削除する代わりに、qlmanage -r cacheを使う。