Settings · cpmm

Settings live in ~/.local/share/cpmm/settings.json and are shared by the CLI and the GUI’s Settings page. Every key has a default, so the file only needs what you change.

cpmm settings                                     # show all
cpmm settings set auto_sort off                   # booleans take on/off
cpmm settings set staging_dir ~/Games/cpmm-mods   # moves your installed mods there
cpmm settings reset [key]

Group	Key	Default	What it does
Updates	`check_updates_on_start`	on	Check for mod updates when cpmm starts
	`auto_install_updates`	off	Install updates automatically, never while the game runs; undoable
	`refresh_minutes`	60	How often to look for updates
Load order	`auto_sort`	on	Re-sort after installs, updates, enabling and rollbacks
After installing	`after_install_verify`	off	Verify files against the Nexus manifest
	`after_install_doctor`	on	Run the doctor
	`after_install_command`	none	Run a command; it gets `CPMM_MOD_ID`, `CPMM_MOD_NAME` and `CPMM_MOD_VERSION`
Downloads	`auto_install_downloads`	off	Install new archives that appear in `watch_dir`
	`watch_dir`	`~/Downloads`	The folder to watch
	`keep_archives`	off	Keep downloaded archives after installing
Storage	`staging_dir`	in cpmm’s data directory	Where staged mods live
	`download_dir`	in cpmm’s data directory	Where downloads go
Profiles	`profiles_enabled`	on	Turn profiles on
	`new_profiles_own_saves`	off	New profiles get their own saves
Safety	`snapshot_saves`	on	Snapshot saves before risky changes
	`keep_versions`	3	Earlier versions kept per mod for rollback
	`keep_save_snapshots`	10	Save snapshots kept
Launching	`close_on_launch`	on	Close the GUI when the game launches

Environment variables

Variable	What it does
`CPMM_DATA`	Use a different data directory than `~/.local/share/cpmm`
`CPMM_OSK=0/1`	Force the Steam on-screen keyboard off or on in the Nexus browser
`CPMM_NEXUS_MEDIA=0/1`	Force media playback off or on in the Nexus browser