Section: User Commands (1)
Return to Main Contents
xdg-user-dirs-update - Update XDG user dir configuration
xdg-user-dirs-update [OPTION...] [--set NAME PATH...]
updates the current state of the users
user-dirs.dir. If none existed before then one is created based on the system default values, or falling back to the old non-translated filenames if such directories exists. The list of old directories used are:
If an old configuration exists it is updated with any new default directories. Additionally, any configured directories that point to non-existing locations are reset by pointing then to the users home directory. This typically happens when the users removed the directory, so they likely don't want to use it anymore.
On the first run a
file is created containing the locale that was used for the translation. This is used later by gui tools like
to detect if the locale was changed, letting you to migrate from the old names.
xdg-user-dirs-update is normally run automatically at the start of a user session to update the XDG user dirs according to the users locale.
The following options are understood:
Print help output and exit.
user-dirs.dir, but force a full reset. This means: Don't reset nonexisting directories to HOME, rather recreate the directory. Never use backwards compatible non-translated names. Always recreate
Write the configuration to
instead of the default configuration file. Also, no directories are created.
--set NAME PATH
Sets the XDG user dir with the given name.
should be one of the following:
must be an absolute path, e.g.
The XDG user dirs configuration is stored in the
file in the location pointed to by the
environment variable determines where the
file is located.
- SEE ALSO