Useful Commands Reference

Running Screen Sage

cargo run
# or the compiled binary:
./target/release/screen-sage

Open browser: http://localhost:8080

Running ScryingGlass

Launch a display window using a JSON scene config:

./python-env/bin/python3 ScryingGlass_pyglet/display_engine_pyglet.py storage/scrying_glasses/battlemap.json

For multiple screens, launch a separate process per screen with a different config:

./python-env/bin/python3 ScryingGlass_pyglet/display_engine_pyglet.py storage/scrying_glasses/display.json

Controls while running:

Key	Action
Mouse wheel	Zoom in/out
Right-click drag	Pan
+ / -	Zoom at centre
H or Home	Reset zoom/pan
C	Clear all fog
R	Reload config manually
F	Toggle fullscreen

Python Environment

# Install a Python dependency
./python-env/bin/pip install <package>

# Run any script using the project environment
./python-env/bin/python3 <script.py>

WiFi

# If WiFi is blocked
sudo rfkill unblock wifi

Related Documentation

• Installation Guide
• ScryingGlass Display Engine