XDG Base Directory

1.2.3

XDG_CONFIG_HOME/Google/AndroidStudioX.X
XDG_DATA_HOME/Google/AndroidStudioX.X
XDG_CACHE_HOME/Google/AndroidStudioX.X

Location overview by Google does not mention XDG - paths could be hardcoded instead of using the proper variable, though that is unlikely as Intellij IDEA, which Android Studio is based on, implements it properly as well

XDG_CONFIG_HOME/aria2/
XDG_CACHE_HOME/aria2/

XDG_CONFIG_HOME/audacity
XDG_DATA_HOME/audacity

XDG_CONFIG_HOME/Bitwarden CLI
XDG_DATA_HOME/audacity

The environment variable takes precedence.

Currently contains a single data.json file with all the vault data, so it ought to belong in

Legacy path takes precedence if present, or if XDG_CONFIG_HOME is not set.

XDG_CONFIG_HOME/calcurse
XDG_DATA_HOME/calcurse

If the legacy path is present, it will take precedence.

XDG_CACHE_HOME/ccache
XDG_CONFIG_HOME/ccache/ccache.conf

XDG_CACHE_HOME/clangd

Project specific configuration can be specified in . Configuration is combined when this is sensible. In case of conflicts, user config has the highest precedence, then inner project, then outer project.

27.1

Legacy paths have precedence over XDG paths. Emacs will never create . Workaround for 26.3 or older: It's possible to set , but it has unexpected side effects.

0.20.0

XDG_CONFIG_HOME/FreeCAD
XDG_DATA_HOME/FreeCAD
XDG_CACHE_HOME/FreeCAD

legacy path can be used with

60e0cfe 483505f

3.0-stable

XDG_CONFIG_HOME/JetBrains/IntelliJIdeaXXXX.X
XDG_DATA_HOME/JetBrains/IntelliJIdeaXXXX.X
XDG_CACHE_HOME/JetBrains/IntelliJIdeaXXXX.X

full support in 600

a6f56f7 25bd2ee

XDG_CONFIG_HOME/luarocks
XDG_CACHE_HOME/luarocks

If the legacy path is present, it will take precedence.

1b99570 0b71156 ce401d7

3540200 4.2

af2f409 v1.6.7+

38d9f81 27cd86e

ebcf3de

github.com/osc/pull/940

Legacy path takes precedence if it exists

87f1e8f a9020c6 3b22f0f 0a012ae

a0be0cc7 15e1fc92 e9d1be0e

59a8618 87ae830 9ab510a 4c195bc

fd8686e 66d704b 51cff01

XDG_CONFIG_HOME/gemrc
XDG_CONFIG_HOME/irb
XDG_DATA_HOME/gem
XDG_DATA_HOME/rdoc

mv ~/.scummvm "$XDG_DATA_HOME"/scummvm/saves

3e4591d bd8c427 f57fc71

68a25c7 d138908

3.2

XDG_CONFIG_HOME/weechat
XDG_CACHE_HOME/weechat
XDG_DATA_HOME/weechat

9fc6b37 eaccf70

XDG_CACHE_HOME/xmonad
XDG_CONFIG_HOME/xmonad
XDG_DATA_HOME/xmonad

Alternatively, it always respects , XMONAD_CONFIG_DIR, and .

20db937f 1.1.0

export CALCHISTFILE="$XDG_CACHE_HOME"/calc_history

or use the fork that has native XDG support:

Despite this, clusterssh will still create .

The environment variable GHCUP_USE_XDG_DIRS can be set to any non-empty value. See .

Note that this currently does not work out-of-the-box using systemd user units and socket-based activation, since the socket directory changes based on the hash of . You can get the new socket directory using and have to modify the systemd user units to listen on the correct sockets accordingly.

The value of this variable must include the substring , which will be replaced at run time with the current version string.

"$XDG_CONFIG_HOME"/irb/irbrc

IRB.conf[:SAVE_HISTORY] ||= 1000
IRB.conf[:HISTORY_FILE] ||= File.join(ENV["XDG_DATA_HOME"], "irb", "history")

export JUPYTER_CONFIG_DIR="$XDG_CONFIG_HOME"/jupyter

v5.0.0 <= < v6.0.0:

(see )

>= v6.0.0: full support (via ) enabled by default

to change the m2 repo location used by leiningen look here: Leiningen#m2_repo_location

Make sure XDG_CACHE_HOME is set beforehand to directory user running Xorg has write access to.

Do not use XDG_RUNTIME_DIR as it is available after login. Display managers that launch Xorg (like GDM) will repeatedly fail otherwise.

/opt/maptool/lib/app/MapTool.cfg

[JavaOptions]
-DMAPTOOL_DATADIR=.local/share/maptool-rptools

However, no way to change the location of this configuration file.

Creates a further directory in for whatever reason.

only supported for mysql-server, not mysql-client 

unsupported

,

is unnecessary (and unsupported) if Node.js is installed by .

If you want to configure this system-wide, the file to edit is , not . You can confirm that the config is loaded by running

Both configuration and state data are stored in , so this solution is not fully compliant.

The option must be given an absolute path.

Currently it hard-codes .

It is required to create both directories:

,

Other files need to be configured like Emacs.

Setting this makes the editor look for the contents of in $VSCODE_PORTABLE/user-data.

You can also run Visual Studio with the flag, such as . This is documented and probably will not break as unexpectedly, as it is .

The directory needs to be created manually

, export WINEPREFIX="$XDG_DATA_HOME"/wineprefixes/default

Note that LightDM does not allow you to change this variable. If you change it nonetheless, you will not be able to login. Use startx instead or configure LightDM. According to SLiM has hardcoded.

The SDDM Xauthority path can be changed in its own configuration files as shown below. Unfortunately, it is relative to the home directory.

Note that these variables are respected by xinit, but not by startx. Instead, specify the filename as an argument:

Depending on where you have configured your $XDG_CACHE_HOME, you made need to expand the paths yourself. Unlike most other examples in this table, actual X11 init scripts will vary a lot between installations.

In the above config file, some locations can be customized using options like and .

Specify the new directories used by Arduino CLI in arduino-cli.yaml as mentioned in the documentation here.

can be sourced from a different location in .

Specify as an alternative to for interactive shells.

~/.librewolf

PYTHONPYCACHEPREFIX: PYTHONUSERBASE: export $XDG_DATA_HOME/python

Note that this requires root privileges and will change the location of for all users. This can be mitigated by checking for an existing inside the form.

"$XDG_CONFIG_HOME"/vim/vimrc

set runtimepath^=$XDG_CONFIG_HOME/vim
set runtimepath+=$XDG_DATA_HOME/vim
set runtimepath+=$XDG_CONFIG_HOME/vim/after

set packpath^=$XDG_DATA_HOME/vim,$XDG_CONFIG_HOME/vim
set packpath+=$XDG_CONFIG_HOME/vim/after,$XDG_DATA_HOME/vim/after

let g:netrw_home = $XDG_DATA_HOME."/vim"
call mkdir($XDG_DATA_HOME."/vim/spell", 'p')

set backupdir=$XDG_STATE_HOME/vim/backup | call mkdir(&backupdir, 'p')
set directory=$XDG_STATE_HOME/vim/swap   | call mkdir(&directory, 'p')
set undodir=$XDG_STATE_HOME/vim/undo     | call mkdir(&undodir,   'p')
set viewdir=$XDG_STATE_HOME/vim/view     | call mkdir(&viewdir,   'p')

if !has('nvim') | set viminfofile=$XDG_STATE_HOME/vim/viminfo | endif

environment variable will also affect Neovim. If separate configs for Vim and Neovim are desired then the following will be a better choice:
export GVIMINIT='let $MYGVIMRC = !has("nvim") ? "$XDG_CONFIG_HOME/vim/gvimrc" : "$XDG_CONFIG_HOME/nvim/init.gvim" | so $MYGVIMRC'
export VIMINIT='let $MYVIMRC = !has("nvim") ? "$XDG_CONFIG_HOME/vim/vimrc" : "$XDG_CONFIG_HOME/nvim/init.vim" | so $MYVIMRC'

• https://blog.joren.ga/vim-xdg
• https://tlvince.com/vim-respect-xdg

export HISTFILE="$XDG_STATE_HOME"/zsh/history

 /!\ The folder needs to exist