g.gui1grass
Launches a grass graphical user interface (gui) session. optionally updates default user interface settings.
Usage
g.gui
g.gui --help
g.gui [-fdn]
[ui=string]
[workspace=name.gxw]
[--help]
[--verbose]
[--quiet]
[--ui]
Keywords
general, GUI, user interface
Overview
The g.gui module allows user to start the Graphical User Interface (GUI) from the command line prompt or to change the default User Interface (UI) settings.
GRASS GIS comes with both a wxPython-based GUI aka wxGUI (ui=wxpython) and command line text-based UI (ui=text).
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.
All GRASS internal variables (see 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. Note that 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.
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
Source code
Available at: g.gui source code (history)
Accessed: Monday Feb 24 17:50:28 2025
Main index | General index | Topics index | Keywords index | Graphical index | Full index
© 2003-2025 GRASS Development Team, GRASS GIS 8.4.1 Reference Manual
Releases
8 releases since Debian 6.0 (Squeeze); the text changed 7 times.