Using CCleaner.INI to modify how CCleaner runs

Change how CCleaner runs with CCleaner.INI:

This page focuses on CCleaner INI files and how to use them to change how CCleaner runs. For a detailed look at INI settings and functions, view the table further below. 

Note: This page's contents targets advanced users of our app and may require a certain level of technical knowledge and expertise.

CCleaner stores its settings in the Windows Registry:

If you want to change CCleaner's settings using scripting, you can tell CCleaner to store them in ccleaner.ini in CCleaner's program folder.

You can also change how CCleaner stores its settings.

Different INI settings and how these function:

Item

Description

Settings

(App)Program Name

These entries indicate programs that are not part of the default set of enabled Cleaning Rules, and whether they should be cleaned.

Note: Making an entry of "App(Your Program)]=true" will not allow CCleaner to clean it, as you would instead need to use the methods listed here.

True - Checkbox selected when you start CCleaner.

False - Checkbox cleared when you start CCleaner.

AutoClose

This closes CCleaner after cleaning.

0 - Disabled.

1 - Enabled.

BackupDir

This is the default path for Issues Registry backup.

 

BackupPrompt

This prompts you to back up the contents of proposed Registry Issues before you remove them.

0 - Disabled.

1 - Enabled.

BrowserMonitoring

This is whether or not automatic browser cleaning is active (CCleaner Professional).

0 - Disabled.

1 - Enabled. 

CookiesToSave

This lists cookies you have chosen to keep.

 

DefaultDetailedView

This is a detailed view screen (for the whole analysis or cleaning) after the operation finishes.

0 = Disabled.

1 = Enabled.

IncludeX (e.g. Include1, Include2)

These are custom files or folders that you have specified you want cleaning.

[PATH|FILE]|Path|Filename

ExcludeX (e.g. Exclude1, Exclude2)

These are custom files or folders that you want to exclude from all cleaning.

[REG|PATH|FILE]|Path|Filename

FinderIncludeX (e.g. FinderInclude1, FinderInclude2)

These are drives or folders CCleaner uses when searching for duplicate files.

PATH|PATH\|Filetype|[RECURSE]

FinderIncludeStates

This is whether the checkboxes have been checked or unchecked for folders referenced by FinderIncludeX above.

0 - Cleared

1 - Selected

For example, if there are three FinderIncludeX statements, you can specify the checked/cleared status using the pipe symbol:

FinderIncludeStates=1|0|1 would check the first and last items, and the middle one would be unchecked.

DelayTemp

If enabled, CCleaner will only delete temporary Windows files older than 48 hours.

0 - Disabled.

1 - Enabled.

HomeScreen

This is whether CCleaner starts on Health Check or Custom Clean

0 - Custom Clean

1 - Health Check

HideWarnings

If enabled, CCleaner displays no warnings when you select advanced items in the cleaning options tree.

0 - Disabled.

1 - Enabled.

IEDetailed

If enabled, CCleaner displays a detailed log of Internet Explorer temporary files.

0 - Disabled.

1 - Enabled.

FFDetailed

If enabled, CCleaner displays a detailed log of Firefox/Mozilla temporary files.

0 - Disabled.

1 - Enabled.

Language

This indicates which language file CCleaner should use when opening.

For a list of locale IDs, see this article. For a list of CCleaner's supported languages, see this topic.

MinimizeSystemTray

If enabled, CCleaner will be minimized to the system tray when you click the Close button.

0 - Disabled.

1 - Enabled.

Monitoring

This is whether Smart Cleaning is enabled or not.

0 - Disabled

1 - Enabled

MSG_CONFIRMCLEAN

CCleaner asks you to confirm the Cleaning operation.

True - the checkbox is selected when CCleaner starts.

False - the checkbox is cleared when CCleaner starts.

MSG_WARNMOZCACHE

When you choose to clean the Internet Cache in Mozilla Firefox, a warning message appears.

True - the checkbox is selected when CCleaner starts.

False - the checkbox is cleared when CCleaner starts.

MSG_WARNCHROMECACHE

When you select Internet Cache in Google Chrome to clean it, a warning message appears.

True - the checkbox is selected when CCleaner starts.

False - the checkbox is cleared when CCleaner starts.

RunICS

No longer used by CCleaner, will automatically be set to 0 when you run it.

 

SystemMonitoring

Whether or not System Smart Cleaning is active or Active Monitoring is active for the system (CCleaner Professional).

0 - Disabled.

1 - Enabled. 

SystemMonitoringSavingsAction

If System Smart Cleaning system monitoring is active (see above), CCleaner uses the default action (CCleaner Professional).

3 - prompt to clean.

4 - auto clean with notification.

5 - auto clean without notification.

UpdateBackgroundCheck

This means CCleaner checks for software updates every 10 minutes or when it starts.

0 - Disabled

1 - Enabled

SecureDeleteType

If enabled, CCleaner uses a secure deletion method (see below).

0 - Disabled

1 - Enabled

SecureDeleteMethod

If SecureDeleteType is set to 1, this setting determines which secure deletion method CCleaner uses.

0 - Simple Overwrite (1 pass)

1 - DOD 5220.22-M (3 passes)

2 - NSA (7 passes)

3 - Gutmann (35 passes)

UPDATEKEY

The date and time CCleaner last checked for an update.

Do not modify.

WINDOW_HEIGHT, WINDOW_LEFT, WINDOW_MAX, WINDOW_TOP, WINDOW_WIDTH

These are settings representing CCleaner's window position.

Do not modify.

WipeMFTFreeSpace

This is whether the Wipe Free Space setting wipes free space in the Master File Table.

0 - Disabled

1 - Enabled



Was this article helpful?

Need to find your product license key?

Go to our license lookup page and enter your registered email address to retrieve info about your products, including product download links, license key(s), and expiry dates.

Send me my license details

Articles in this section