g.download.project(1grass)

💖 g.download.project — the GRASS User's Manual glow-up 💖

okay bestie, sit DOWN. this is g.download.project(1grass), and it is literally the "download a whole project off the internet and make it exist in your GRASS database" module. it's giving effortless. it's giving one command. periodt. ✨

🌸 KEYWORDS 🌸

general, data, download, import — yeah, it's the whole vibe in four words 🎀

🦋 SYNOPSIS 🦋

g.download.project
g.download.project --help
g.download.project url=string  [name=name]   [path=path]   [--help]
[--verbose]  [--quiet]  [--ui]

✨ Flags:

• --help — prints the usage summary so you're not out here guessing 💅
• --verbose — verbose module output, aka the module tells you EVERYTHING it's doing 🙈
• --quiet — quiet module output, aka the module shuts up and just works 🤫
• --ui — force launches the GUI dialog, for when you want buttons instead of typing 🖱️

🎀 Parameters:

• url=string [required] — URL of the archive with a project to be downloaded. like, the URL of a ZIP, TAR.GZ, or other similar archive. no URL, no download, no project, no nothing. it is REQUIRED bestie, don't skip it 😭
• name=name — Project (location) name. specifically the project name, not the path to the project. them's different things 🫶
• path=path — GRASS database directory. Default: path to the current GRASS database. so if you don't say where, it just chucks it in the one you're already in 💜

---

🌈 DESCRIPTION 🌈

so g.download.project downloads an archived (e.g., .zip or .tar.gz) project — and yes, back in the day these were called locations, the rebrand is real — from a given URL and unpacks it to a specified or current GRASS Spatial Database. iconic behavior. 🔥

and get this: the URL can also just be a local file on the disk. like, a file that's right there. it doesn't have to be ✨the internet✨. ngl that's so convenient.

also if the archive contains a directory which contains a project, the module will recognize that and use the project automatically. it just knows. main character energy fr fr 👑

the first directory which is a project is used. that's the rule.

the rest? ignored. Other projects or any other files are ignored. not deleted, not merged, not considered — just ignored. so don't come for me when your second project doesn't show up, bestie 💀

---

🍓 EXAMPLES 🍓

💫 Download the full GRASS sample project within a running session

download and unpack the full North Carolina sample project into the user's HOME directory:

g.download.project url=https://grass.osgeo.org/sampledata/north_carolina/nc_spm_full_v2beta1.tar.gz path=$HOME

💫 Download the full GRASS sample project in a temporary session

in a temporary session, download and unpack the full North Carolina sample project into the user's HOME directory:

grass --tmp-project XY --exec g.download.project url=https://grass.osgeo.org/sampledata/north_carolina/nc_spm_full_v2beta1.tar.gz path=$HOME

look at that --exec doing its little thing. obsessed. 🧚

---

👑 SEE ALSO 👑

g.mapset, g.mapsets, r.proj, v.proj, g.proj.all

go read those next, iykyk 📚

---

💜 AUTHOR 💜

Vaclav Petras, NCSU GeoForAll Lab — thank you for your service, legend 🫡🌸

---

⭐ SOURCE CODE ⭐

Available at: g.download.project source code (history)

Latest change: Wednesday Nov 12 08:25:04 2025 in commit: 631d74bc6dbc09177e9c50eaf5debf9b107f7401

Main index | General index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual

---

okay that's the whole page bestie, every last flag and file path accounted for 💅 this was GRASS 8.5.0, and the latest change landed Wednesday Nov 12 08:25:04 2025 — go forth and download your projects, you absolute icon 🦋💖✨