dandri/pyxis
1
0
Fork 0
mirror of https://github.com/torlando-tech/pyxis.git synced 2026-08-14 23:00:08 +00:00
Code Issues Actions 7 Packages Projects Releases Wiki Activity

docs: add guided offline map install steps

Browse Source
This commit is contained in:
torlando-agent[bot]
2026-08-07 21:27:15 +00:00
parent 210c7b443c
commit 62509e0be8
3 changed files with 34 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/flasher/index.html
+15 -4
View File
@@ -247,6 +247,9 @@
.map-status.success { color: var(--success); }
.map-status.error { color: var(--error); }
.map-note { color: var(--muted); font-size: 0.875rem; line-height: 1.5; }
.map-install-steps { margin: 0.8rem 0 1rem; padding-left: 1.5rem; color: var(--muted); }
.map-install-steps li { margin: 0.5rem 0; line-height: 1.5; }
.map-install-steps a { color: var(--primary); }
footer {
text-align: center;
@@ -312,10 +315,18 @@
<div class="card map-section">
<h2>Install Offline Maps</h2>
<p class="map-note">
Select a Coalition/MUI XYZ ZIP already downloaded to this computer, then choose the mounted SD-card root.
Turn the T-Deck off and remove its SD card before installation. Existing unrelated SD-card files are preserved.
</p>
<ol class="map-install-steps">
<li>
Download a compatible MUI map ZIP from
<a href="https://download.tiles.coalition.space/" target="_blank" rel="noopener noreferrer">Oxed's Map Tile Downloader</a>.
Choose OSM Bright for current Pyxis compatibility.
</li>
<li>Turn the T-Deck off, remove its microSD card, and insert the card into your computer.</li>
<li>Choose the downloaded ZIP below, enter a map name and pack ID, and wait for local validation.</li>
<li>Click <strong>Install and Enable</strong>, then choose the mounted SD-card root.</li>
<li>Safely eject the SD card, return it to the T-Deck, power it on, and open Maps.</li>
</ol>
<p class="map-note">Existing unrelated SD-card files are preserved. Map tiles are validated locally and are never uploaded.</p>
<div class="map-installer-grid">
<div class="map-field">
<label for="map-archive">Map tile ZIP</label>
docs/offline-map-packs.md
+1 -1
View File
@@ -6,7 +6,7 @@ Pyxis can read prebuilt raster map packs from an SD card. Importers accept only
Open the Pyxis web flasher in current Chrome or Edge and use **Install Offline Maps**:
1. Download a Coalition/MUI XYZ ZIP separately.
1. Download an OSM Bright MUI ZIP from [Oxed's Map Tile Downloader](https://download.tiles.coalition.space/).
2. Turn the T-Deck off, remove its SD card, and mount the card on the computer.
3. Choose the ZIP, enter a map name and pack ID, and wait for local validation.
4. Click **Install and Enable**, then choose the SD-card root.
tests/build_scripts/test_map_web_installer_contract.py
+18
View File
@@ -27,6 +27,24 @@ def test_map_installer_ui_is_local_file_to_sd_and_offline_only() -> None:
assert "Map data (c) OpenStreetMap contributors" in source
def test_map_installer_explains_the_complete_sd_card_workflow() -> None:
source = FLASHER.read_text(encoding="utf-8")
assert '<ol class="map-install-steps">' in source
assert (
'href="https://download.tiles.coalition.space/" '
'target="_blank" rel="noopener noreferrer"'
) in source
expected_steps = (
"Download a compatible MUI map ZIP",
"Turn the T-Deck off",
"Choose the downloaded ZIP",
"Click <strong>Install and Enable</strong>",
"Safely eject the SD card",
)
positions = [source.index(step) for step in expected_steps]
assert positions == sorted(positions)
def test_map_installer_has_no_tile_network_fetch_path() -> None:
source = INSTALLER.read_text(encoding="utf-8").lower()
for forbidden in ("fetch(", "xmlhttprequest", "websocket", "http://", "https://"):