ダウンロードファイルからのインストール

ダウンロードしたzipファイルを任意のフォルダに解凍します。解凍先のquality-work/quality-work.exeが実行ファイルです。

バージョン移行の準備（旧バージョンをお使いになっていた方へ）

V1.0版からアップグレードされる方へ

これまで使っていたプログラムのデータを新しいV2.0版に引き継ぐため、データベースファイルを取り出して保存しておいてください。データベースファイルはインストールフォルダの下の以下のファイルです。

quality-work/_internal/db.sqlite3

V2.0版からアップグレードされる方へ

上記のデータベースファイルに加え、Audio関連の設定ファイルを取り出して保存しておいてください。設定ファイルはインストールフォルダの下の以下のファイルです。

quality-work/_internal/media/audio_settings.json

データの移行方法については、こちらを参照ください。

システム設定

Windowsの場合

　特に必要な設定はありません。

MacOSの場合

　Quality-Workが表示されたウインドウやキーボード・マウスからの入力情報にアクセスできるようにするために、「システム設定」でアクセシビリティの設定を行います。

  • 「プライバシーとセキュリティー」→ 「アクセシビリティ」を開く
  • コンピュータの制御を許可されているアプリケーションに「ターミナル」が表示されるか確認し、これがアクセス許可になっているかを確認する
  • 「ターミナル」がすでにある場合、これが許可されていなかったらアクセスを「許可」にする
  • 「ターミナル」が表示されていない場合、下の ＋ ボタンをクリックし、表示されるファインダーのアプリケーションから「ターミナル」を選ぶ

MacOSでお使いになる方へ (2025年10月28日)

　MacOS用にリリースしたQuality-Workモジュールは、Appleからの認証ができていないため、そのままではセキュリティー上のエラーが出て実行できないことがわかりました。

　根本解決にはApple認証取得およびモジュールの検証が必要ですが、このためにはしばらく時間がかかりそうです。そこで、セキュリティーエラーを回避するために、以下の暫定的な対策をお願いします。

　ターミナルを開いていただき、以下のコマンドを実行後、quality-workを実行ください。

 (1) xattr -dr com.apple.quarantine [インストールディレクトリ]/quality-work-3
 (2) codesign --force --deep --sign - /[インストールディレクトリ]/quality-work-3/quality-work

＜詳細説明＞

“xattr"はMacOSのGatekeeperが使う「検疫属性」を操作するコマンドです。MacOSの場合、com.apple.quarantineという拡張属性がファイルに自動的に追加され、この属性の値には、「いつ」「どのアプリ（ブラウザ）で」「どこから」入手したか、という情報が入っています。この情報を見て、起動して良いかどうかを判断します。(1)を実行することによりフォルダの下のファイルに追加された検疫属性を全て解除します。

"codesign”は実行モジュールに署名を行うコマンドです。(2)を実行することにより、実行モジュールに「自己署名」を行います。これにより、macOS はquality-workを信頼できるアプリケーションとして認識し、実行可能になります（署名を行わなくても検疫属性の解除だけで実行できるかもしれませんが、念の為の処置です。）

プログラムの実行と終了

  • WindowsのエクスプローラやMac OSのFinderなどでquality-work.exeファイルをダブルクリックすると、プログラムが実行されアクティビティの記録が開始されます。
  • プログラムの実行が開始されると、ターミナルウインドウが画面上に表示されます。ターミナルウインドウを終了するとプログラムも終了します。
  • ブラウザで '127.0.0.1:8000/' にアクセスすると、記録されたデータや各種グラフが表示できます。

スタートアップの設定

上記のようにプログラムは手動で実行できますが、PCを起動したり、ログインしたりする度に毎回手動で起動するのは面倒です。これを避けるために、PCにログインした後に自動的にプログラムを起動するための設定を行います。プラットフォームごとの設定手順は以下の通りです。

Windowsの場合

Explorerなどで、quality-work/quality-work.exeを右クリックをしながら、

C:\Users\＜ユーザー名＞\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup

のフォルダまでドラッグします。「ショートカットを作成」を選びこのフォルダにショートカットを作ります。

macOSの場合
  • 「システム設定」を開き「 一般」の「 ログイン項目」を選びます
  • 「ログイン時に開く」の「＋」ボタンを押すとFinderが表示されますので、ここでインストールした実行ファイル(quality-work.exe)を選び「開く」をクリックします

注意：

スタートアップから起動した場合にも、シェルウインドウは表示されます。邪魔であれば、ウインドウを最小化するなどで対処ください。