rec-frame-app Camera viewfinder overlay compositor

任意の画像にカメラのファインダー風オーバーレイ（四隅枠＋電池＋赤丸REC＋中央十字＋日時＋劣化エフェクト）を合成するGUIアプリ。透過PNGの拡大縮小ではなく画像サイズからの相対値でベクター生成するため、どんな解像度でも比率が崩れません。Bake a camera viewfinder overlay — corner brackets, battery, red REC dot, crosshair, timestamp, degradation effects — into any image. Vector-generated at relative scale, so any resolution keeps proportions.

Releasesでexeを入手Get rec-frame-app.exe GitHubSource & docs ユースケース集Use cases

作例 / Examples

加工前後の比較ではなく、設定の違いの紹介です。Same overlay engine, different settings — not before/after.

犬の写真に黒・中・OFF（簡易）のオーバーレイ — 黒・中・OFF（簡易）Black / medium / clean

犬の写真に白・大・OLED＋十字＋日時（詳細）のオーバーレイ — 白・大・OLED＋十字＋日時（詳細）White / large / OLED + crosshair + timestamp

アニメ絵に黒・中・OFF（簡易）のオーバーレイ — 黒・中・OFF（簡易）Black / medium / clean

アニメ絵に白・中・2000s＋十字＋日時（詳細）のオーバーレイ — 白・中・2000s＋十字＋日時（詳細）White / medium / 2000s + crosshair + timestamp

機能 / Features

四隅枠・電池・REC・中央十字・日時（YYYY/MM/DD AM/PM HH:MM）の個別ON/OFFPer-element toggles
枠色・枠太さ（小/中/大）・フォント・エフェクト（OFF / OLED / 2000s）Color, bracket weight, fonts, effects
撮影日時モード（EXIF優先→更新時刻→固定文）Photo timestamp: EXIF, else mtime, else fixed text
フォルダ一括処理（GUI＋CLI --batch）Batch a folder from GUI or CLI
日英即時切替・設定の自動記憶Instant JA/EN switch, settings auto-saved

エフェクト / Effects

エフェクトはオーバーレイ層にだけかかり、元の写真は一切変えません。CRT/VHSのような画面全体への破壊処理はコンセプトに合わないため不採用です。Effects touch only the overlay layer — your photo stays intact. No destructive CRT/VHS filters by design.

OLED（微発光）Weak bloom only — subtle glow like an OLED display

枠や文字の背後にぼかし複製を敷く微発光。光の強さは枠色で調整されます（白がやや強め）。狙いは現代の監視カメラ・配信画面の質感。実況スクショ・フォトブース・旅行ログにおすすめ。作例は上の犬の写真2枚目です。Best for: game clips, photo booths, travel logs. See the 2nd dog example above.

2000sデジカメWeak RGB shift + low-res — Y2K digicam grit

色ずれ（弱）と低解像度化（0.5倍→等倍復元）のジャギで、平成デジカメ・防犯カメラ映像の粗さを再現。狙いは「撮られている感」の増幅。サムネ・心霊ネタ・TRPG証拠品・エモ投稿におすすめ。作例は上のアニメ絵2枚目です。Best for: thumbnails, spooky posts, TRPG handouts, Y2K edits. See the 2nd anime example above.

アプリ画面 / App UI

アプリ画面:簡易モード — 簡易モードSimple mode (click for full size)

アプリ画面:詳細・表示日時タブ — 詳細モードDetail mode (click for full size)

使い方 / Usage

.venv\Scripts\python rec_frame_app.py
rem CLI batch (--config omitted = remembered settings)
.venv\Scripts\python rec_frame_app.py --batch 入力フォルダ 出力フォルダ --config rec_frame_config.json
rem English CLI
.venv\Scripts\python rec_frame_app.py --lang en --batch input output

入力: PNG / JPG / JPEG / WebP / BMP（EXIF Orientation正規化）・出力: PNG / JPEG（quality=95）/ WebP。保存名は {元名}_rec{拡張子}。Input PNG/JPG/JPEG/WebP/BMP, output PNG/JPEG q95/WebP, saved as {name}_rec{ext}.

配布 / Download

一般ユーザーはGitHub Releasesの rec-frame-app.exe をDLしてダブルクリック（Python不要、約17MB）。初回は署名なしのためSmartScreenが出ます（詳細情報→実行）。Windows users: download rec-frame-app.exe from Releases, double-click (no Python needed). Unsigned, so SmartScreen appears on first run.