Configuration File

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/d05f97a9-a39b-4622-9bc7-8c62e0f3230a/alert.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/d05f97a9-a39b-4622-9bc7-8c62e0f3230a/alert.png" width="40px" /> Preferably use the pyRevit CLI to make configuration changes to this file.

</aside>

pyRevit configuration file is a standards INI file that contains various sections for each pyRevit component or tool.

The config file can be in one location only and that is %APPDATA%/pyRevit

Seed Config File

A Seed configuration file can be provided at %PROGRAMDATA%/pyRevit. pyRevit will use this seed file to configure pyRevit:

If the seed config file is Read-Only for the user, pyRevit will use this config file without recreating a new one under %APPDATA%/pyRevit No other configuration changes are allowed to the config file since the file is Read-Only.
If the seed config file is writable, then pyRevit will copy the seed into %APPDATA%/pyRevit and will start with this config file. All the future changes to the configs are written to the main config file and not the seed. The seed is used only to bootstrap the main config.

Core Configs

The most important section is the [core] that has all the runtime configurations.

[core]
checkupdates = false
autoupdate = false
verbose = true
debug = false
filelogging = false
startuplogtimeout = 0
bincache = true
userextensions = []
loadbeta = false
rocketmode = true
requiredhostbuild = ""
cpyengine = 372
minhostdrivefreespace = 0
outputstylesheet = "C:\\\\Users\\\\eirannejad\\\\Desktop\\\\gits\\\\pyRevitDev\\\\pyrevitlib\\\\pyrevit\\\\output\\\\outputstyles.css"
user_locale = "en_us"

The settings below control the availability of the Update, Extension Manager and Settings tools (UI buttons) in pyRevit. If set to false the tool will be removed from the UI and won’t be availabe to the user:

[core]
usercanupdate = true
usercanextend = true
usercanconfig = true

Environment Configs

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/d05f97a9-a39b-4622-9bc7-8c62e0f3230a/alert.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/d05f97a9-a39b-4622-9bc7-8c62e0f3230a/alert.png" width="40px" /> This section is exclusively for the CLI tool that manages the environment. DO NOT CHANGE SETTINGS MANUALLY

</aside>

[environment]
clones = {}