# QGIS Project Snapshot 1.0.2

## English

Take your QGIS project offline, with vector data, lossless maps, styles
and a report. Download **WMS/WMTS maps and XYZ tiles**, such as OpenStreetMap
basemaps, for offline use. Choose the map view or a polygon layer as your area.
Keep the whole folder to move it or resume interrupted downloads.

**Getting started:** use QGIS 3.40–3.x (Qt5) or QGIS 4.x (Qt6), with
Python ≥3.10 and GDAL ≥3.7 supplied by QGIS. XML protection uses bundled defusedxml (PSF license); no extra packages needed.
You'll need source access and disk space.
In **Plugins → Manage and Install Plugins → Install from ZIP**, select
`qgis-project-snapshot-1.0.2.zip` and restart QGIS. Then choose
**Plugins → QGIS Project Snapshot**.

**Plan ahead:** With many layers and a large area, especially at zoom levels
above 17, the tile count can be huge and downloads may take several hours
to several days.

**Processing and privacy:** it runs locally, using QGIS processes and supervising threads. It adjusts the load to your
memory/CPU and server responses. It doesn't upload your project or
diagnostics to the author and has no analytics. Requests send the
necessary area, layer settings and authentication to the services you choose.
Check the result offline.

**Responsibility:** please respect service licenses, attribution and limits on
downloading or reusing data; the plugin grants no rights to third-party content.
To the extent permitted by law, the author isn't liable for users' violations.
Code license: GPL-2.0-only.

Built with help from AI and vibe coding, and tested (Bandit, secret scanning,
Qt6 checks, Ruff/Flake8, proxy/error handling, archive integrity and crash recovery).
[User guide](INSTRUKCJA.md) · [Release checks](https://github.com/jaroslaw-sadowski/qgis-project-snapshot/blob/main/docs/release-1.0.2.md).

## Polski

Zabierz projekt QGIS do pracy offline z wektorami, bezstratnymi obrazami
map, stylami i raportem. Pobierz **mapy WMS/WMTS i kafelki XYZ**, np. podkłady
OpenStreetMap, do pracy bez sieci. Wskaż obszar z widoku mapy lub warstwy
poligonowej. Zachowaj całe archiwum, żeby je przenieść lub wznowić pobieranie.

**Na początek:** potrzebujesz QGIS 3.40–3.x (Qt5) lub QGIS 4.x (Qt6), z Pythonem
≥3.10 i GDAL ≥3.7 dostarczanymi przez QGIS. Ochronę XML zapewnia dołączony
defusedxml (licencja PSF); nie instalujesz dodatkowych pakietów Pythona. Zadbaj o dostęp do źródeł i miejsce na dysku.
W **Wtyczki → Zarządzanie wtyczkami → Instaluj z ZIP** wybierz
`qgis-project-snapshot-1.0.2.zip` i uruchom QGIS ponownie. Wybierz
**Wtyczki → QGIS Project Snapshot**.

**Zaplanuj czas:** Przy wielu warstwach i dużym obszarze, zwłaszcza przy zoomie
powyżej 17, liczba kafelków może być ogromna, a pobieranie potrwać od kilku
godzin do kilku dni.

**Działanie i prywatność:** działa na Twoim komputerze, w kilku
procesach QGIS i wątkach nadzorujących. Wtyczka sama dobiera obciążenie do pamięci,
CPU i odpowiedzi serwerów. Nie wysyła projektu ani diagnostyki do autora i nie
prowadzi analityki. Zapytania przekazują wybranym usługom niezbędny zasięg,
ustawienia warstw i uwierzytelnienie. Sprawdź wynik bez dostępu do źródeł.

**Odpowiedzialność:** pamiętaj o licencjach usług, podawaniu źródeł i ograniczeniach
pobierania oraz wykorzystania danych. Wtyczka nie daje praw do cudzych treści.
W granicach prawa autor nie odpowiada za naruszenia użytkownika.
Licencja kodu: GPL-2.0-only.

Wtyczka powstała z pomocą AI, metodą vibe codingu. Przeszła testy (Bandit, skan
sekretów, Qt6, Ruff/Flake8, obsługa proxy/błędów, integralność archiwum i wznowienie
po awarii). [Instrukcja](INSTRUKCJA.md) · [Kontrole wydania](https://github.com/jaroslaw-sadowski/qgis-project-snapshot/blob/main/docs/release-1.0.2.md).
