user-dirs.conf(5)

user-dirs.conf5

Configuration for xdg-user-dirs-update

Overview

The /etc/xdg/user-dirs.conf file is a text file that controls the behavior of the xdg-user-dirs-update command. Users can have their own ~/.config/user-dirs.conf file, which overrides the system-wide configuration.

The following keys are recognised:

enabled=boolean

When set to False, xdg-user-dirs-update will not change the XDG user dirs configuration.

filename_encoding=encoding

This sets the filename encoding to use. encoding can be an explicit encoding name, such as UTF-8, or "locale", which means the encoding of the users locale will be used.

Lines beginning with a # character are ignored.

Environment

XDG_CONFIG_DIRS

The system-wide user-dirs.conf file is located in this directory. The default is /etc/xdg.

XDG_CONFIG_HOME

The per-user user-dirs.conf file is located in this directory. The default is $HOME/.config.

Releases

7 releases since Debian 8 (Jessie); the text changed 5 times.

  1. 8
  2. 9
  3. 10–11
  4. 12
  5. 13
  6. Arch

Author

Alexander Larsson <[email protected]>

Developer

From xdg-user-dirs 0.20-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.