Open main menu

Gramps β

Difference between revisions of "Gramps 5.1 Wiki Manual - User Directory"

m (POSIX - style systems: oops: Fix for naming consistency)
m (Protected "Gramps 5.1 Wiki Manual - User Directory": Manual rolled over for Gramps 5.2 - protecting old version from further edits ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
 
(17 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{man index|Gramps_5.1_Wiki_Manual_-_Command_Line#Environment_variables|Gramps 5.1 Wiki Manual - Error and Warning Reference|5.1}}  
+
{{man index|Gramps_5.1_Wiki_Manual_-_Command_Line|Gramps 5.1 Wiki Manual - Error and Warning Reference|5.1}}  
 
{{languages|Gramps_5.1_Wiki_Manual_-_User_Directory}}
 
{{languages|Gramps_5.1_Wiki_Manual_-_User_Directory}}
 
{{#vardefine:chapter|D}}
 
{{#vardefine:chapter|D}}
 
{{#vardefine:figure|0}}
 
{{#vardefine:figure|0}}
This appendix provides the reference to the '''Gramps user directory''' available on various operating systems.
+
This appendix provides the reference for finding the location of the '''Gramps [[Gramps_Glossary#user_directory|User Directory]]'''. The folder/directory is stored at different locations due to the requirements of Gramps forks for various operating systems or special purposes.
  
{{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 '''''<code><~username></code>''''' should be replaced by the name you use to log in to your computer.}}
+
{{man note|The location of your '''Gramps user directory''' can depend on the operating system you are using and how you have logged into your computer.|Where '''''<code><~username></code>''''' is shown below it should be replaced by the name you use to log in to your computer.}}
  
 
__TOC__
 
__TOC__
Line 29: Line 29:
 
  ~\.gramps
 
  ~\.gramps
  
=== Mac OS X ===
+
=== MacOS ===
[[File:macos_200x200.png|right|128px|link=Download#Mac_OS_X]]
+
[[File:macos_200x200.png|right|128px|link=Download#macOS]]
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
+
On Apple Macs filenames starting with "." do not show up in Finder. To simplify access to the Gramps user directory, open a terminal window using the Terminal application and type:
  ln -s .gramps gramps_user_directory
+
  ln -s ~/.gramps ~/Documents/Gramps
which will allow Finder to show the contents. Or simply click on Go -> 'Go to Folder...' in the Finder, and type
+
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.) 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
 
  ~/.gramps
in the Go to Folder dialog box.
+
in the resulting macOS {{man label|Go to the Folder}} dialog box.
  
The default location for the [[Mac OS X:Application package]] is
+
====MacOS Application Package====
 +
The [[Mac OS X:Application package]] uses a different, more MacOS-standard default location for the directory:
 
  /Users/'''''<~username>'''''/Library/Application Support/gramps
 
  /Users/'''''<~username>'''''/Library/Application Support/gramps
  
Line 43: Line 44:
 
[[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:
 
[[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]
 
* [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  
 
The default location for an installation on a Windows 7 (and newer) system is  
Line 48: Line 61:
 
or
 
or
 
  C:\Program Files (x86)\GrampsAIO32-5.X.X
 
  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
+
*{{man index|Gramps_5.1_Wiki_Manual_-_Command_Line|Gramps 5.1 Wiki Manual - Error and Warning Reference|5.1}}  
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}}
 
{{languages|Gramps_5.1_Wiki_Manual_-_User_Directory}}
 
{{grampsmanualcopyright}}
 
{{grampsmanualcopyright}}
 
[[Category:Documentation|U]]
 
[[Category:Documentation|U]]

Latest revision as of 07:22, 3 September 2023

Previous Index Next


This appendix provides the reference for finding the location of the Gramps User Directory. The folder/directory is stored at different locations due to the requirements of Gramps forks for various operating systems or special purposes.

Gramps-notes.png
The location of your Gramps user directory can depend on the operating system you are using and how you have logged into your computer.

Where <~username> is shown below it should be replaced by the name you use to log in to your computer.

Contents

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

MacOS

On Apple Macs filenames starting with "." do not show up in Finder. To simplify access to the Gramps user directory, 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.) Alternatively you can simply click on Go -> 'Go to Folder...' in the Finder, and type

~/.gramps

in the resulting macOS Go to the Folder dialog box.

MacOS Application Package

The Mac OS X:Application package uses a different, more MacOS-standard default location for the directory:

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

MS Windows

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 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% 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

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

or

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


See Also

Previous Index Next
  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