================================================================================
【ソフト名】  チンチラン (Chinchilla Run)
【バージョン】1.0.0
【制作・著作】dnnl
【対応ＯＳ】  Windows 10 / 11
【種    別】  フリーソフトウェア
================================================================================

■ ソフトの概要
「チンチラン」は、ネットワークカメラ（Tapoシリーズ等）やWebカメラの映像を解析し、
チンチラが回し車（ホイール）で走った「距離」や「回転数」を自動計測するアプリです。

特別なセンサーを買う必要はありません。
滑車に「反射シール」や「目印」を貼るだけで計測ができます。

========================================================================
【最重要】 安全上のご注意（必ずお読みください）
========================================================================
本ソフトを使用するための「マーカー用テープ」は、必ずチンチラが
【絶対に口にできない場所（滑車の外側や裏側など）】に貼ってください。

滑車の内側（走る面）には絶対に貼らないでください。
チンチラは好奇心旺盛です。テープを剥がして誤飲する危険性があります。

また、設置後もテープが剥がれかけていないか定期的に確認を行ってください。
かじり癖のある子の場合は使用を控えるなど、飼い主様の責任において
十分な安全配慮をお願いいたします。
========================================================================


【主な特徴】
1. 昼も夜も計測可能
   昼間は「黒テープ」、夜間（赤外線カメラ）は「反射シール」を使うことで、
   いつでも運動量を記録できます。(設定次第では夜間でも黒テープで記録できます。)

2. 簡単セットアップ
   TapoカメラならIPアドレスとアカウントを入力するだけで接続可能。
   Webカメラや、その他のRTSP対応カメラにも対応しています。

3. 誤検知を防ぐ独自ロジック
   チンチラが滑車の上で休憩したり、少し揺らしたりしただけの動きは無視し、
   「しっかり走った時」だけをカウントする仕組みを搭載しています。

4. データの可視化
   日々の走行データを自動で保存。「履歴」ボタンから過去の運動量を確認できます。

■ 動作環境
OS：Windows 10 / 11 (64bit)
CPU：Intel Core i3 相当以上推奨
メモリ：4GB以上推奨
画面解像度：1280x720以上

【必要なもの】
・RTSP対応ネットワークカメラ（TP-Link Tapoシリーズ等推奨）
  ※またはPCに接続されたWebカメラ
・滑車に貼る反射シール（または黒いテープ）

■ インストール方法
ダウンロードしたZIPファイルを、デスクトップなどの任意のフォルダに解凍してください。
フォルダ内に生成される「チンチラン.exe」を実行するとソフトが起動します。

■ アンインストール方法
解凍したフォルダごと削除してください。
本ソフトはレジストリを使用していないため、フォルダのゴミ箱への移動だけで完了します。

■使い方

【1. 滑車への準備】
　テープを【幅1.5cm、長さ5cm】程度に切ります。
　（短すぎると検知しづらくなるため、長めがおすすめです）

　滑車の「外側（カメラに映る面）」に、180度対角（向かい合わせ）に
　なるように【2枚】貼ってください。

【2. 起動と接続】
　　1. 「チンチラン.exe」を起動し、右上の「⚙ 設定・調整」ボタンを押します。
　　2. 「接続設定」タブでカメラ情報を入力します。
   　　・Tapoカメラの場合: 「カメラのアカウント」のID/PASSを入力します。
     　（※TP-Link IDではなく、カメラ設定内で作成したアカウントです）
   　　・Webカメラの場合: 「0」を入力します。
　　3. 「設定を保存して閉じる」を押し、メイン画面の「測定開始」を押します。

【3. 計測の調整（重要！）】
　正しくカウントするために、以下の調整を行ってください。

　・枠の調整:
 　 画面中央の【青い枠】の中に、回転するテープが通るようにカメラ角度を調整します。

　・モード選択:
  設定画面で、使用する環境に合わせて選択してください。
  　[反射シール(白検知)]: 暗い部屋で赤外線カメラを使う場合
  　[黒テープ(黒検知)]: 明るい部屋で黒いテープを使う場合

　・感度の調整:
  　「テスト表示」をONにし、テープが通ったときだけ【緑色の枠】が表示されるように、
  　「閾値」スライダーを調整します。小さなゴミや光の反射は無視されます。
　
■ うまく動かないとき（Q&A）
　Q. カウントされない
　A. テープが短すぎてカメラが見逃している可能性があります。
  　 テープを長く（5cm以上）してみてください。

　Q. カウントが増えすぎる（1回の通過で2回カウントされる）
　A. 設定の「再検知までの間隔 (ms)」を少し増やしてみてください。
   （推奨設定: 30ms 〜 50ms）

■ ネットワーク通信について
本ソフトは、ユーザーが指定したカメラ映像を取得するために、
ローカルネットワーク内でのみ通信を行います。
映像やデータを外部（作者やサーバー）へ送信することは一切ありません。

■ 作者への連絡先
動作不良の報告やご要望は、下記までご連絡ください。

メールアドレス： 【tenkeyflicktoggle@gmail.com】
Webサイト(note)：【https://note.com/daityan223】

※お問い合わせは原則として上記メールアドレスまでお願いいたします。


簡単な紹介記事はnoteにて公開中です！
https://note.com/daityan223/n/n9e51d55a9009

本ソフトウェアはフリーソフトです。
シェアレジ等でのご支援は大歓迎です🐭<チモシー代になるよ
