user-dirs.dirs(5)

user-dirs.dirs5

Settings for xdg user dirs

Overview

The $HOME/.config/user-dirs.dirs file is a text file that contains the user-specific values for the XDG user dirs. It is created and updated by the xdg-user-dirs-update command.

This file contains lines of the form

XDG_NAME_DIR=VALUE

The following names are recognised:

DESKTOP

DOWNLOAD

TEMPLATES

PUBLICSHARE

DOCUMENTS

MUSIC

PICTURES

VIDEOS

VALUE must be of the form "$HOME/Path" or "/Path".

Lines beginning with a # character are ignored.

The format of user-dirs.dirs is designed to allow direct sourcing of this file in shell scripts.

Environment

XDG_CONFIG_DIRS

The user-dirs.defaults file is located in this directory. The default is /etc/xdg.

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.