1g.gui(1)                      Grass 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
77       The  old  gis.m  and  d.m Tcl/Tk-based GUIs known from GRASS GIS 6 have
78       been dropped in GRASS GIS 7.
79

EXAMPLES

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

SEE ALSO

93        wxGUI, g.gisenv, GRASS variables
94
95       wxGUI wiki page
96

AUTHORS

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

SOURCE CODE

102       Available at: g.gui source code (history)
103
104       Main index | General index | Topics index | Keywords index |  Graphical
105       index | Full index
106
107       © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
108
109
110
111GRASS 7.8.2                                                           g.gui(1)