Difference between revisions of "XDG Base Directory"

From ArchWiki
Jump to navigation Jump to search
m (→‎{{META Box Green|gimp (gimp)|}}: update bug id sans =)
Line 164: Line 164:
 
: https://git.gnome.org/browse/gimp/commit/?id==60e0cfe
 
: https://git.gnome.org/browse/gimp/commit/?id==60e0cfe
 
;Discussion
 
;Discussion
: https://bugzilla.gnome.org/show_bug.cgi?id==166643
+
: https://bugzilla.gnome.org/show_bug.cgi?id=166643
 
: https://mail.gnome.org/archives/gimp-developer-list/2012-October/msg00028.html
 
: https://mail.gnome.org/archives/gimp-developer-list/2012-October/msg00028.html
  

Revision as of 19:55, 28 May 2015

Legend

Supported: Supports the XDG Base Directory Specification.
Partial: Emulation of XDG can be obtained via the use of environment variables or command-line options.
Hardcoded: No reliable mechanism to use alternative directories or files.

Exceptions

~/.ssh
Assumed to be present by many ssh daemons and clients such as DropBear and OpenSSH. https://bugzilla.mindrot.org/show_bug.cgi?id==2050
~/.pki
Part of Mozilla's NSS Project
~/.netrc
Like ~/.ssh, many programs expect this file to be here. These include projects like curl (CURLOPT_NETRC_FILE), ftp (NETRC), s-nail (NETRC), etc. While some of them offer alternative configurable locations, many do not such as w3m, wget and lftp.
~/.dbus
Is unfortunately required by the specification, an oversight to be sure. https://bugs.freedesktop.org/show_bug.cgi?id==35887

Contributing

When contributing make sure to set the appropriate level of support (see above).

Nothing should require code evaluation (such as vim and VIMINIT) or patches to gain support and anything which does must be set to hardcoded.

To add a new entry set the title as follows: (Try to maintain alphabetical order under the appropriate letter header.)

=={{META Box Yellow|{{ic|~/.dotfile-you-would-see}} ([project-website project])|}}==

Change Yellow to the appropriate support level defined above.

Try to find the commit or version a project switched to XDG Base Directory or any open discussions and include them in a definition list, e.g.

;Since
: http://commit-url
;Discussion
: http://any-links-to-open-discussions

Next include any appropriate workarounds or solutions. Be terse, this document assumes good charity of the reader. If something is unclear then feel free to expend some explaination to clarify it.

A

~/.abook (abook)

--config "${XDG_CONFIG_HOME:-$HOME/.config}"/abook/abookrc
--datafile "${XDG_CACHE_HOME:-$HOME/.cache}"/abook/addressbook

antimicro (antimicro)

Since
https://github.com/Ryochan7/antimicro/commit/edba864
Discussion
https://github.com/Ryochan7/antimicro/issues/5

~/.ApacheDirectoryStudio (Apache Directory Studio)

~/.aMule (Amule)

~/.aspell.conf (GNU Aspell)

B

blender (blender)

Since
http://git.blender.org/gitweb/gitweb.cgi/blender.git/commit/4293f473
Discussion
https://developer.blender.org/T28943

burp (burp)

Since
https://github.com/falconindy/burp/commit/f2388e9

C

~/.cargo (cargo)

Discussion
https://github.com/rust-lang/cargo/pull/148
export CARGO_HOME=="${XDG_DATA_HOME:-$HOME/.local/share/}"/cargo

chromium (chromium)

Since
https://src.chromium.org/viewvc/chrome?revision==23057&view==revision
Discussion
https://code.google.com/p/chromium/issues/detail?id==16976

~/.conkyrc (conky)

--config=="${XDG_CONFIG_HOME:-$HOME/.config}"/conky/conkyrc

cower (cower)

Since
https://github.com/falconindy/cower/commit/8b70805

D

dconf (dconf)

d-feet (d-feet)

Since
https://git.gnome.org/browse/d-feet/commit/?id==7f6104b

~/.dircolors (coreutils)

$ source "$(dircolors "${XDG_CONFIG_HOME:-$HOME}"/dircolors)"

dunst (dunst)

Since
https://github.com/knopwob/dunst/commit/78b6e2b1
Discussion
https://github.com/knopwob/dunst/issues/22

dwb (dwb)

E

~/.elinks (elinks)

export ELINKS_CONFDIR=="${XDG_CONFIG_HOME:-$HOME/.config}"/elinks

F

~/.fontconfig (fontconfig)

Since
http://cgit.freedesktop.org/fontconfig/commit/?id==8c255fb1


fontforge (fontforge)

Since
https://github.com/fontforge/fontforge/commit/e4c2cc7432
Discussion
https://github.com/fontforge/fontforge/issues/847
https://github.com/fontforge/fontforge/issues/991

~/.fonts (fontconfig)

