1g.gui(1)                    GRASS GIS User's Manual                   g.gui(1)
2
3
4

NAME

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

KEYWORDS

10       general, GUI, user interface
11

SYNOPSIS

13       g.gui
14       g.gui --help
15       g.gui  [-fdn]   [ui=string]    [workspace=name.gxw]   [--help]  [--ver‐
16       bose]  [--quiet]  [--ui]
17
18   Flags:
19       -f
20           Start GUI in the foreground
21           By default the GUI starts in the background and control is  immedi‐
22           ately  returned  to  the  caller.  When GUI runs in foregreound, it
23           blocks the command line
24
25       -d
26           Update default user interface settings
27
28       -n
29           Do not launch GUI after updating the default  user  interface  set‐
30           tings
31
32       --help
33           Print usage summary
34
35       --verbose
36           Verbose module output
37
38       --quiet
39           Quiet module output
40
41       --ui
42           Force launching GUI dialog
43
44   Parameters:
45       ui=string
46           User interface
47           Options: wxpython, text, gtext
48           Default: wxpython
49           wxpython: wxPython based GUI (wxGUI)
50           text: command line interface only
51           gtext: command line interface with GUI startup screen
52
53       workspace=name.gxw
54           Name of workspace file to load on start-up
55           This is valid only for wxGUI (wxpython)
56

DESCRIPTION

58       The  g.gui  module  allows  user  to start the Graphical User Interface
59       (GUI) from the command line prompt or to change the default User Inter‐
60       face (UI) settings.
61
62       GRASS   GIS   7   comes  with  both  a  wxPython-based  GUI  aka  wxGUI
63       (ui=wxpython) and command line text-based UI (ui=text).
64

NOTES

66       If the -d update flag is given or the GRASS_GUI environmental  variable
67       is  unset,  then the GRASS internal variable GUI is permanently changed
68       and the selected ui will be used as the default UI from then on.
69
70       All GRASS internal variables (see g.gisenv) are stored  in  the  user’s
71       home  directory  in a hidden file called $HOME/.grass7/rc on Unix-based
72       operating systems and %APPDATA%\GRASS7\rc  on  MS  Windows.  Note  that
73       these  GRASS internal variables are not the shell environment variables
74       and the rc file is not a classic UNIX run command file,  it  just  con‐
75       tains persistent GRASS variables.
76

EXAMPLES

78       Set default user interface setting to command line, text-based UI:
79       g.gui -d ui=text
80
81       Set  default  user  interface  setting  to the graphical user interface
82       (GUI) and launch the GUI:
83       g.gui -d ui=wxpython
84
85       Set default user interface setting  to  the  graphical  user  interface
86       (GUI) but do not launch the GUI:
87       g.gui -dn ui=wxpython
88

SEE ALSO

90        wxGUI, g.gisenv, GRASS variables
91
92       wxGUI wiki page
93

AUTHORS

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

SOURCE CODE

99       Available at: g.gui source code (history)
100
101       Main  index | General index | Topics index | Keywords index | Graphical
102       index | Full index
103
104       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
105
106
107
108GRASS 7.8.5                                                           g.gui(1)