g.gui.1grass man page

g.gui — Launches a GRASS graphical user interface (GUI) session.
Optionally updates default user interface settings.


general, GUI, user interface


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


Update default user interface settings
Do not launch GUI after updating the default user interface settings
Print usage summary
Verbose module output
Quiet module output
Force launching GUI dialog


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
Name of workspace file to load on start-up (valid only for wxGUI)


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 7 comes with both a wxPython-based GUI aka wxGUI (ui=wxpython) and command line text-based UI (ui=text).


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/.grass7/rc on Unix-based operating systems and %APPDATA%\GRASS7\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.

The old gis.m and d.m Tcl/Tk-based GUIs known from GRASS GIS 6 have been dropped in GRASS GIS 7.


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

See Also

wxGUI, g.gisenv, GRASS variables

wxGUI wiki page


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

Last changed: $Date: 2014-04-21 13:58:28 +0200 (Mon, 21 Apr 2014) $

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

© 2003-2016 GRASS Development Team, GRASS GIS 7.0.4 Reference Manual


GRASS 7.0.4 Grass User's Manual