Use "${XDG_DATA_HOME:-$HOME/.local/share}"/fonts instead.

G

~/.gconf (gconf)

Since
https://git.gnome.org/browse/gconf/commit/?id==fc28caa7
Discussion
https://bugzilla.gnome.org/show_bug.cgi?id==674803

~/.gdbinit (gdb)

$ gdb -nh -x "${XDG_CONFIG_HOME:-$HOME/.config}"/gdb/init

gimp (gimp)

Since
https://git.gnome.org/browse/gimp/commit/?id==60e0cfe
Discussion
https://bugzilla.gnome.org/show_bug.cgi?id=166643
https://mail.gnome.org/archives/gimp-developer-list/2012-October/msg00028.html

~/.gitconfig (git)

Since
https://github.com/git/git/commit/0d94427e

~/.glivrc (gliv)

--glivrc=="${XDG_CONFIG_HOME:-$HOME/.config}"/gliv/glivrc

~/.gnupg (GPG)

export GNUPGHOME=="${XDG_CONFIG_HOME:-$HOME/.config}"/gnupg
--homedir "${XDG_CONFIG_HOME:-$HOME/.config}"/gnupg

H

htop (htop)

Since
https://github.com/hishamhm/htop/commit/93233a67

~/.httpie (httpie)

Discussion
https://github.com/jakubroztocil/httpie/issues/145
export HTTPIE_CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}"/httpie

I

i3 (i3)

Since
http://code.stapelberg.de/git/i3/commit/?id=7c130fb54

i3status (i3status)

Since
http://code.stapelberg.de/git/i3status/commit/?id=c3f7fc4994

inkscape (inkscape)

Discussion
https://bugs.launchpad.net/inkscape/+bug/199720

J

K

L

lgogdownloader (lgogdownloader)

Since
https://github.com/Sude-/lgogdownloader/commit/d430af63d0006714b708d8269
Discussion
https://github.com/Sude-/lgogdownloader/issues/4

livestreamer (livestreamer)

Since
https://github.com/chrippa/livestreamer/commit/ea805917
Discussion
https://github.com/chrippa/livestreamer/pull/106

llpp (llpp)

Currently llpp places the configuration directly under XDG_CONFIG_HOME instead of creating a directory.

Since
http://repo.or.cz/w/llpp.git/commit/3ab86f0cb

M

~/.milkytracker_config (milkytracker)

Discussion
https://github.com/Deltafire/MilkyTracker/issues/12

~/.mpdconf (mpd)

Since
http://git.musicpd.org/cgit/master/mpd.git/commit/?id=87b73284

mpv (mpv)

Since
https://github.com/mpv-player/mpv/commit/cb250d490
Discussion
https://github.com/mpv-player/mpv/pull/864

~/.mutt (mutt)

Discussion
http://dev.mutt.org/trac/ticket/3207
-F ${XDG_CONFIG_HOME:-$HOME/.config}"/mutt/muttrc
muttrc
set header_cache = ~/.config/mutt/cache/headers
set message_cachedir = ~/.config/mutt/cache/messages
set mailcap_path = ~/.config/mutt/mailcap
set record = ~/.config/mutt/record/sent

mypaint (mypaint)

Since
https://github.com/mypaint/mypaint/commit/cf723b74cd

N

~/.ncmpcpp (ncmpcpp)

-c "${XDG_CONFIG_HOME:-$HOME/.config}"/ncmpcpp/config

newsbeuter (newsbeuter)

Since
https://github.com/akrennmair/newsbeuter/commit/3c57824c5
Discussion
https://github.com/akrennmair/newsbeuter/pull/39

O

offlineimap (offlineimap)

Since
https://github.com/OfflineIMAP/offlineimap/commit/5150de5
Discussion
https://github.com/OfflineIMAP/offlineimap/issues/32

P

pacman (pacman)

Since
https://projects.archlinux.org/pacman.git/commit/?id=80eca94c8
Discussion
https://mailman.archlinux.org/pipermail/pacman-dev/2014-July/019178.html

Q

R

S

T

U

util-linux (util-linux)

Since
http://git.kernel.org/cgit/utils/util-linux/util-linux.git/commit/?id=570b32100

V

~/.vim ~/.vimrc ~/.viminfo (vim)

Since 7.3.1178 vim will search for ~/.vim/vimrc if ~/.vimrc is not found.

~/.vim/vimrc
set undodir = ~/.cache/vim/undo " vim will not create this directory.
set directory = ~/.cache/vim/swap " vim will not create this directory.
set backupdir = ~/.cache/vim/backup " vim will not create this directory.
set viminfo += n ~/.cache/vim/viminfo

Also See

W

~/.wine (wine)

Discussion
https://bugs.winehq.org/show_bug.cgi?id=20888
export WINEPREFIX="${XDG_DATA_HOME:-$HOME/.local/share}"/wine/<prefix>

X

Y

Z

References