おかえりカウンター - 初見・おかえりリスナー自動検知カウンター【OBS対応/6種テーマ/わんコメプラグイン】V1.2.0

◼︎ 商品説明

ライブ配信者・VTuber必見！

初見さん・おかえりさん・常連さんを自動で分類し、カウントしてくれるわんコメ専用プラグインです。

「この人、初めて来てくれた！」「久しぶりに来てくれた！」そんな大切な瞬間を見逃さず、

OBSの画面にリアルタイムで表示・通知します。

コメント欄を追いながら配信していても、誰が初見か一目でわかるので、

より丁寧なリスナー対応が可能になります。

わんコメのリスナーDBと連携することで、初めてのコメントか・どのくらいぶりの来訪かを自動判定。

6種のデザインテーマと豊富なカスタマイズで、どんな配信スタイルにも馴染みます。

◼︎ 主な機能

【3カテゴリ自動分類】

- 初見さん - わんコメへの初コメントを自動検知

- おかえりさん - 設定した期間以上ぶりの来訪を自動検知（デフォルト30日）

- 常連さん - 上記以外のリスナー

【6種デザインテーマ】

- Default - グラスモーフィズム（暗め）万能タイプ

- Dark - ディープダーク（ゲーム・FPS配信向け）

- Light - ホワイトグラス（VRChat・雑談配信向け）

- Neon - ネオングロー（夜間・eスポーツ配信向け）

- Pastel - パステルかわいい（Vtuber・イラスト配信向け）

- Retro - レトロゲーム 8bit（レトロゲーム配信向け）

【5種表示モード】

- Full - カウンター＋トースト通知（フル表示）

- Counter - カウンターのみ（初見・おかえり）

- Firsttime - 初見カウンターのみ

- Summary - 全カテゴリサマリーのみ

- Toast - トースト通知のみ

【トースト通知】

- 初見さん・おかえりさんの来訪をポップアップ通知

- 表示位置を5カ所から選択（右下・左下・右上・左上・中央）

- 表示時間をCSSで自由に設定

【7種アイコンアニメーション（カウント増加時）】

- ぴょこぴょこ（上に跳ねてバウンス）

- ふるふる（左右に揺れる）

- くるっと（360度回転）

- タダーン（拡大＋傾き）

- ドキドキ（脈打つように拡縮）

- ポンッ（縮んでから弾ける）

- なし

【フォントカスタマイズ】

- 数字フォント - 13種のGoogle Fontsプリセット＋カスタム入力

- 数字サイズ - 16〜72pxで自由設定

- ラベルサイズ - 6〜20pxで数字と独立して設定

- テーマ別おすすめフォントをプリセットに収録

【ラベル・テキストカスタマイズ】

- 「初見さん」「おかえり」「常連さん」の文言を自由に変更

- URLパラメータで設定するので複数プリセットの使い分けも可能

【持ち込み画像対応】

- アイコン画像（初見・おかえり・常連、各64×64px推奨）

- ウィジェット背景画像（PNG/JPG/GIF/WebP対応）

- プラグインフォルダに画像を置くだけで自動適用

【URLパラメータによるカスタマイズ】

- OBSブラウザソースのURLに#でパラメータを追加するだけ

- テーマ・レイアウト・フォント・アニメーション等をURL一本で管理

- 設定画面の「OBS用URLを生成」から簡単コピー

【OBSカスタムCSS対応】

- CSS変数を上書きするだけでテーマカラーを自由変更

- アニメーション速度・トースト表示時間なども変更可能

◼︎ こんな方におすすめ

- 初見さんへの挨拶を大切にしている配信者

- 久しぶりのリスナーに気づいて声をかけたい方

- コメント欄が速くて追いきれない方

- OBSの画面でリスナー状況を一目で確認したい方

- 配信の世界観に合ったウィジェットデザインにこだわりたい方

- VTuber、ゲーム実況、雑談など様々なジャンルの配信者

- わんコメをすでに使っていてさらに活用したい方

◼︎ 同梱内容

- okaeri-counter/（プラグイン本体フォルダ）

- README.md（詳細な使用方法・カスタマイズガイド）

◼︎ 動作環境

- 必須：わんコメ（OneComme）v5.2以上（プラグイン対応版）

- 対応配信ソフト：OBS Studio、Streamlabs Desktop等（ブラウザソースで使用）

- 推奨解像度：幅520px × 高さ110px（horizontalレイアウトの場合）

- フォント読み込み：インターネット接続が必要（Google Fonts使用）

◼︎ かんたん3ステップ導入

1. okaeri-counterフォルダをわんコメのプラグインフォルダにコピー

2. わんコメを再起動してプラグインを有効化

3. OBSのブラウザソースに専用URLを入力して完了！

◼︎ 活用例

- 初見さんが来たとき「画面で気づいてすぐに挨拶」（Fullモード）

- 久しぶりのリスナーに「○○日ぶり！おかえり！」と声かけ（トースト通知）

