Gramps 5.2 Wiki Manual - User Directory
Previous | Index | Next |
Languages: |
English • Deutsch • español • suomi • français • עברית • македонски • Nederlands • русский • shqip • slovenčina |
This appendix documents the location of the Gramps User Directory. That directory, or folder, is stored at different locations due to
- differences in operating systems
- your username, i.e. the account with which you've logged into your computer. Where <username> is shown below it should be replaced by your username.
- user configuration
Contents
New and old default locations and fallback behavior
In Gramps 5.2, on every operating system, the default location of the user directory changed. New and old default user directory locations for each OS are given below. If Gramps 5.2 and later detects a user directory in the old default location, it will use that directory and not create one in the new default location. Otherwise, it will create a user directory in the new default location.
POSIX - style systems
The default user directory location for Gramps in a POSIX-style environment is — ⚡new for version 5.2.0
/home/<username>/.local/share/gramps
In Gramps 5.1 and earlier, the user directory on a POSIX-style environment was
/home/<username>/.gramps
This is true for BSD, Linux, Solaris and Unix.
For brevity, you can use tilde notation. The path above can be simplified to
~<username>/.local/share/gramps
or, to avoid referring to the username,
~/.local/share/gramps
You can also use the $HOME environment variable. Although Gramps will not recognize environment variables in paths internally, you can use them in a terminal or in scripts. Using $HOME, the path above can be simplified to
$HOME/.local/share/gramps
macOS
The default user directory location for Gramps on macOS, both the Mac OS X:Application package and built from source, is (similar to other POSIX systems) — ⚡new for version 5.2.0
/Users/<username>/.local/share/gramps
In Gramps 5.1 and earlier, the user directory for the Gramps Mac OS X:Application package was
/Users/<username>/Library/Application Support/gramps
but the user directory for Gramps built from source on macOS was (similar to other POSIX systems)
/Users/<username>/.gramps
macOS filenames, including directories, starting with "." (period) do not show up in Finder. Access the Gramps user directory in any of these ways:
- In Finder, navigate to the directory which contains the hidden file or directory you want to see and type command-shift-. (period). All of the hidden files and directories in that directory will be shown.
- Click on Go -> 'Go to Folder...' in the Finder, and type
~/.gramps
- in the resulting macOS Go to the Folder dialog box.
- 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.)
MS Windows
The default User Directory location for any Gramps user data on a Windows 7 (and newer) system is — ⚡new for version 5.2.0
C:\Users\%username%\AppData\Local\gramps
In Gramps 5.1 and earlier, the user directory for Windows 7 (and newer) was
C:\Users\%username%\AppData\Roaming\gramps
Alternately, you can use the %LocalAppData% environment variable to avoid referring to the username. (We've chosen to use the username environment variable in the documentation for Windows rather than <username> used for documenting other OSes.) Although Gramps will not recognize environment variables for paths internally, you can use them within Windows to find Gramps user files. The path above can be simplified to:
%LocalAppData%\gramps
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:
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\GrampsAIO64-5.X.X
See Also
- 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 threads :
Previous | Index | Next |
Languages: |
English • Deutsch • español • suomi • français • עברית • македонски • Nederlands • русский • shqip • slovenčina |
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. |