14
edits
Changes
From Gramps
Document new and old user directories for each OS, and fallback behavior
__TOC__
== New and old default locations and fallback behavior {{new|5.2.0}} ==
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.
== [[Gramps_Glossary#posix|POSIX]] - style systems ==
The default user directory location for Gramps in a [https://wikipedia.org/wiki/Posix POSIX]-style [https://wikipedia.org/wiki/Filesystem_Hierarchy_Standard environment] is:{{new|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 [https://wikipedia.org/wiki/Bsd BSD], [https://wikipedia.org/wiki/Linux Linux], [https://wikipedia.org/wiki/Solaris_(operating_system) Solaris], and [https://wikipedia.org/wiki/Unix Unix] and [https://wikipedia.org/wiki/Mac_OS_X Mac OS-X] when using [[Build_from_source#Mac_OS_X|Mac OS X Build from source]].
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 [http://www.linfo.org/home_directory.html '''$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 Application Package==
[[File:macos_200x200.png|right|128px|link=Download#macOS]]
The default user directory location for Gramps on macOS, both the [[Mac OS X:Application package]] uses a differentand [[Build_from_source#Mac_OS_X|built from source]], more macOS-standard default location is (similar to other POSIX systems) {{new|5.2.0}} /Users/''<username>''/.local/share/gramps In Gramps 5.1 and earlier, the user directory for the directoryGramps [[Mac OS X:Application package]] was
/Users/''<username>''/Library/Application Support/gramps
but the user directory for [[Build_from_source#Mac_OS_X|Gramps built from source on macOS]] was (similar to other POSIX systems)
/Users/''<username>''/.gramps
=== Accessing hidden directories in macOS ===
== MS Windows ==
[[File:windows_180x160.png|right|128px|link=Download#MS_Windows]]
The default '''User Directory''' location for any Gramps user data on a Windows 7 (and newer) system is C:\Users\''<username>''\AppData\Local\gramps{{man note|User Directory relocated {{new|5.2.0}}|'''The User Directory has relocated in version 5.2'''<br />The default '''User Directory''' location for the 5.2 version of Gramps user data on a Windows 7 (and newer) system is: <br /> <code> C:\Users\'''''%username%'''''\AppData\Local\gramps</code><br /> <code> %LocalAppData%\gramps</code><br />The default '''User Directory''' location for any In Gramps 5.1.x and earlier version of Gramps , the user data on a directory for Windows 7 (and newer) system is: <br /> <code> was C:\Users\'''''%username%'''''\AppData\Roaming\gramps</code><br /> <code> %AppData%\gramps</code>}}
Alternately, you can use the '''%LocalAppData%''' [https://wikipedia.org/wiki/Environment_variable#APPDATA 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:
