Skip to content

feat(setup): expanded cache step + GPU encoding step (#153, #154) #198

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
samsoir merged 2 commits into from
May 11, 2026
Merged

feat(setup): expanded cache step + GPU encoding step (#153, #154) #198

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ce7e248
feat(setup): expanded cache step + GPU encoding step (#153, #154)
samsoir May 11, 2026
42fe386
refactor(system::gpu): SSOT enumeration + selection across consumers
samsoir May 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion docs/configuration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,14 @@ The easiest way to configure XEarthLayer is with the interactive setup wizard:
xearthlayer setup
```

The wizard auto-detects your X-Plane installation, system hardware (CPU, memory, storage type), and recommends optimal settings. It handles all the configuration below automatically.
The wizard auto-detects your X-Plane installation, system hardware (CPU, memory, storage type), free disk space, and GPU adapters, then recommends optimal settings. The wizard runs four steps:

1. **X-Plane Custom Scenery** — auto-detected from your X-Plane install, with fallback to manual entry.
2. **Package Location** — where regional scenery packages live on disk.
3. **Cache Configuration** — cache directory, disk cache size (defaults to 25% of free space, floored to 10 GB), DDS-to-chunk disk ratio, memory cache size (defaults to RAM ÷ 12, clamped to 500 MB – RAM ÷ 4), and disk I/O profile (NVMe / SSD / HDD / auto).
4. **DDS Encoding** — picks ISPC (CPU) by default, or offers to offload encoding to a secondary GPU when **two or more GPU adapters** are detected. The wizard warns against picking the GPU X-Plane renders on. Single-GPU systems skip the choice and stay on ISPC.

GPU enumeration can take 10–30 seconds on multi-adapter systems while drivers are probed; a spinner shows progress.

## Manual Configuration

Expand Down
Loading