- Logging: Set
RUST_LOG=orbitron=debug (or use the CLI --log-level debug) to enable verbose tracing. The viewer records structured events for background jobs, remote fetches, and selection evaluation.
- GPU issues: Launch with
WGPU_BACKEND=gl cargo run -p orbitron-cli --features gui -- view ... to force the OpenGL backend when Metal/Vulkan is unavailable.
- Remote (SSH/SFTP) diagnostics: First confirm
ssh <host> and sftp <host> work from a terminal — the same ~/.ssh/config, agent, and 2FA apply. Then reproduce headlessly with orbitron --remote [user@]host:/root fs list. The viewer’s remote browser overlay surfaces ssh/sftp errors in the status bar.
- Loader problems: Use the CLI
inspect and convert subcommands to reproduce parsing issues outside the GUI. The regression crate’s load_and_digest helper is useful for verifying canonical results on fixtures.
- Edit mode glitches:
viewer_state::attempt_exit_edit_mode and edit_exit_dialog::handle_exit_edit_dialog control edit-mode transitions. Enable tracing around these modules to observe undo/redo stack operations.
- Background tasks: Progress overlays pull from
ProgressMsg channels. Ensure new background jobs send ProgressMsg::Finished or the spinner will persist.