Changes

Jump to: navigation, search

Gramps 5.1 Wiki Manual - User Directory

1,469 bytes added, 12:55, 2 October 2021
m
Expand summary, add link to Gramps Glossary
{{#vardefine:chapter|D}}
{{#vardefine:figure|0}}
This appendix provides the reference to for finding the location of the '''Gramps user directory[[Gramps_Glossary#user_directory|User Directory]]''' available on . The folder/directory is stored at different locations due to the requirements of Gramps forks for various operating systemsor special purposes.
{{man note|Note|The location of your '''Gramps user directory''' depends can depend on the operating system you are using and how you have set up logged into your computer. <br />In the table below |Where '''''<code><~username></code>''''' is shown below it should be replaced by the name you use to log in to your computer.}}
__TOC__
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:
/HOME/'''''<username>'''''/.grampswhich can also be entered as '''''<~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], [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]].
Alternately, you can leverage the '''$HOME''' [http://www.linfo.org/home_directory.html 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 ===[[File:macos_200x200.png|right|128px|link=Download#Mac_OS_XmacOS]]On Apple Macs running OS X, filenames starting with "." do not show up in Finder. To make simplify access to the Gramps user directory easy, open a terminal window with Finder-Applications-Utilities-using the Terminal application and type there: ln -s ~/.gramps gramps_user_directory~/Documents/Grampswhich will allow make Finder to show the contentsdirectory as a folder in your Documents folder named "Gramps". Or (You can replace "Gramps" with whatever name you wish, but use a / before any spaces.) Alternatively you can simply click on [https://osxdaily.com/2011/08/31/go-to-folder-useful-mac-os-x-keyboard-shortcut/ {{man menu|Go -> 'Go to Folder...' }}] in the Finder, and type
~/.gramps
in the resulting macOS {{man label|Go to the Folder }} dialog box.
====MacOS Application Package====The default location for the [[Mac OS X:Application package]] isuses a different, more MacOS-standard default location for the directory:
/Users/'''''<~username>'''''/Library/Application Support/gramps
[[File:windows_180x160.png|right|128px|link=Download#MS_Windows]]On Microsoft Windows, filenames and folder for programs and userdata are [https://wikipedia.org/wiki/Hidden_file_and_hidden_directory hidden] in the ''File Explorer''. To make access to the Gramps user directory easy follow the following advice from Microsoft:
* [https://support.microsoft.com/en-ca/help/14201/windows-show-hidden-files Show hidden files - Windows Help]
 
 
The default '''User Directory''' location for any Gramps user data on a Windows 7 (and newer) system is
C:\Users\'''''<~username>'''''\AppData\Roaming\gramps
 
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%''' [https://wikipedia.org/wiki/Environment_variable#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
 
<hr />
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
or
C:\Program Files (x86)\GrampsAIO32-5.X.X
{{-}}
== See Also ==
* [[Gramps_5.1_Wiki_Manual_-_Command_Line|Command Line]] Configuration (config) option with [[Gramps_5.1_Wiki_Manual_-_Command_Line#Environment_variables|Environment Variables]]
* [https://winaero.com/how-to-enter-file-location-manually-in-gtk-3-opensave-dialog/ Switching from Breadcrumbs to a location text box] using {{Man key press|Crtl|L}} in GTK file dialogs
* Discourse forum thread : [https://gramps.discourse.group/t/how-to-set-the-base-path-from-media-relative-to-grampshome/481/2 how to use Environment Variables in Gramps]
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%''' [https://wikipedia.org/wiki/Environment_variable#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{{-}}*{{man index|Gramps_5.1_Wiki_Manual_-_Command_Line#Environment_variables|Gramps 5.1 Wiki Manual - Error and Warning Reference|5.1}}
{{languages|Gramps_5.1_Wiki_Manual_-_User_Directory}}
{{grampsmanualcopyright}}
[[Category:Documentation|U]]
3,044
edits

Navigation menu