Changes

Jump to: navigation, search

Gramps 5.1 Wiki Manual - User Directory

2,226 bytes added, 20:13, 30 December 2020
m
See Also: Environment variables, breadcrumbs and Gramps
{{#vardefine:chapter|D}}
{{#vardefine:figure|0}}
This appendix provides the reference to the '''Gramps user directory ''' available on various operating systems.
{{man note|Note|The location of your '''Gramps user directory ''' depends on the operating system you are using and how you have set up 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__
== [[Gramps_Glossary#posix|POSIX]] - style systems ==
The default user directory location for Gramps in a [httphttps://en.wikipedia.org/wiki/Posix POSIX]-style [httphttps://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard environment] is:
/homeHOME/'''''<username>'''''/.grampswhich can also be entered as '''''<~username>'''''/.gramps
This is true for [httphttps://en.wikipedia.org/wiki/Bsd BSD], [httphttps://en.wikipedia.org/wiki/Linux Linux], [httphttps://en.wikipedia.org/wiki/Solaris_(operating_system) Solaris], [httphttps://en.wikipedia.org/wiki/Unix Unix] and [httphttps://en.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/.grampsor ~/.gramps Or if using MS Windows the following syntax is used  $HOME\.grampsor ~\.gramps === Mac OS X MacOS ===[[File:macos_200x200.png|right|128px|link=Download#Mac_OS_XmacOS]]On Apple Macs, 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
== MS Windows ==
[[File:windows_180x160.png|right|128px|link=Download#MS_Windows]]On Microsoft Windows, filenames and folder for programs and userdata do not show up 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 higher newer) system is
C:\Program Files\GrampsAIO64-5.X.X
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 an user data on a Windows 7 and higher system is C:\Users\<~username>\AppData\Roaming\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]]
2,785
edits

Navigation menu