自動化

TinyRecorder は AppleScript で操作できます。ターミナル、ショートカット、Raycast、Alfred、Keyboard Maestro、自作のスクリプトから録画を開始・停止できます。

ターミナルから

osascript でコマンドを実行します:

osascript -e 'tell application "TinyRecorder" to record screen numbered 1'
osascript -e 'tell application "TinyRecorder" to stop recording'

初回は、スクリプトを実行する App(例:ターミナル)が TinyRecorder を制御してよいか macOS が確認します。「OK」をクリックしてください。あとから「システム設定」›「プライバシーとセキュリティ」›「オートメーション」で変更できます。

ショートカット、Raycast などの App

ショートカット App で「AppleScript を実行」アクションを追加し、スクリプトを貼り付けます。Raycast、Alfred、Keyboard Maestro では AppleScript や上の osascript コマンドを直接実行できます。

コマンド

コマンド動作
record screen numbered 1ディスプレイ 1 を録画(番号は 1 から)。numbered を省略すると画面の選択を開きます。
record application named "Safari"App を名前で指定して録画。named を省略すると App の選択を開きます。
record window titled "タイトル" in application "Safari"ウインドウを正確なタイトルで指定して録画。in application は省略可。titled を省略するとウインドウの選択を開きます。
record screen area範囲選択を開き、マウスで範囲をドラッグします。
record system audioシステムオーディオのみ録音。microphone true を付けると今回はマイクも録音します。
pause recording / resume recording録画を一時停止 / 再開。
stop recording録画を停止して保存。
discard recording録画を停止し、ファイルをゴミ箱に移動。
configure …録画設定を変更(下記参照)。

設定の変更

configure には次のパラメータを自由に組み合わせて指定できます。変更は環境設定で変えた場合と同じく保存されます。録画中は使えません。

パラメータ値
fps10、15、24、30、60、90、120、144、240 のいずれか
quality1 = 低、2 = 中、3 = 高
hirestrue で Retina 解像度
cursorマウスポインタを録画するか
soundシステム / App のサウンドを録音するか
microphoneマイクを録音するか
mic device入力デバイス名、または "default"
hdrHDR で録画(macOS 15 以降)
save folder録画の保存先フォルダ。既存のフォルダである必要があり、~ も使えます

例:1 分間録画する

いくつかの設定を変更し、ディスプレイ 1 を 60 秒間録画してから停止・保存します。

tell application "TinyRecorder" configure fps 30 quality 2 cursor true save folder "~/Movies" record screen numbered 1 end tell delay 60 tell application "TinyRecorder" to stop recording

補足

  • 録画コマンドはすぐに戻ります。「録画開始までの待ち時間」(環境設定 › 録画)を設定している場合、録画はカウントダウン後に始まるので、その分を delay に足してください。
  • カウントダウン中に stop recording または discard recording を送ると、録画は開始前に取り消されます。別の録画コマンドは「録画中」として拒否されます。
  • 名前が複数のウインドウに一致する場合や、App のウインドウが複数の画面にある場合は、選択画面が開くので手動で選んでください。
  • エラー(すでに録画中、録画していない、画面収録の権限がない)はスクリプトに返され、osascript はエラーで終了します。
  • iPhone / iPad の録画では pause、resume、discard は使えません。stop recording は使えます。