xshoji's blog

5 min read

BetterTouchTool: キーシーケンスによるスニペット入力機能が突然動作しなくなったが、OSアップデートで解決した話

#BetterTouchTool #BTT #macOS #トラブルシューティング

目次

はじめに

普段BTTを愛用していて、キーシーケンスによるスニペット入力をよく使います。 これは、たとえば

  • ;now とタイプすると 2026-01-17(土) 02:36:13 と展開される

といったものです。 こういった単純なスニペット展開から、最近だとAIへのプロンプトを呼び出したり大変便利です。

そんなキーシーケンスによるスニペット入力機能ですが、数日前まで普通に使えていたのに、ある日突然動かなくなりました。

設定は一切変えていないし、macOSも普段どおり使っているだけです。それなのに、トリガーが一切発火しない。

最初は「まあBTTだし、たまにあるよね」くらいの気持ちで調査を始めたのですが、結果的にこれはググっても、SNSを見ても、ほぼ辿り着けない系の不具合でした。

この記事では最終的にどうやって答えに辿り着いたのか、その流れをネタとして書き残しておきます。

数日前まで動いていた機能が、突然死にました

使えなくなったのは、BTTの Keyboard Sequence トリガー を使ったスニペット機能です。

ある日（というか今日）、いきなり動作しなくなりました。

BTTいじってないし、文字通り「何もしてないのに動かなくなりました！！」状態でした。

まずはBTT側の不具合を疑ってみた

真っ先に疑ったのはBTT自身の不具合です。というのも、BTTって結構バグること多くて、マイナーアップデートもかなり頻繁にあるので、またそれかなー程度に思ってました。なので

  • 最新バージョンへアップデート
  • 数バージョン前へロールバック
  • 再起動
  • 設定のON/OFF

あたり一通り試してみたのですが、全部ダメでした。 この段階で「BTTのバグっぽくないのでは？」という感触を得ました。 （特に、問題なく動作していたバージョンにロールバックしてもダメだったのが大きかった）

公式フォーラムやXを漁るが、誰も騒いでいない

次に念の為、以下を覗いて情報収集してみました。

BetterTouchTool Community
https://community.folivora.ai/

x.com - search
https://x.com/search?q=better%20touch%20tool&src=typed_query

ですが、全然同じ症状で困っている人が見当たりませんでした。 BTTが壊れているなら、もっと騒ぎになっていてもよさそうなのに、そしてロールバックしてもダメだったことと総合的に考えて、自分環境固有の問題っぽいな、と思い始めたのでした。

現象をちゃんと見ることにした

ここで方針を変え、「直す」よりも「何が起きているか」を見ることにしてみました。 で、BTTの Keyboard Sequence の設定画面 を開き、実際にキー入力をしてみて気づいたのですが、 なんと設定の時点でキーが認識されないのです。 これはつまり、BTTがキーボードからの入力をそもそも受け取れていない、ということを意味します。

…ただ、さらによく観察すると、一部のキーは認識されるというとても奇妙な状態であることがわかりました。

  • a, b, c, 1, 2, 3 などのキー → 無反応
  • Shift, Control, Command, Tab など → 反応する

つまり、修飾キーだけは認識されているという状態です。

この時点で

  • キーボード自体の故障ではない（当たり前ですが）
  • BTTも一部のキー入力は受け取れている

ということは確定しました。

ググるのを諦めて、ChatGPTに投げた

正直、この状態は症状がニッチすぎるのと、何てググれば良いのかもよくわからない状態になっていたので、これまでの観測結果をそのままChatGPTに投げてみました。

AIと壁打ちの末、「macOSのセキュリティアップデート」が原因では？という話になり、ChatGPTが以下の仮説を出してきました。

  • macOS側が 通常キーのイベントだけを落としている
  • 修飾キーが通るのは、OS設計上の都合
  • 直前に行った macOS Sonoma のセキュリティアップデートが怪しい

言ってなかったんですが、直近macOSのセキュリティのパッチが来てたので、 Sonoma のアップデートを当てたばかりだったんですよね。自分はそこ関係してるとは全く思わなかったので、とりあえず ほーん、くらいに思い一旦休憩しました。

乗り気ではなかったが、macOS 26 に上げてみた

1時間くらい経ったタイミングで、もう打つ手もないし、OSアップデートするかー、と思い立ち、 macOS 26 に上げることにしました。

そもそもアップデートしてなかった理由は

  • 自分のPCが最後のIntel Mac機（2020年製）なのでちゃんと動作するか不安
  • PCのスペックが高くないのでシンプルに重そう
  • 安定性を優先したい、メジャーアップデート直後だし

という感じで、もう少し様子見してからあげようと思ってたので、渋ってた感じでした。

ですが、OSが原因なら、上げるしか検証手段がないという結論になり、 macOS Sonoma → macOS 26 にアップデート。

その結果…. “完全復活” しました🎊

BTTのキーボードシーケンスも、スニペットも、何事もなかったかのように動き出したのでした。

ちなみに問題があった時のBTTやmacOSのバージョンは以下の通りです。

  • BTT: 6.011
  • macOS: Sonoma 14.8.3

教訓：この問題は「検索」では解けなかった

今回遭遇した事象は、ググってもフォーラムを見てもSNSを巡回してもほぼ確実に解決できない類の不具合でした。 というのも、発生条件がだいぶニッチですし、騒がれるほどの母数がないので調べようがない感じだったんですよね。

ChatGPTに相談してからは

  • 観測事実を整理
  • 可能性を一つずつ潰し
  • 「どこまでがアプリの責任か」を切り分け
  • 最終的に OSが原因だと腹落ちする

というところまで辿り着くことできま、マジで助かりました。

おわりに

情報収集にAIを使うのも便利ですが、問題の切り分けや解決策の壁打ち相手にAIを使うことで、解決策が転がってないような課題でも比較的スムーズに解決できることを改めて実感しました。

BTTに限らず、同じように「理由はわからないけど壊れた」という状況にハマった人の参考になれば幸いです。