CopyQ を使ってクリップボード履歴を管理する の履歴(No.4)

目次†

基本的な使い方†

• コピーした内容は自動的に CopyQ の履歴に入る
• タスクトレイのアイコンを左クリックするとメイン画面が表示される
  • そのままキー入力するとクリップボード内容を検索可能
  • 上下矢印キーで選択して ENTER で貼り付け

メイン画面表示のショートカットを設定†

わざわざタスクトレーアイコンをクリックするのは面倒なのでショートカット設定は必須。

タスクトレーアイコンの右クリックから [設定] を選択

[ショートカット] の [メインウィンドウの表示切り替え] の ＋ をクリックして、 例えば Ctrl + Alt + C を割り当てる。

すると、他のアプリを使用中でも Ctrl + Alt + C で CopyQ が立ち上がるようになる。

スニペット機能†

メインウィンドウの [タブ] メニューから新しくタブを追加して、 そこにスニペットとして使う内容を追加するのが良さそう。

• 左右の矢印キーで表示するタブを変更できる

このように各項目の行数が多くて一覧性が悪い場合には、 設定で 「アイテムをシンプルに表示」 をチェックしておくと

このように見やすくなる。

クリップボード履歴にコピーした時刻を持たせる†

「古い履歴」を消すにはそれがいつコピーされたかという時刻の情報を持たなければならない。

CopyQ のスクリプト例にほとんどそのまま使えるコードがあった。
https://copyq.readthedocs.io/en/latest/command-examples.html#show-copy-time

このコードのタグの区切り文字のカンマの後ろにあったスペースを除去した。

var tags = str(data(tagsMime)) + ', ' + time

を

var tags = str(data(tagsMime)) + ',' + time

ということ。

そうしてできたコードがこれ：

[Command]
Automatic=true
Command="
    copyq:
    var time = dateString('yyyy-MM-dd hh:mm:ss')
    setData('application/x-copyq-user-copy-time', time)

    var tagsMime = 'application/x-copyq-tags'
    var tags = str(data(tagsMime)) + ',' + time
    setData(tagsMime, tags)"
Icon=\xf017
Name=Store Copy Time

使い方は、

• このコードをコピーしてから CopyQ のメインウィンドウを表示する
• F6 を押すとコマンドウィンドウが現れる
• Ctrl + V で張り付けると Store Copy Time という項目が追加される

Automatic=true の指定があるため、このコードはクリップボードへデータがコピーされるたびに呼び出される。

• 時刻を表す文字列は "2024-01-01 01:01:01" の形式
• application/x-copyq-user-copy-time タイプの情報としてクリップボードに入れる
• 同時に、タグとしても同じデータを付けておく（これは表示用）

時刻で選別して古いものを消すコマンドを実装する†

これが Auto Delete 相当の機能になる

上と同様の手順で以下を張り付ける：

[Command]
Name="removeOldItems(millisec=0)"
Command="
    copyq:
    global.removeOldItems = function(millisec=0) {
      // 現在時刻より millisec だけ昔の時刻を表す文字列を作る
      var old = new Date(Date.now()-millisec)
      var str = ''
      str += ('000' + old.getFullYear()).slice(-4)
      str += '-' + ('0' + (old.getMonth() + 1)).slice(-2)
      str += '-' +('0' + old.getDate()).slice(-2)
      str += ' ' +  ('0' + old.getHours()).slice(-2)
      str += ':' + ('0' + old.getMinutes()).slice(-2)
      str += ':' + ('0' + old.getSeconds()).slice(-2)

      // １つ目のタブに切り替える
      // １つ目のタブがクリップボード履歴であると仮定している
      var save = selectedTab()
      tab(tab()[0])
      var i = size() - 1 // 履歴情報を後ろから順に確認
      while(i >= 0){
        // 時刻情報が３０分前より古く、ピン止めや時刻以外のタグがなければ消す
        var time = getItem(i)['application/x-copyq-user-copy-time']
        if(time && time < str && !plugins.itempinned.isPinned(i)) {
          if(!plugins.itemtags.tags(i).find((tag)=>tag!=time)) {
            remove(i)
          }
        }
        i-- // 次へ
      }
      tab(save) // タブを元に戻す

      // 全消去時にはクリップボードの中身も消す
      if(!millisec) copy('') // なぜか消えない時がある？？？
    }
    "
IsScript=true

すると、removeOldItems(millisec=0) という項目が追加される。

この項目は [スクリプト] に指定されており、内部では global という名のグローバル変数プールに removeOldItems という関数を追加している。

このように追加した関数は、他のスクリプトから呼び出せるほか、コマンドライン引数の中からも実行が可能になる。

で、肝心の関数の中身は、

• 現在時刻から millisec で指定されただけ過去の時刻を元に "2000-01-01 00:00:00" 形式の文字列を作る
• １つめのタブ（これがクリップボード履歴に相当する）の項目を後ろから順に見ていく
  • 後ろから見るのは項目を消去したときにおかしくならないようにするため
  • 'application/x-copyq-user-copy-time' の情報を取り出して、時刻を比較し古いものだけを処理
  • ピン止めされておらず、時刻以外のタグが付いていなければ消去する
• 何も残らなければ、つまり最新の除法でさえ古いものであれば、クリップボード自体もクリアする
• millisec を省略すると 0 を指定したのと同じになるため、常にすべての履歴が消去される

クリップボードへのコピーがあった時に呼び出す†

クリップボードへコピーがあるたびに、30分以上前の履歴を消せるよう removeOldItems を呼び出す。

[Command]
Automatic=true
Command="
    copyq:
    removeOldItems(30*60*1000)  // 30 min
"
Icon=\xf12d
Name=Clear Old History

クリップボードへのコピーを行わないと消えないので本当はちょっと不満なのだけれど、 まあそこまで厳密にしなくても？

履歴一覧の表示前に呼び出されるコールバックがあればそこに記述したいのだけれどなあ。

（どうしてもやりたければ下でタスクスケジューラを利用した方法を紹介している）



\xf12d

Windows のロック画面が表示されたらクリップボードを空にする†

• ピン止め・タグ付けされていないすべての履歴を消す
• クリップボード自体も空にする

これは引数無しで removeOldItems() を呼び出せばいいのだけれど、

「Windows のロック画面（ログイン画面）が表示されたら特定のスクリプトを実行する」という設定は CopyQ にはない

そこで Wimdows 標準の「タスクスケジューラ」から CopyQ を呼び出す形で対応する。

ロックされたら copyq.exe に --eval "removeOldItems()" を付けて呼び出せばいい。

タスクスケジューラを起動†

スタートボタンを押して task と入れればタスクスケジューラが見つかるはず。

タスクを作成＆名前を付ける†

トリガーを「ワークステーション ロック時」にする†

トリガータブで「新規」

「ワークステーション ロック時」としてOK

トリガーが追加された

操作で CopyQ を呼び出す†

[操作] タブで [新規]

[プログラム] にフルパスで copyq.exe を指定、引数に --eval "removeOldItems()" を指定

正しく項目が追加された

条件で「AC 接続時のみ」のチェックを外す†