g.gui(1grass)

✨ g.gui — the manual page, but make it cute ✨

okay bestie, welcome to g.gui(1grass) 💖 this is the GRASS User's Manual page for g.gui, and it's genuinely one of my faves because it's literally just "hey, want a GUI? here's a GUI."

---

🌸 NAME 🌸

g.gui — launches a GRASS graphical user interface (GUI) session. Optionally it also updates your default user interface settings, because we love a multitasker. 💅

---

🔑 KEYWORDS 🔑

general, GUI, user interface

---

🎀 SYNOPSIS 🎀

g.gui
g.gui --help
g.gui [-fdn]  [ui=string]   [workspace=name.gxw]   [--help]  [--verbose]
[--quiet]  [--ui]

✨ Flags ✨

• -f — start the GUI in the foreground. by default the GUI starts in the background and control is immediately returned to the caller, but when the GUI runs in the foreground it blocks the command line, so like… it's holding your terminal's hand and not letting go. 🙈
• -d — update default user interface settings.
• -n — do not launch the GUI after updating the default user interface settings. just vibes, no window. 💀
• --help — print usage summary.
• --verbose — verbose module output.
• --quiet — quiet module output.
• --ui — force launching GUI dialog.

🌈 Parameters 🌈

• ui=string — user interface.
  • Options: wxpython, text, gtext
  • Default: wxpython
  • wxpython: wxPython based GUI (wxGUI)
  • text: command line interface only
  • gtext: command line interface with GUI startup screen
• workspace=name.gxw — name of workspace file to load on start-up.
  • This is valid only for wxGUI (wxpython). 🦋

---

💜 DESCRIPTION 💜

The g.gui module lets you start the Graphical User Interface (GUI) straight from the command line prompt, or change your default User Interface (UI) settings. it's giving "one module, two jobs, both slaying." ✨

GRASS comes with both a wxPython-based GUI aka wxGUI (ui=wxpython) and a command line text-based UI (ui=text). pick your fighter. 💅

---

🫶 NOTES 🫶

If the -d update flag is given, or the GRASS_GUI environmental variable is unset, then the GRASS internal variable GUI is permanently changed and the selected ui will be used as the default UI from then on. no take-backs, bestie. 👑

All GRASS internal variables (check out g.gisenv) are stored in the user's home directory in a hidden file called $HOME/.grass8/rc on Unix-based operating systems, and %APPDATA%\GRASS8\rc on MS Windows. 🍓

heads up, bestie: these GRASS internal variables are not the shell environment variables, and the rc file is not a classic UNIX run command file — it just contains persistent GRASS variables. it's giving "same name, different species." 😭

---

🌟 EXAMPLES 🌟

🧚 Set default user interface settings 🧚

Set default user interface setting to command line, text-based UI:

g.gui -d ui=text

Set default user interface setting to the graphical user interface (GUI) and launch the GUI:

g.gui -d ui=wxpython

Set default user interface setting to the graphical user interface (GUI) but do not launch the GUI:

g.gui -dn ui=wxpython

🌈 Load workspace from command line 🌈

Start the GUI from command line with an existing workspace:

g.gui workspace=myproject.gxw

---

👀 SEE ALSO 👀

• wxGUI
• g.gisenv
• GRASS variables

also the wxGUI wiki page. 🦋

---

👑 AUTHORS 👑

• Martin Landa, FBK-irst, Trento, Italy
• Hamish Bowman, Otago University, Dunedin, New Zealand (fine tuning)

iconic duo, fr fr. 💖

---

⭐ SOURCE CODE ⭐

Available at: g.gui source code (history)

Latest change: Friday Aug 08 09:39:19 2025 in commit: ed72c71d8580e872cd6fd345c84a15c324764465

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

---

and that's the whole page, bestie!! 💅✨

this was the g.gui(1grass) manual page, churned out of the GRASS 8.5.0 Reference Manual, and it's © 2003-2026 GRASS Development Team, version GRASS 8.5.0. 🎀 no cap, you now know more about launching a GUI than half the internet. go forth and ui=wxpython, my love. 🫶💜🌸