1GEANY(1)                                                              GEANY(1)
2
3
4

NAME

6       Geany — a small and lightweight IDE
7

SYNOPSIS

9       geany [option]  [+number]  [files ...]
10

DESCRIPTION

12       Geany  is  a small and fast editor with basic features of an integrated
13       development environment.
14
15       Some of its features: syntax highlighting, code completion, code  fold‐
16       ing,  symbol/tag  lists  and many supported filetypes like C(++), Java,
17       PHP, HTML, DocBook, Perl and more.
18
19       Homepage: https://www.geany.org/
20

OPTIONS

22           files ...
23                 A space-separated list of filenames.  Absolute  and  relative
24                 filenames  can be used. Geany also recognises line and column
25                 information when appended to the filename with  colons,  e.g.
26                 "geany foo.bar:10:5" will open the file foo.bar and place the
27                 cursor in line 10 at column 5.
28
29                 Projects can also be opened but a project file (*.geany) must
30                 be  the  first  non-option  argument.  All additionally given
31                 files are ignored.
32
33           +number
34                 Set initial line number for the first opened  file  (same  as
35                 --line,  do  not  put a space between the + sign and the num‐
36                 ber). E.g. "geany +7 foo.bar" will open the file foo.bar  and
37                 place the cursor in line 7.
38
39           --column
40                 Set  initial  column number for the first opened file (useful
41                 in conjunction with --line).
42
43       -c, --config
44                 Use an alternate configuration directory. Default  configura‐
45                 tion   directory   is   ~/.config/geany/  and  there  resides
46                 geany.conf and some template files.
47
48           --ft-names
49                 Print a list of Geany's internal filetype names (useful snip‐
50                 pets configuration).
51
52       -g, --generate-tags
53                 Generate a global tags file (see documentation).
54
55       -P, --no-preprocessing
56                 Don't preprocess C/C++ files when generating tags.
57
58       -i, --new-instance
59                 Don't  open  files in a running instance, force opening a new
60                 instance.  Only available if Geany was compiled with  support
61                 for Sockets.
62
63       -l, --line
64                 Set initial line number for the first opened file.
65
66           --list-documents
67                 Return  a list of open documents in a running Geany instance.
68                 This can be used to read the currently  opened  documents  in
69                 Geany  from  an external script or tool. The returned list is
70                 separated by newlines (LF) and consists of  the  full,  UTF-8
71                 encoded  filenames of the documents.  Only available if Geany
72                 was compiled with support for Sockets.
73
74       -m, --no-msgwin
75                 Don't show the message window. Use this option if  you  don't
76                 need compiler messages or VTE support.
77
78       -n, --no-ctags
79                 Don't  load symbol completion and call tip data. Use this op‐
80                 tion, if you don't want to use them.   For  more  information
81                 please see documentation.
82
83       -p, --no-plugins
84                 Don't load plugin support.
85
86           --print-prefix
87                 Print installation prefix, the data directory, the lib direc‐
88                 tory and the locale directory (in this order) to stdout, each
89                 per  line.  This is mainly intended for plugin authors to de‐
90                 tect installation paths.
91
92       -r, --read-only
93                 Open all files given on the command line in  read-only  mode.
94                 This only applies to files opened explicitly from the command
95                 line, so files from previous sessions or  project  files  are
96                 unaffected.
97
98       -s, --no-session
99                 Don't load the previous session's files.
100
101       -t, --no-terminal
102                 Don't  load  terminal  support. Use this option, if you don't
103                 want to load the virtual terminal emulator widget at startup.
104                 If  you  don't have libvte.so.4 installed, then terminal-sup‐
105                 port is automatically disabled. Only available if  Geany  was
106                 compiled with support for VTE.
107
108           --socket-file
109                 Use  this  socket  filename  for communication with a running
110                 Geany instance
111
112           --vte-lib
113                 Specify explicitly the path including filename  or  only  the
114                 filename to the VTE library, e.g.  /usr/lib/libvte.so or lib‐
115                 vte.so. This option is only needed,  when  the  autodetection
116                 doesn't  work. Only available if Geany was compiled with sup‐
117                 port for VTE.
118
119       -v, --verbose
120                 Be verbose (print useful status messages).
121
122       -V, --version
123                 Show version information and exit.
124
125       -?, --help
126                 Show help information and exit.
127
128       Geany supports all generic GTK options, a list is available on the help
129       screen.
130

AUTHOR

132       This manual page was written by the Geany developer team. Permission is
133       granted to copy, distribute and/or modify this document under the terms
134       of the GNU General Public License, Version 2.
135
136       The  complete  text  of  the GNU General Public License can be found in
137       /usr/share/geany/GPL-2.
138
139
140
141geany 2.0                      October 19, 2023                       GEANY(1)