g.gui - Launches a GRASS graphical user interface (GUI) session.

Authors

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

Description

       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).

Examples

Setdefaultuserinterfacesettings
       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 donotlaunch the GUI:
       g.gui -dn ui=wxpython

   Loadworkspacefromcommandline
       Start the GUI from command line with an existing workspace:
       g.gui workspace=myproject.gxw

Keywords

       general, GUI, user interface

Name

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

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.

Source Code

       Available at: g.gui source code (history)

       Accessed: Friday Apr 04 01:18:53 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

GRASS 8.4.1                                                                                        g.gui(1grass)

Synopsis

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

   Flags:-f
           Start GUI in the foreground
           By  default  the GUI starts in the background and control is immediately returned to the caller. When
           GUI runs in foregreound, it blocks the command line

       -d
           Update default user interface settings

       -n
           Do not launch GUI after updating the default user interface settings

       --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: wxpythonwxpython: 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)