PreferencesFilePaths(bpy_struct)

base class — bpy_struct

class bpy.types.PreferencesFilePaths(bpy_struct)

Default paths for external files

active_asset_library

Index of the asset library being edited in the Preferences UI (in [-32768, 32767], default 0)

Type:

int

animation_player

Path to a custom animation/frame sequence player (default “”, never None)

Type:

str

animation_player_preset

Preset configs for external animation players (default 'INTERNAL')

  • INTERNAL Internal – Built-in animation player.

  • DJV DJV – Open source frame player.

  • FRAMECYCLER FrameCycler – Frame player from IRIDAS.

  • RV RV – Frame player from Tweak Software.

  • MPLAYER MPlayer – Media player for video and PNG/JPEG/SGI image sequences.

  • CUSTOM Custom – Custom animation player executable path.

Type:

Literal[‘INTERNAL’, ‘DJV’, ‘FRAMECYCLER’, ‘RV’, ‘MPLAYER’, ‘CUSTOM’]

asset_libraries

(default None, readonly)

Type:

AssetLibraryCollection[UserAssetLibrary]

auto_save_time

The time (in minutes) to wait between automatic temporary saves (in [1, 60], default 2)

Type:

int

file_preview_type

What type of blend preview to create (default 'AUTO')

  • NONE None – Do not create blend previews.

  • AUTO Auto – Automatically select best preview type.

  • SCREENSHOT Screenshot – Capture the entire window.

  • CAMERA Camera View – Workbench render of scene.

Type:

Literal[‘NONE’, ‘AUTO’, ‘SCREENSHOT’, ‘CAMERA’]

font_directory

The default directory to search for loading fonts (default “”, never None, blend relative // prefix supported)

Type:

str

i18n_branches_directory

The path to the ‘/branches’ directory of your local svn-translation copy, to allow translating from the UI (default “”, never None)

Type:

str

image_editor

Path to an image editor (default “”, never None)

Type:

str

recent_files

Maximum number of recently opened files to remember (in [0, 1000], default 200)

Type:

int

render_cache_directory

Where to cache raw render results (default “”, never None, blend relative // prefix supported)

Type:

str

render_output_directory

The default directory for rendering output, for new scenes (default “”, never None, blend relative // prefix supported)

Type:

str

save_modified_images

How modified images should be handled when saving the .blend file (default 'ASK')

  • ASK Ask Every Time – Show dialog to save modified images when saving the .blend file.

  • ALWAYS_SAVE Always Save – Always save modified images when saving the .blend file.

  • NEVER_SAVE Never Save – Never save modified images when saving the .blend file.

Type:

Literal[‘ASK’, ‘ALWAYS_SAVE’, ‘NEVER_SAVE’]

save_version

The number of old versions to maintain in the current directory, when manually saving (in [0, 32], default 1)

Type:

int

script_directories

(default None, readonly)

Type:

ScriptDirectoryCollection[ScriptDirectory]

show_hidden_files_datablocks

Show files and data-blocks that are normally hidden (default True)

Type:

bool

show_recent_locations

Show Recent locations list in the File Browser (default True)

Type:

bool

show_system_bookmarks

Show System locations list in the File Browser (default True)

Type:

bool

sound_directory

The default directory to search for sounds (default “”, never None, blend relative // prefix supported)

Type:

str

temporary_directory

The directory for storing temporary save files. The path must reference an existing directory or it will be ignored (default “”, never None)

Type:

str

text_editor

Command to launch the text editor, either a full path or a command in $PATH. Use the internal editor when left blank

(default “”, never None)

Type:

str

text_editor_args

Defines the specific format of the arguments with which the text editor opens files. The supported expansions are as follows:

$filepath The absolute path of the file. $line The line to open at (Optional). $column The column to open from the beginning of the line (Optional). $line0 & column0 start at zero. Example: -f $filepath -l $line -c $column

(default “”, never None)

Type:

str

texture_cache_directory

The directory for storing tx files generated from image files, for more efficient rendering. Paths may be absolute, or relative to the image file. Leave blank to store tx files in the same directory as image files (default “”, never None, blend relative // prefix supported)

Type:

str

texture_directory

The default directory to search for textures (default “”, never None, blend relative // prefix supported)

Type:

str

use_auto_save_temporary_files

Automatic saving of temporary files in temp directory, uses process ID. Warning: Sculpt and edit mode data won’t be saved

(default True)

Type:

bool

use_extension_online_access_handled

The user has been shown the “Online Access” prompt and made a choice (default False)

Type:

bool

use_file_compression

Enable file compression when saving .blend files (default True)

Type:

bool

use_filter_files

Enable filtering of files in the File Browser (default True)

Type:

bool

use_load_ui

Load user interface setup when loading .blend files (default True)

Type:

bool

use_relative_paths

Default relative path option for the file selector, when no path is defined yet (default True)

Type:

bool

use_scripts_auto_execute

Allow any .blend file to run scripts automatically (unsafe with blend files from an untrusted source) (default False)

Type:

bool

use_tabs_as_spaces

Automatically convert all new tabs into spaces for new and loaded text files (default True)

Type:

bool

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References