Gramps 5.1 Wiki Manual - User Directory

From Gramps
Jump to: navigation, search
Previous Index Next


This appendix provides the reference to the Gramps user directory available on various operating systems.

Gramps-notes.png
Note

The location of your Gramps user directory depends on the operating system you are using and how you have set up your computer.
In the table below <~username> should be replaced by the name you use to log in to your computer.

POSIX - style systems

The default user directory location for Gramps in a POSIX-style environment is:

/HOME/<username>/.gramps

which can also be entered as

<~username>/.gramps

This is true for BSD, Linux, Solaris, Unix and Mac OS-X when using Mac OS X Build from source.

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:

$HOME/.gramps

or

~/.gramps

Or if using MS Windows the following syntax is used

$HOME\.gramps

or

~\.gramps

Mac OS X

Macos 200x200.png

On Apple Macs running OS X, filenames starting with "." do not show up in Finder. To make access to the Gramps user directory easy, open a terminal window with Finder-Applications-Utilities-Terminal and type there

ln -s .gramps gramps_user_directory

which will allow Finder to show the contents. Or simply click on Go -> 'Go to Folder...' in the Finder, and type

~/.gramps

in the Go to Folder dialog box.

The default location for the Mac OS X:Application package is

/Users/<~username>/Library/Application Support/gramps

MS Windows

Windows 180x160.png

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 location for an installation on a Windows 7 (and newer) system is

C:\Program Files\GrampsAIO64-5.X.X

or

C:\Program Files (x86)\GrampsAIO32-5.X.X


The default location for any Gramps user data on a Windows 7 (and newer) system is

C:\Users\<~username>\AppData\Roaming\gramps

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:

%AppData%\gramps


See Also

  • Command Line Configuration (config) option
  • Re-use this page in the manual with [[Gramps_{{Version manual}}_Wiki_Manual_-_User_Directory|Gramps user directory]]
Previous Index Next
Gnome-important.png 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.
Also, only use the known Typographical conventions