ShaonRec 1.0.0 — 4K/1080p Screen Recorder (internal tool)
==========================================================

QUICK START (Windows 10/11)
---------------------------
1. Right-click "Install & Run ShaonRec.bat" -> Run.
   (First run: installs its own private Python environment. Needs internet once.)
2. If ffmpeg is missing, the installer opens the download page:
   download "ffmpeg-release-essentials.zip", unzip, copy ffmpeg.exe
   (from the "bin" folder inside) next to this README. Run the .bat again.
3. The recorder window opens. Press REC. Files save to Videos\ShaonRec.

If Python is not installed: https://www.python.org/downloads/
(tick "Add python.exe to PATH" in the installer).

FEATURES
--------
- Full monitor, multi-monitor, or exact region (WxH+X+Y) capture
- 4K/1440p/1080p @ 24/30/60 fps, H.264 MP4 (+faststart for instant playback)
- Auto GPU encoder (NVENC) with CPU x264 fallback; CRF quality 14-30
- System audio (what you hear) via Windows loopback - no virtual driver needed
- Microphone mixed in (optional)
- Pause/resume, live frame counter, REC overlay border
- PNG screenshots, GIF export, lossless trim
- Recording_*.json sidecar with full technical metadata

HOTKEYS (while window focused): F9 = start/stop, F10 = pause/resume

TIPS
----
- Best quality: FPS 60, CRF 18, encoder auto (uses your NVIDIA GPU if present)
- HEVC (nvenc hevc) = smaller files, but some apps/older players won't open it
- For YouTube uploads 1080p30 CRF 20 is the sweet spot
- Region format: 1920x1080+0+0  (WxH+Left+Top of your virtual screen)

TROUBLESHOOTING
---------------
- "ffmpeg was not found": copy ffmpeg.exe next to README.txt (step 2 above)
- No system audio: Settings > Sound > make sure the right output device is
  default. Loopback captures the DEFAULT output device.
- Mic too loud/quiet: Windows mic level controls the mix balance.
- Crashes on start: run "shaonrec-cli.bat" and share the error text.

FILES
-----
shaonrec.py                  the app (engine + GUI + CLI + selftest)
Install & Run ShaonRec.bat   one-click launcher
shaonrec-cli.bat             console mode (works if GUI has issues)
requirements.txt             python dependencies