- 配信終了後に「今日は初見○人来てくれた」と振り返り（Summaryモード）

- 初見さんカウンターだけ大きく表示して配信の演出に使う（Firsttimeモード）

- カウンターは非表示にしてトースト通知だけ使う（Toastモード）

◼︎ デザイン選びのヒント

- VTuber配信 → Pastel（パステルカラー）または Light（白グラス）

- ゲーム配信 → Dark（深いダーク）または Neon（ネオン発光）

- 雑談・チル配信 → Default（グラスモーフィズム）または Light

- レトロゲーム配信 → Retro（ドット文字・8bit）

- eスポーツ・夜間配信 → Neon（ネオングロー）

- 企業・フォーマル → Default または Light

◼︎ 注意事項

- 本プラグインの動作にはわんコメ（OneComme）が必要です

- わんコメの「リスナー記録」機能をONにしてご使用ください（OFF時は全員常連さん扱いになります）

- OBSブラウザソースのセキュリティ制限によりローカル画像（file://）は使用できません。画像はプラグインフォルダ内に配置してください

- セッションカウンターはプラグイン再起動時にリセットされます

- フォント読み込みにインターネット接続が必要です

◼︎ サポート

使用方法や不具合についてのお問い合わせは、メッセージ機能よりご連絡ください。

◼︎ よくある質問

Q: わんコメを持っていなくても使えますか？

A: いいえ、本プラグインはわんコメ専用です。わんコメのインストールとリスナー記録機能のONが必要です。

Q: プログラミング知識は必要ですか？

A: いいえ、フォルダをコピーしてURLを設定するだけで使えます。

詳細なカスタマイズにはURLパラメータやCSSの知識があるとより活用できます。

Q: 背景は透過されますか？

A: はい、OBSのブラウザソースでそのまま透過合成が可能です。

Q: テーマやデザインは後から変更できますか？

A: はい、設定画面の「OBS用URLを生成」で変更後のURLをコピーし、OBSブラウザソースのURLを更新するだけです。

Q: 初見・おかえりの判定基準は変更できますか？

A: はい、設定画面からおかえり判定の時間（1〜8760時間）を変更できます。

Q: カウンターのリセットはできますか？

A: はい、設定画面の「セッションリセット」ボタンから手動でリセットできます。プラグイン再起動時にも自動リセットされます。

Q: アイコンを自分の画像に変えられますか？

A: はい、プラグインフォルダ内のimages/フォルダに指定のファイル名で画像を置くと自動で適用されます。

Q: 複数の表示スタイルを使い分けたいです

A: OBSのブラウザソースを複数追加して、それぞれ異なるURLパラメータを設定することで使い分けが可能です。

◼︎ 更新履歴

【V1.2.0】

- カウント増加時のアイコンアニメーション追加（7種）

- ラベルフォントサイズを数字と独立して設定可能に

- テーマ別Google Fontsプリセット追加（13種）

- 持ち込み画像をファイル設置方式に統一

- ラベル文言（初見さん・おかえり・常連さん）を自由変更可能に

【V1.1.0】

- おかえり判定を日数から時間単位に変更（1〜8760時間）

- 初見判定をwankoメDBベースに修正（精度向上）

- デザインをグラスモーフィズム＋SVGアイコンにリニューアル

- 「初見のみ」表示モード追加

- フォント・背景画像のURLパラメータ対応

【V1.0.0】

- 初回リリース

- 3カテゴリ自動分類（初見・おかえり・常連）

- 6種デザインテーマ

- トースト通知

- URLパラメータによるカスタマイズ

============================================================

ENGLISH SUMMARY

============================================================

◼︎ Product Description

A OneComme (わんコメ) plugin that automatically detects and counts first-time viewers, returning viewers, and regulars — displayed as a real-time OBS overlay.

Never miss welcoming a first-timer or a viewer who hasn't visited in months.

◼︎ 3 Viewer Categories

- First-time (初見) - First comment ever detected automatically

- Welcome back (おかえり) - Returns after set period (default: 30 days)

- Regular (常連) - All others

◼︎ 6 Design Themes

Default (Glassmorphism) / Dark (Deep Dark) / Light (White Glass) / Neon (Glow) / Pastel (Cute) / Retro (8-bit Pixel)

◼︎ Features

- 5 display modes: Full / Counter / First-time only / Summary / Toast only

- Toast pop-up notifications with viewer name and visit count

- 7 icon animation types on count increase

- 13 Google Fonts presets with theme recommendations

- Custom label text, icon images, and background image

- Full URL parameter customization — manage presets with a single URL

- OBS custom CSS support for advanced color/style tweaks

◼︎ Requirements

- OneComme (わんコメ) v5.2 or later (required)

- OBS Studio or compatible streaming software (browser source)

◼︎ Setup

1. Copy okaeri-counter folder to OneComme plugins directory

2. Restart OneComme to activate the plugin

3. Add the provided URL as a browser source in OBS — Done!