config/config.example.yaml

storage: local   # 'local' or 's3'

# Required: set these to your actual paths (local path or bucket/prefix for S3)
data_dir:   # e.g. data/clips  or for S3: hydroscan-data/GRAMMONT/
out_dir:    # e.g. data/out    or for S3: hydroscan-data/annotations/<name>/  # Put your name here
# For S3 credentials, copy .env.example to .env and fill in:
# S3_ACCESS_KEY, S3_SECRET_ACCESS_KEY, S3_ENDPOINT_URL

clips_file: config/clips.txt
optical_flow_config_file: config/optical_flow_config.yaml
questions_config_file: config/questions.yaml

display_max: 720
fps_fallback: 25
max_frames: 100

# Input filenames (override if your ZIP archives differ)
filenames:
  video_in_zip: left.mp4
  video_tmp_suffix: .mp4
  zip_extension: .zip
Move questions and optical flow to separate config files; clean up config.example.yaml - questions: extracted from config.yaml into config/questions.yaml (committed, like optical_flow_config.yaml) - optical_flow_config_file and questions_config_file are now required fields - data_dir and out_dir are now required (no defaults) - filenames: trimmed to input-only in example; output filenames stay as code defaults - annotator: remove optional guard around optical flow config loading Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-05-20 16:30:59 +02:00			`storage: local # 'local' or 's3'`

			`# Required: set these to your actual paths (local path or bucket/prefix for S3)`
fix: corrected paths in config example 2026-06-03 11:50:14 +02:00			`data_dir: # e.g. data/clips or for S3: hydroscan-data/GRAMMONT/`
			`out_dir: # e.g. data/out or for S3: hydroscan-data/annotations/<name>/ # Put your name here`
Move questions and optical flow to separate config files; clean up config.example.yaml - questions: extracted from config.yaml into config/questions.yaml (committed, like optical_flow_config.yaml) - optical_flow_config_file and questions_config_file are now required fields - data_dir and out_dir are now required (no defaults) - filenames: trimmed to input-only in example; output filenames stay as code defaults - annotator: remove optional guard around optical flow config loading Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-05-20 16:30:59 +02:00			`# For S3 credentials, copy .env.example to .env and fill in:`
Add S3 storage support via s3fs; make storage field required - New filesystem.py: make_fs() factory (returns s3fs.S3FileSystem or None), plus fsjoin/fsstem/fsname path helpers - config.py: storage field is now required ('local' or 's3'); load_config raises a clear ValueError when it is missing - video_loader, clip_selector, annotator: thread fs through all file I/O; local paths unchanged, S3 paths use fs.open/fs.exists/fs.pipe - annotation_script: load .env via python-dotenv at startup, create fs from config and pass to Annotator - Add .env.example with SwitchEngines endpoint and AWS checksum env vars - pyproject.toml: add s3fs and python-dotenv dependencies - Reduce default mask alpha from 40% to 15% - Update example clip names to colon-separated timestamps Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-05-20 16:15:38 +02:00			`# S3_ACCESS_KEY, S3_SECRET_ACCESS_KEY, S3_ENDPOINT_URL`
Move questions and optical flow to separate config files; clean up config.example.yaml - questions: extracted from config.yaml into config/questions.yaml (committed, like optical_flow_config.yaml) - optical_flow_config_file and questions_config_file are now required fields - data_dir and out_dir are now required (no defaults) - filenames: trimmed to input-only in example; output filenames stay as code defaults - annotator: remove optional guard around optical flow config loading Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-05-20 16:30:59 +02:00
Replace hardcoded config and directory scan with YAML config and explicit clip list - config.py constants -> config/config.yaml (user-editable, git-ignored) - Questions and defaults now defined in the YAML, including per-question defaults - ClipSelector no longer scans the data dir; reads a user-provided clips.txt instead - Removed --daily / --time / --skip-existing-day args - video_loader now samples frames evenly across the full clip - pyyaml added as a dependency Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-05-20 13:42:48 +02:00			`clips_file: config/clips.txt`
Improve README clarity and add defaults to controls - Expand Controls intro with two-panel layout description - Add brush size range/default and mask alpha range/default to tables - Split 'Starting-point shortcuts' (Load Prev Mask, Auto Segment) from mask editing table - Trim 'How it works' mask drawing section to remove implementation internals - Enable optical_flow_config_file in config.example.yaml Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-05-20 15:18:10 +02:00			`optical_flow_config_file: config/optical_flow_config.yaml`
Move questions and optical flow to separate config files; clean up config.example.yaml - questions: extracted from config.yaml into config/questions.yaml (committed, like optical_flow_config.yaml) - optical_flow_config_file and questions_config_file are now required fields - data_dir and out_dir are now required (no defaults) - filenames: trimmed to input-only in example; output filenames stay as code defaults - annotator: remove optional guard around optical flow config loading Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-05-20 16:30:59 +02:00			`questions_config_file: config/questions.yaml`
Replace hardcoded config and directory scan with YAML config and explicit clip list - config.py constants -> config/config.yaml (user-editable, git-ignored) - Questions and defaults now defined in the YAML, including per-question defaults - ClipSelector no longer scans the data dir; reads a user-provided clips.txt instead - Removed --daily / --time / --skip-existing-day args - video_loader now samples frames evenly across the full clip - pyyaml added as a dependency Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-05-20 13:42:48 +02:00
Minor config changes 2026-05-20 15:22:25 +02:00			`display_max: 720`
			`fps_fallback: 25`
			`max_frames: 100`

Move questions and optical flow to separate config files; clean up config.example.yaml - questions: extracted from config.yaml into config/questions.yaml (committed, like optical_flow_config.yaml) - optical_flow_config_file and questions_config_file are now required fields - data_dir and out_dir are now required (no defaults) - filenames: trimmed to input-only in example; output filenames stay as code defaults - annotator: remove optional guard around optical flow config loading Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-05-20 16:30:59 +02:00			`# Input filenames (override if your ZIP archives differ)`
Minor config changes 2026-05-20 15:22:25 +02:00			`filenames:`
			`video_in_zip: left.mp4`
			`video_tmp_suffix: .mp4`
			`zip_extension: .zip`