beets/docs/plugins/permissions.rst
2025-08-10 16:25:05 +01:00

24 lines
648 B
ReStructuredText

Permissions Plugin
==================
The ``permissions`` plugin allows you to set file permissions for imported music
files and its directories.
To use the ``permissions`` plugin, enable it in your configuration (see
:ref:`using-plugins`). Permissions will be adjusted automatically on import.
Configuration
-------------
To configure the plugin, make an ``permissions:`` section in your configuration
file. The ``file`` config value therein uses **octal modes** to specify the
desired permissions. The default flags for files are octal 644 and 755 for
directories.
Here's an example:
::
permissions:
file: 644
dir: 755