GazeOverlay · User Manualユーザーマニュアル
See how you actually play.
GazeOverlay is a webcam eye-tracker for Valorant. It draws your live gaze over the game and measures focus, reaction time, APM, and kills / deaths — then saves every session as data you can review. This manual documents every part of the app. Valorant用のウェブカメラ・アイトラッカーです。ゲーム画面上に視線をリアルタイム描画し、集中力・反応速度・APM・キル / デスを計測。各セッションはデータとして保存され後から分析できます。本マニュアルはアプリの全機能を解説します。
The live overlay, drawn over your game.ゲーム画面上に描画されるライブオーバーレイ。
Getting Startedはじめに
Requirements
- Windows PC with a webcam (built-in or external).
- The Beam Eye Tracker app — from Steam or the Eyeware website. One GazeOverlay build works with both; it detects your Beam version and loads the matching driver automatically.
- Valorant — the reflex & killfeed features are tuned for it. Focus, gaze, and APM work in any game.
- Keep
GazeOverlay-Unified.exeandyolov8n.onnxin the same folder.
- ウェブカメラ付きのWindows PC（内蔵・外付け可）。
- Beam Eye Tracker アプリ — Steam版またはEyeware公式サイト版。GazeOverlayは1ビルドで両対応し、Beamのバージョンを判別して対応ドライバーを自動読み込みします。
- Valorant — 反応・キルフィード機能はValorant向けに最適化。集中力・視線・APMは全ゲームで動作。
GazeOverlay-Unified.exeとyolov8n.onnxは同じフォルダに配置。
No Beam? Still useful. Focus / fatigue tracking runs from the webcam alone. Beam only adds the high-accuracy gaze used for aiming analytics and auto-training.Beamがなくても使えます。 集中力・疲労トラッキングはウェブカメラ単体で動作。Beamは照準分析や自動学習に使う高精度な視線を追加するだけです。
Getting Startedはじめに
Install & Beam setup
Install and open Beam Eye Tracker, sign in, and start tracking so its own gaze dot moves. Then set one setting that matters:Beam Eye Tracker をインストールして起動、サインインしてトラッキングを開始します（Beam自身の視線ドットが動く状態に）。次に唯一重要な設定を行います：
Critical setting重要設定
Camera Access = Shared
Shared lets GazeOverlay read the same webcam at the same time as Beam. Exclusive locks the camera and GazeOverlay sees nothing. This is the single most common setup mistake.Shared（共有） でGazeOverlayがBeamと同時に同じウェブカメラを読み取れます。Exclusive（排他） はカメラを占有し、GazeOverlayは何も認識できません。最も多いミスです。
Getting Startedはじめに
First launch
With Beam running, double-click GazeOverlay-Unified.exe. First launch can take up to a minute to unpack (a splash screen shows progress). When Beam is detected, GazeOverlay goes straight into tracking — no manual calibration, because Beam supplies its own calibrated gaze. Screen size and DPI (125 %, 150 %…) are detected automatically.Beamを起動した状態で GazeOverlay-Unified.exe をダブルクリック。初回は展開に最大1分ほど（スプラッシュに進行表示）。Beam検出時はそのままトラッキング開始 — Beamが較正済み視線を供給するため手動較正は不要。画面サイズとDPI（125 %・150 %…）も自動検出されます。
Prefer the built-in webcam tracker instead of Beam? See 9-point calibration.Beamの代わりに内蔵トラッカーを使う場合は 9点較正 を参照。
The Overlay (HUD)オーバーレイ (HUD)
The Overlay
The overlay draws over your game and is click-through — it never blocks your aim. Every card uses the same angled style: a label, a big number, and a colour you can read at a glance. Toggle it with F8; rearrange it in Edit HUD Layout.オーバーレイはゲーム上に描画され、クリックスルー（照準を妨げません）。各カードは共通の角形デザインで、ラベル・大きな数値・一目で分かる色を表示。F8 で表示切替、HUD配置編集 で並べ替えできます。
Gaze dot
Where you're looking視線の位置
A soft sky-blue dot marks your gaze in real time, with a solid inner ring, a dashed outer ring, and a bright core. A crosshair appears when the dot is small. It's smoothed so it doesn't jitter during fixations.水色のドットが視線をリアルタイム表示。内側は実線リング、外側は破線リング、中心は明るいコア。ドットが小さいときは十字が表示されます。注視中に揺れないよう平滑化されています。
Show / hide:表示切替: F8 · size & smoothing inサイズ・平滑化は Settings設定
Status card
Top-left · current state左上 · 現在の状態
A one-line status with a pulsing dot: Tracking (green, pulsing) when all is well, or an amber / rose message when it needs you — “Calibrate first”, “No face detected”, or a Beam notice. Read this first if something looks off.脈動ドット付きの1行ステータス：正常時は Tracking（緑・点滅）、要対応時はオレンジ/赤で「較正が必要」「顔未検出」やBeam通知を表示。異常時はまずここを確認。
APM card
Top-center · actions / minute上部中央 · 毎分アクション
Your keyboard + mouse activity as actions per minute: a big current number, a running average, and a sparkline of the last stretch. The accent brightens as you speed up.キーボード+マウスの操作量を毎分アクション数で表示：大きな現在値、平均、直近の推移スパークライン。速くなるほどアクセント色が明るくなります。
Focus
How alert & locked-in you are集中度
A 0–100 score from the fatigue model (blinks, eye-closure/PERCLOS, yawns, head pose). Higher is better — high focus = alert and dialled in; a falling score is an early tiredness signal. The mini gauge tracks it live.疲労モデル（まばたき・閉眼/PERCLOS・あくび・頭の姿勢）による 0–100 スコア。高いほど良好で、集中＝覚醒・入り込んでいる状態。低下は疲労の早期サイン。ミニゲージがライブ追従します。
Reflex
Reaction time on enemies敵への反応速度
A 0–100 score built from your real engagements: the app detects an enemy, sees your gaze reach it, and times your shot. Pre-fires under ~110 ms are excluded so the score reflects genuine reactions. Shows WAITING until 3 hits are recorded.実際の交戦から作る 0–100 スコア：敵を検出し、視線が到達し、射撃までを計測。約110ms未満のプリファイアは除外し、本当の反応のみ反映。3ヒット記録まで WAITING 表示。
Needs必要: yolov8n.onnx
Colour bands are shared between Focus and Reflex:カラーバンドはFocusとReflexで共通：
Recording
Top-right · session state右上 · 記録状態
Press F9 to start — the card flips to a pulsing REC. Play as normal; press F9 again to stop and write the session files. Everything else keeps running whether or not you record.F9 で開始 — カードが点滅する REC に。通常通りプレイし、再度 F9 で停止してセッションファイルを書き出します。記録の有無に関わらず他機能は動作します。
Saved to保存先: sessions\ → see Session dataセッションデータ参照
AOI zones
Screen regions you care about注目したい画面領域
Draw rectangles or ellipses over parts of the screen — minimap, crosshair, ability bar. While the overlay runs, every gaze sample inside a zone adds to that zone's time and count (a zone lights up when your gaze is inside). During a recording, each zone becomes a 1/0 column in the CSV.画面の一部（ミニマップ・クロスヘア・アビリティバーなど）に矩形や楕円を描画。オーバーレイ動作中、ゾーン内の視線サンプルがそのゾーンの時間・回数に加算されます（視線が入ると点灯）。記録中は各ゾーンがCSVの1/0列になります。
Create in作成: Control Panel → Shapesコントロールパネル → シェイプ · hide with非表示: F7
Edit HUD layout
Rearrange the overlayオーバーレイの並べ替え
HUD cards are fixed and click-through during play. Open Edit HUD Layout from the Tracking card — every card gets a dashed outline and becomes draggable. Drop each where you want it, then turn edit mode off. Your arrangement is saved and restored next launch; ↺ Reset HUD layout restores the defaults.HUDカードは固定・クリックスルーです。TRACKINGカードからEdit HUD Layout を開くと、各カードが破線枠になりドラッグ可能に。配置後に編集モードをオフ。配置は次回起動時に復元、↺ Reset HUD layout で初期化できます。
Control Panelコントロールパネル
Control Panel
Press F12 to open the Control Panel — a separate window with every control, live numbers, and tuning. It's organised into cards you can drag to rearrange (and pop out into their own floating windows). The sections below map to those cards.F12 でコントロールパネルを開きます — すべての操作・ライブ数値・調整を備えた別ウィンドウです。ドラッグで並べ替え可能なカード（個別のフローティング窓に切り離しも可）で構成。以下の項目が各カードに対応します。
Each card has a drag handle (⠇), an accent dot, a title, and an ID tag. Drag a header to reorder or pop it out.各カードにはドラッグハンドル（⠇）・アクセントドット・タイトル・IDタグがあります。ヘッダーをドラッグして並べ替え・切り離しができます。
Tracking controls
Card: TRACKINGカード: TRACKING
Buttons that mirror the main hotkeys, so you can drive the app without memorising keys.主要ホットキーに対応するボタン群。キーを覚えなくても操作できます。
Live stats
Card: LIVE TELEMETRYカード: LIVE TELEMETRY
A running read-out of the tracker's health while you play — three big APM tiles plus live signals.プレイ中のトラッカーの状態を表示 — 3つのAPMタイルとライブ信号。
Fatigue stats
Reflex stats
Detector tuning
Card: DETECTORカード: DETECTOR
Reflex needs to see enemies on screen. A YOLOv8 model watches the screen at ~8 FPS. Raise confidence if it flags non-enemies; lower it if it misses them. Defaults are tuned for Valorant.Reflexは画面上の敵を認識します。YOLOv8が約8FPSで監視。誤検出が多ければ信頼度を上げ、見逃しが多ければ下げます。初期値はValorant向け。
Enemy color filter
Card: TEAM FILTERカード: TEAM FILTER
Valorant outlines enemies in a team colour (red by default). This card tunes the colour range that confirms a detection is really an enemy, cutting false positives from allies or the environment. Using a non-default enemy colour? Adjust it here.Valorantは敵をチームカラー（既定は赤）で縁取ります。このカードで敵と確定する色範囲を調整し、味方や背景の誤検出を削減。既定外の敵色を使う場合はここで調整。
Shapes & profiles
Card: SHAPESカード: SHAPES
Build your AOI zones: click + Rectangle or + Ellipse, then drag on the dimmed screen to place one (Esc cancels). Rename a shape — the name becomes its CSV column. Profiles save a whole set of zones per game: type a name, Save, switch with Load. The active profile is remembered between runs.AOIゾーン を作成：+ Rectangle/+ Ellipse をクリックし画面上でドラッグ配置（Esc 取消）。シェイプ名はCSV列名に。プロファイルはゲームごとにゾーンを保存：名前入力→Save、Load で切替。次回に引き継がれます。
Settings sliders
Card: SETTINGSカード: SETTINGS
Live sliders — changes apply instantly.ライブスライダー — 変更は即時反映。
Killfeed
K / D from the game's own feedゲームのフィードからK/D
GazeOverlay reads Valorant's own killfeed (top-right of the game). Your name on the left of a line = you got the kill; on the right = you died. It tallies K / D automatically. In Deathmatch mode no name is needed; in 5v5 mode enter your handle so it only counts your rows.GazeOverlayはValorant自身のキルフィード（画面右上）を読み取ります。1行の左に自分の名前＝キル、右＝デス。K/Dを自動集計。デスマッチモードでは名前不要、5v5モードでは自分の名前を入力して自分の行のみ集計します。
Analytics & graphs
Card: ANALYTICSカード: ANALYTICS
After you record, this card turns a session's CSV into graphs — focus over time, reaction-time trend, blink rate and more — saved as images next to the session. Select one or more sessions and generate. Great for comparing before / after a break, or across a night of play.記録後、セッションのCSVをグラフ（時間ごとの集中度・反応推移・まばたき率など）に変換し、画像として保存。1つ以上を選んで生成。休憩前後や一晩のプレイ比較に便利です。
Calibration & Tests較正とテスト
9-point calibration
Only if you skip BeamBeamを使わない場合のみ
To use the built-in webcam tracker, run the 9-point calibration. In the calibration window, look at the screen centre and press C to lock your eye spheres. Then follow the green dot through nine points (~15 s), keeping your head still. These nine anchors protect the model from bad clicks later. If you've calibrated before, Use saved calibration skips the sequence.内蔵トラッカーを使うには9点較正を実行。較正ウィンドウで画面中央を見て C で眼球位置をロック。頭を動かさず緑ドットを9点順に追います（約15秒）。この9つのアンカーが後の誤クリックからモデルを守ります。較正済みなら Use saved calibration でスキップ可能。
Recalibrate any time:再較正: F11
Continuous calibration & click-to-correct
On the built-in tracker, GazeOverlay keeps improving as you play: every real mouse click is treated as a quiet "I was looking here" signal. Watch for a faint +1 at accepted clicks (a faint × means rejected). Toggle it with F3. Right after calibrating, press F2 for a 10-second burst where each click corrects strongly — the fastest way to sharpen accuracy.内蔵トラッカーでは、プレイ中も精度が向上し続けます：実際のクリックが「ここを見ていた」信号として使われます。採用時は薄い +1（却下は薄い ×）が表示。F3 でオン/オフ。較正直後に F2 を押すと10秒間のバーストで各クリックが強く補正 — 最速で精度を高められます。
Placing an AOI shape auto-pauses continuous calibration, so your draw-clicks don't pollute the model.AOIシェイプ配置中は連続較正が自動停止し、描画クリックがモデルに影響しません。
PVT reaction test
Press F6 for a Psychomotor Vigilance Task (75 s): stare at the fixation cross and press Space (or click) the instant a red dot appears. It measures objective reaction time — median RT, lapses over 500 ms, and misses. Best used as a pair: run it before a session and again after to see how much your reaction time degraded. Results save to sessions\pvt_<ts>.csv and a running pvt_log.csv. Esc cancels.F6 で精神運動覚醒課題（PVT）（75秒）：固視点を見つめ、赤ドット出現の瞬間に Space（またはクリック）。客観的な反応時間 — 中央値・500ms超のラプス・見逃しを計測。ペア推奨：セッション前後で実施し反応低下を確認。結果は sessions\pvt_<ts>.csv と累積 pvt_log.csv に保存。Esc で中止。
Referenceリファレンス
Hotkeys
Global — they work even while the game is focused.グローバル — ゲームにフォーカス中でも動作します。
| Keyキー | Action動作 |
|---|---|
| F2 | Burst calibrate — 10 s where each click strongly corrects gaze.バースト較正 — 10秒間、各クリックが視線を強く補正。 |
| F3 | Continuous calibration on / off.連続較正 オン/オフ。 |
| F6 | PVT reaction-time test (75 s).PVT 反応速度テスト（75秒）。 |
| F7 | Hide / show AOI shapes only.AOIシェイプのみ表示/非表示。 |
| F8 | Toggle the overlay (gaze dot).オーバーレイ（視線ドット）切替。 |
| F9 | Start / stop recording.記録の開始/停止。 |
| F10 | Quit the app.アプリを終了。 |
| F11 | Recalibrate from scratch.最初から再較正。 |
| F12 | Show / hide the Control Panel.コントロールパネルの表示/非表示。 |
Referenceリファレンス
Session data
Each recording saves into sessions\ next to the .exe, named by timestamp. One session produces four files.各記録は .exe と同じ場所の sessions\ にタイムスタンプ名で保存。1セッションで4ファイルが生成されます。
Session CSV — per frame
| Column列 | Meaning意味 |
|---|---|
| timestamp | Unix time (seconds) of the frame.フレームのUnix時刻（秒）。 |
| screen_x, screen_y | Where you were looking, in screen pixels.視線位置（画面ピクセル）。 |
| yaw_deg, pitch_deg | Gaze direction — horizontal & vertical angle (degrees).視線方向 — 水平・垂直角度（度）。 |
| ear_left, ear_right | Eye-aspect-ratio per eye; low = closed.左右の目の開き具合（EAR）。低い＝閉眼。 |
| event | blink_start / fixation_start / saccade … or blank.blink_start / fixation_start / saccade … または空欄。 |
| apm | Actions-per-minute at that moment.その時点のAPM。 |
| <shape> | One 1 / 0 column per AOI zone — was your gaze inside it.AOIゾーンごとの1/0列 — 視線がゾーン内か。 |
Engagements CSV — reaction time
| Column列 | Meaning意味 |
|---|---|
| t_appeared | When the enemy was first detected.敵が初検出された時刻。 |
| t_first_gaze | When your gaze reached the enemy.視線が敵に到達した時刻。 |
| t_click | When you fired.射撃した時刻。 |
| outcome | HIT, NO_GAZE, or NO_CLICK.HIT、NO_GAZE、NO_CLICK。 |
| detection_to_gaze_ms | Visual search — appear → gaze.視覚探索 — 出現→注視。 |
| gaze_to_click_ms | Trigger time — gaze → fire.トリガー — 注視→射撃。 |
| total_rt_ms | End-to-end reaction time.総反応時間。 |
| shots_fired | Shots during that engagement.その交戦中の射撃数。 |
Reaction times under ~110 ms are pre-fires (anticipation, not reaction) and are excluded from the Reflex score — so it reflects real reactions, not lucky sprays.約110ms未満はプリファイア（予測撃ち）としてReflexスコアから除外 — 運任せでなく本当の反応を反映します。
Summary CSV
| Metric指標 | Meaning意味 |
|---|---|
| fatigue_score / label | Focus 0–100 and its band at session end.Focus 0–100 と終了時バンド。 |
| apm_average / peak | Mean & peak actions-per-minute.APMの平均・最大。 |
| fixation_count / avg_fixation_ms | Number & average length of fixations.注視の回数と平均時間。 |
| blink_rate_per_min | Blinks per minute.毎分まばたき数。 |
| perclos_pct_peak | Peak % eyes closed — drowsiness signal.閉眼割合のピーク — 眠気指標。 |
| killfeed_kills / deaths / kd_ratio | Your K / D tally and ratio.K/D集計と比率。 |
Killfeed CSV
| Column列 | Meaning意味 |
|---|---|
| t_wall | Unix time of the kill or death.キル/デスのUnix時刻。 |
| outcome | kill or death.kill または death。 |
Referenceリファレンス
Troubleshooting
Beam won't connectBeamが接続しない
GazeOverlay shows an amber banner with the reason. Check, in order: (1) Beam is running and tracking is ON; (2) Camera Access = Shared; (3) your Beam app is up to date — website builds need version ≥ 2.6.3, the Steam build also works, and GazeOverlay loads the matching driver automatically; (4) press Retry Beam.GazeOverlayが理由付きの オレンジ色バナー を表示します。順に確認：(1) Beamが起動しトラッキングON、(2) Camera Access = Shared、(3) Beamが最新か — 公式サイト版は2.6.3以上が必要、Steam版も動作、GazeOverlayは対応ドライバーを自動読込、(4) Retry Beam を押す。
Gaze dot stuck in a corner視線ドットが隅で固まる
A stale or skipped calibration can pin the dot to a screen edge. Press F11 to recalibrate — the app also warns you when it detects this.古い/スキップした較正でドットが端に固定されることがあります。F11 で再較正 — 検出時はアプリも警告します。
A recording had no data記録にデータがない
You can only record once gaze is live — Beam connected, or the 9-point calibration done. If the session CSV is empty, the tracker wasn't providing gaze; fix Beam or calibrate (F11) before F9.視線が有効なときのみ記録できます — Beam接続済み、または9点較正完了。CSVが空ならトラッカーが視線を出力していません。Beam修正または較正（F11）後に F9。
Reflex says “WAITING”Reflexが「WAITING」のまま
Reflex needs 3 completed hit engagements before it scores, and yolov8n.onnx must sit next to the .exe. Play a few duels and it fills in.Reflexは採点前に3回のヒット交戦が必要で、yolov8n.onnx が .exe と同じ場所にある必要があります。数回撃ち合えば表示されます。
Referenceリファレンス
Fair use
Play fair. GazeOverlay reads your own webcam and screen for personal analytics — it never reads game memory or automates input. Use it to review yourself, not to gain an in-game advantage.フェアに使いましょう。 GazeOverlayは個人分析のために自分のウェブカメラと画面を読むだけで、ゲームメモリの読取や入力自動化は一切行いません。ゲーム内の優位でなく、自己分析のために使用してください。