calsci_latest_itr_simulator

Thin desktop simulator for CalSci.

Calculate	Graph	Battery Status
Dino	ChatGPT

Run

Linux / macOS

cd calsci_simulator
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python main.py

Windows PowerShell

cd calsci_simulator
py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
python main.py

Windows Command Prompt

cd calsci_simulator
py -m venv .venv
.venv\Scripts\activate.bat
python -m pip install -r requirements.txt
python main.py

Note: plain git clone --recurse-submodules checks out the simulator's pinned submodule commit. Use the --remote-submodules flow above if you want the newest calsci_latest_itr/main tip on clone.

If PowerShell blocks script activation on Windows, run the Command Prompt variant instead.

Controls

• Click calculator keys in the window.
• Optional keyboard shortcuts:
  • F7 -> reload the simulator
  • Enter -> ok
  • Backspace -> simulator del
  • Delete -> nav_b
  • Arrow keys -> navigation keys
  • Ctrl+Left -> back
  • Ctrl+A -> alpha
  • Ctrl+B -> back
  • Ctrl+H -> home
  • Ctrl+L -> lock
  • 0-9, .,()+-/* -> matching calculator keys
  • F1, F2, F3, F4, F5, F6 -> matching calculator keys
  • S -> save a screenshot using the currently selected screenshot mode
  • V -> start/stop video recording using the currently selected video mode
  • Esc -> home
  • Ctrl+Q -> quit

Notes

• Use the top-left burger menu in the simulator window to switch capture settings.
• Screenshot mode supports:
  • SVG Pixels -> pure vector export of the monochrome display contents
  • Display Background -> display-only image with the simulator's display background
  • Simulator Screenshot -> full simulator export
• Video mode supports:
  • Simulator Video -> full simulator export with a pure white outer background
  • Display Background -> display-only video with the simulator's display background
  • Transparent APNG -> animated PNG with transparent outer background for website use
  • Transparent WebM -> web video with transparent outer background for website use
  • Transparent GIF -> animated GIF export with transparent outer background GIF exports are auto-compressed locally after recording stops.
• The video menu includes a Video Limit (seconds) field.
  • Leave it blank to keep recording until you press V again or click stop.
  • Enter a number to auto-stop after that many seconds; manual V stop still works.
• Paths like /db/... or /apps/... are remapped to ./calsci_latest_itr/db/... and ./calsci_latest_itr/apps/... by default.
• Some hardware/network-specific apps run in simulated/no-op mode where needed.
• Screenshots are saved in ../simulator_screen_shots, and display recordings are saved in ../simulator_videos.
• Display recording shells out to ffmpeg, so it needs to be available on PATH.