g.download.project(1)

📦
version 8.4.2 · 4 versions
, in fedora 44

💖 g.download.project — GRASS GIS User's Manual 💖

okay bestie, listen. this is a page from the GRASS GIS User's Manual, and it's about a lil command called g.download.project — and honestly? it's giving magic. it grabs a whole GRASS project off the internet and just… puts it in your database. no cap. let's get into it 🫶

✨ NAME ✨

g.download.project — Download GRASS project from the web

aka: Get GRASS project from an URL or file path. that's the whole vibe. 💅

🌸 KEYWORDS 🌸

general, data, download, import

(iykyk — those are the search tags, so you can find this page again when you forget the name, which you will, because same.)

🦋 SYNOPSIS 🦋

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

look at that. url is the only thing you actually have to give it. everything else is optional, like your weekend plans. ✨

🎀 Flags:

  • --help — prints the usage summary, for when you're lost (we've all been there)
  • --verbose — verbose module output, aka the module tells you everything it's doing
  • --quiet — quiet module output, aka the module minds its own business and shuts up
  • --ui — force launching the GUI dialog, for the visual girlies 🖥️

🍓 Parameters:

  • url=string [required] — the URL of the archive with a project to be downloaded. More specifically: URL of ZIP, TAR.GZ, or other similar archive. this one is mandatory, bestie, no skipping it
  • name=name — Project (location) name. and to be crystal clear: it's the project name, not the path to the project. don't get it twisted 🙈
  • path=path — GRASS GIS database directory. Default: the path to the current GRASS GIS database (so if you don't say anything, it just drops it where you already are 💅)

💜 DESCRIPTION 💜

so what does g.download.project actually do, you ask? it downloads an archived (e.g., .zip or .tar.gz) project — and yes, project is what we used to call a location, the rename is real — from a given URL, and then it unpacks it into a specified or current GRASS GIS Spatial Database.

and plot twist: the url can also be a local file on the disk. so it's not even always about the internet, fr fr. 🌈

and here's the part that's lowkey iconic: if the archive contains a directory which contains a project, the module will recognize that and use the project automatically. it's not confused, it's not making you dig through folders — it just knows. 🧚

the first directory which is a project is used. other projects, or any other files, are simply ignored. no drama, no errors about them, they're just background characters. periodt.

🔥 EXAMPLES 🔥

⭐ Download the full GRASS GIS 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_v2alpha2.tar.gz path=$HOME

one line. that's it. that's the whole thing. you're welcome. 💅

⭐ Download the full GRASS GIS 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_v2alpha2.tar.gz path=$HOME

this one is the same download but wearing a little --tmp-project XY jacket, so it all happens inside a throwaway session. main character energy, zero cleanup. 👑

🌈 SEE ALSO 🌈

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

(go read those next, bestie, they're the friend group.)

💖 AUTHOR 💖

Vaclav Petras, NCSU GeoForAll Lab

shoutout. legend behaviour. 🫶

🎀 SOURCE CODE 🎀

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

Accessed: Saturday Jan 17 05:41:52 2026

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

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual

ok that's the whole page, no skips, no summaries, every flag accounted for ✨ now go download a project and slay 💖

and that's a wrap, babe — this was GRASS 8.4.2, page g.download.project(1), straight from the GRASS GIS User's Manual. mwah. 💋🌸

📦 where this page comes from