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

目次†

基本的な使い方†

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

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

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

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

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

(CopyQ のショートカット機能では Winキー は選択できないので Win + V にはできない)

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

スニペット機能†

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

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

#ref(): File not found: "スクリーンショット 2024-08-26 220951.png" at page "ソフトウェア/CopyQ を使ってクリップボード履歴を管理する"

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

#ref(): File not found: "スクリーンショット 2024-08-26 221333.png" at page "ソフトウェア/CopyQ を使ってクリップボード履歴を管理する"

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

#ref(): File not found: "スクリーンショット 2024-08-26 221607.png" at page "ソフトウェア/CopyQ を使ってクリップボード履歴を管理する"

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

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

CopyQ のサイトにほとんどそのまま使えるコードがあった。
https://copyq.readthedocs.io/en/latest/command-examples.html#show-copy-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) {
      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 // iterate from the last to the first
      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==0) copy('') // 消せるときと消せないときがある？？？
    }
    "
IsScript=true

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

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

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

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

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

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

クリップボードへコピーがあるたびに、古い履歴を消すようにした。

[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()" を付けて呼び出せばいい。