Gex Help - Configuration file

Go to SourceForge project page...
Go back to help index
Gex Logo


Gex configuration file has structure similar to XML, but simpler. Sections and subsections are marked with <...> but properties are just 'prop_name value'. Top level section is <GexConfig>. All sections' and properties' names are case sensitive. Lines beginning with # are comments and are ignored.

Compacting

single - there can be only one such subsection
single by xxx - there can be only one subsection with field xxx = something, but there can be another such subsection with field xxx of different value
multiple - there can be unlimited amount of such sections

Properties

Properties allowed for each section are listed with their types.
string - any string value. String may be surrounded by apostrophes ('). If string is empty it must be marked as: ''.
int:min-max - integer in range from min to max inclusive.
enum:val1/val2/valN - enumeration, one of given strings. Enums are case sensitive.
bool - boolean value, equal to [enum:yes/no].

Default settings

There are some default settings that cannot be overwritten in config file. These are Toolbar, ListLayout and Layout all with field Desc set to Default. Those are fail-safe settings and if you redefine them in one of config files it will be ignored.

Config structure

Sections

GexConfig

Properties

GexConfig
CurrentLayout
string
Layout to use on startup
WindowWidth
int:0-10000
Window horizontal size
WindowHeight
int:0-10000
Window vertical size
Detach
bool
Fork and detach from terminal after startup
FontSize
int:3-30
Font size which should be used
LargeIcons
bool
Display larger toolbar icons
HTMLBrowser
string
Executable used to view HTML files
TerminalExec
string
Executable used to open terminal
DefSearchSpeed
int:1-1000
Default file search output speed in interactive mode
ExpertMode
bool
Menus layout: expert or simplified mode

Items
Item
string (multiple)
String item

History
Type
string
History type identifier

Bookmark
Desc
string
Bookmark description
Source
string
Bookmark target path

DirTree
Desc
string
Description to show in folders tree
Source
string
Mount point source directory
Encoding
string
File system character encoding
Display
bool
Is this mount point displayed by folders tree
Index
int:1-INT_MAX
Position in folders tree
CommandMount
string
Command to mount filesystem
CommandUnmount
string
Command to unmount filesystem
CommandEject
string
Command to eject device
CanEject
bool
Is this device ejectable

FileDesc
Desc
string
File type description
Pattern
string
Matching pattern
Regex
bool
Is pattern a regular expression
Case
bool
Is pattern case sensitive
Icon
string
Path to file type icon
CmdExec
string
Command to execute file
CmdEdit
string
Command to edit file
CmdView
string
Command to view file

Action
Desc
string
Action description
Command
string
Command to perform this action

Layout
Desc
string
Layout description
Type
enum:hsplit/vsplit/list/text/hex/image
Data view type
ViewLayout
string
Data view layout to use
Width
int:0-10000
Size of this sublayout's paned window
FTreeCase
bool
Is folders tree sorted case sensitively
FTreeHidden
bool
Does folders tree show hidden files
FTreeLinks
bool
Does folders tree show symlinks
FTreeNAvail
bool
Does folders tree show not available folders
FTreeSize
int:0-10000
Folders tree's paned size
FTreeToolbar
bool
Is folders tree's toolbar visible
FTreeVisible
bool
Is folders tree visible

SubLayout
Type
enum:hsplit/vsplit/list/text/hex/image
Data view type
ViewLayout
string
Data view layout to use
Width
int:0-10000
Size of this sublayout's paned window

Toolbars
Toolbar
string (multiple)
Toolbar preset to display in this layout

ListLayout
Desc
string
List layout description
ShowCLine
bool
Show command line
ShowStatus
bool
Show status bar
ColorizeRows
bool
Use different background colour for neighbour rows
SortColumn
string
Sort-by column type
SortDirFirst
bool
Keep directories first while sorting
SortByType
bool
Group entries by file type
SortOrder
enum:ascending/descending
Sorting order
SortCase
bool
Case sensitive sorting
StartIn
string
Start in folder (path)
UseFilter
bool
Is filter active
ShowHidden
bool
Show hidden files
ShowFolders
bool
Show folders

Column
Type
string
Column type
Size
int:20-10000
Column's width

LogWindow
Visible
bool
Is logger window visible after startup
AppendToFile
string
Path to file to append logs
ShowInfo
bool
Show Info messages
PopupInfo
bool
Popup on new Info messages
ShowConfig
bool
Show Config messages
PopupConfig
bool
Popup on new Config messages
ShowWarning
bool
Show Warning messages
PopupWarning
bool
Popup on new Warning messages
ShowError
bool
Show Error messages
PopupError
bool
Popup on new Error messages
ShowCritical
bool
Show Critical messages
PopupCritical
bool
Popup on new Critical messages
ShowDebug
bool
Show Debug messages
PopupDebug
bool
Popup on new Debug messages
ShowCode
bool
Show Code messages
PopupCode
bool
Popup on new Code messages

FilterPreset
Desc
string
Filter preset description
Pattern
string
Filter pattern
Regex
bool
Is this preset using regular expression matching
Case
bool
Is this filter case sensitive
Hidden
bool
Show hidden files (wildcard matching only)

SearchSettings
Desc
string
Preset description
FileName
string
File name pattern
FileNameCase
bool
Is file name pattern case sensitive
MaxDepth
int:-1-999
Max directory search depth
SearchMount
bool
Stay on one filesystem
FollowLinks
bool
Follow symlinks
OutputDirs
bool
Include directories in output
FileTypesShow
string
Show only these file types
FileTypesHide
string
Hide these file types
Content
string
Content filter
ContentRegex
bool
Is content filter using regular expression matching
ContentCase
bool
Is content filter case sensitive
Size
enum:equal/greater/smaller
Size filter mode
SizeVal
int:0-1000000000
Size filter value
SizeUnit
enum:B/KB/MB/GB
Size filter unit
DateType
enum:moddate/accdate/chgdate
Date filter type
DateMode
enum:earlier/later/in range/outside range
Date filter mode
Date1
string
Date value 1
Date2
string
Date value 2
NoUser
bool
Find files without owner
NoGroup
bool
Find files without group
Owner
string
Find files of this user
Group
string
Find files of this group
Perm
int:0-7777
Find files with these permissions
PermExact
bool
Match exact permissions
Custom
string
Custom search options
OutputMode
enum:flist_int/flist/list_int/list/file
Search results output mode
OutputSpeed
int:1-1000
Search results output speed in interactive modes
OutputFile
string
Output file name when saving results to a file

SelectionTemplate
Desc
string
Selection template description
Path
string
Selection template base path

Toolbar
Desc
string
Position
enum:top/bottom/left/right
View
enum:icons/text/both

TBarItem
Item
string
Toolbar item
Label
string
Label to display when button has text label (for 'Launcher' item only)
Icon
string
Icon to display when button has icon (for 'Launcher' item only)
Target
string
Application to run when launcher item clicked (for 'Launcher' item only)


Project Gex, started by Jarek Dukat, 2002