Gramps 5.1 Wiki Manual - User Directory
This appendix provides the reference to the Gramps user directory available on various operating systems.
The location of your Gramps user directory depends on the operating system you are using and how you have set up your computer.
POSIX - style systems
which can also be entered as
Alternately, you can leverage the $HOME Home directory equivalent to avoid dealing the complications of active user names. Although Gramps will not recognize directory equivalents for paths internally, you can use them within Linux to find Gramps user files. The Gramps user directory path above is simplified to either:
Or if using MS Windows the following syntax is used
On Apple Macs filenames starting with "." do not show up in Finder. To simplify access to the Gramps user directory, open a terminal window using the Terminal application and type:
ln -s ~/.gramps ~/Documents/Gramps
which will make Finder show the directory as a folder in your Documents folder named "Gramps". (You can replace "Gramps" with whatever name you wish, but use a / before any spaces.) Alternatively you can simply click on Go -> 'Go to Folder...' in the Finder, and type
in the resulting macOS Go to the Folder dialog box.
MacOS Application Package
The Mac OS X:Application package uses a different, more MacOS-standard default location for the directory:
On Microsoft Windows, filenames and folder for programs and userdata are hidden in the File Explorer. To make access to the Gramps user directory easy follow the following advice from Microsoft:
The default User Directory location for any Gramps user data on a Windows 7 (and newer) system is
The <~username> in the above filepath is a placeholder for the particular user name chosen when logging into Windows.
Alternately, you can leverage the %AppData% environment variable to avoid dealing the complications of active user names. Although Gramps will not recognize Environment Variables for paths internally, you can use them within Windows to find Gramps user files. The Gramps user directory path above is simplified to:
Like the User Directory, the location for programs/applications is also hidden from browsing with Windows Explorer.
The default location for an installation on a Windows 7 (and newer) system is
C:\Program Files (x86)\GrampsAIO32-5.X.X
- Command Line Configuration (config) option with Environment Variables
- Switching from Breadcrumbs to a location text box using Crtl+L in GTK file dialogs
- Discourse forum thread : how to use Environment Variables in Gramps
|Special copyright notice: All edits to this page need to be under two different copyright licenses:
These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: [https://www.gramps-project.org/...]), not via internal links.