doc/BCU_manual.html
|
|
Bulk Crap
Uninstaller
Documentation
|
Table of Contents
|
[1 Introduction](# RefHeading_ Toc345_1601368371)
| |
[1.1 System Requirements](# RefHeading_ Toc1171_379548938)
| |
[2 Main Window](# RefHeading_ Toc109_1595950343)
| |
[2.1 Application List](# RefHeading_ Toc219_1595950343)
| |
[2.1.1 Highlight Colors](# RefHeading_ Toc221_1595950343)
| |
[2.1.2 Certificates and verification](# RefHeading_ Toc223_1595950343)
| |
[2.1.3 User rating](# RefHeading_ Toc225_1595950343)
| |
[2.2 Left sidebar](# RefHeading_ Toc227_1595950343)
| |
[2.3 Treemap](# RefHeading_ Toc866_3080419501)
| |
[2.4 Functions](# RefHeading_ Toc229_1595950343)
| |
[2.4.1 Uninstall / Uninstall quietly](# RefHeading_ Toc233_1595950343)
| |
[2.4.2 Uninstall using MsiExec / Windows Installer](# RefHeading_ Toc235_1595950343)
| |
[2.4.3 Uninstall manually](# RefHeading_ Toc237_1595950343)
| |
[2.4.4 Clean up “Program Files” folders](# RefHeading_ Toc239_1595950343)
| |
[2.4.5 Find by window](# RefHeading_ Toc244_1595950343)
| |
[2.4.6 Uninstall Windows Features](# RefHeading_ Toc241_1595950343)
| |
[3 Application properties](# RefHeading_ Toc246_1595950343)
| |
[3.1 Missing uninstaller](# RefHeading_ Toc248_1595950343)
| |
[3.2 Unregistered application](# RefHeading_ Toc250_1595950343)
| |
[3.3 Protected](# RefHeading_ Toc252_1595950343)
| |
[3.4 Store App](# RefHeading_ Toc254_1595950343)
| |
[3.5 System component](# RefHeading_ Toc256_1595950343)
| |
[3.6 Update](# RefHeading_ Toc258_1595950343)
| |
[4 Settings](# RefHeading_ Toc260_1595950343)
| |
[4.1 Uninstallation](# RefHeading_ Toc262_1595950343)
| |
[4.1.1 Concurrent uninstallation](# RefHeading_ Toc264_1595950343)
| |
[5 Advanced copy to clipboard](# RefHeading_ Toc341_1601368371)
| |
[6 Advanced filtering / Uninstall lists](# RefHeading_ Toc343_1601368371)
| |
[6.1 Enabling advanced filtering](# RefHeading_ Toc385_1375324043)
| |
[6.2 Filters](# RefHeading_ Toc387_1375324043)
| |
[6.3 Conditions](# RefHeading_ Toc389_1375324043)
| |
[6.3.1 Comparison methods](# RefHeading_ Toc391_1375324043)
| |
[6.3.2 Target property](# RefHeading_ Toc393_1375324043)
| |
[6.4 Saving and loading filters in .bcul files](# RefHeading_ Toc1266_3965964108)
| |
[7 Uninstallation](# RefHeading_ Toc556_354986082)
| |
[7.1 Loud / Quiet uninstallers](# RefHeading_ Toc558_354986082)
| |
[7.2 Preparations](# RefHeading_ Toc560_354986082)
| |
[7.2.1 Process kill window](# RefHeading_ Toc572_354986082)
| |
[7.3 Uninstall progress window](# RefHeading_ Toc574_354986082)
| |
[7.3.1 Manual controls, dealing with stuck uninstallers](# RefHeading_ Toc562_354986082)
| |
[7.3.2 Aborting the entire uninstall task](# RefHeading_ Toc564_354986082)
| |
[7.4 Leftover / Junk removal](# RefHeading_ Toc566_354986082)
| |
[7.4.1 Confidence](# RefHeading_ Toc568_354986082)
| |
[7.4.2 Backup](# RefHeading_ Toc570_354986082)
| |
[8 Custom rules, Scripts and Tweaks](# RefHeading_ Toc1173_379548938)
| |
[8.1 Specification of Script files](# RefHeading_ Toc1175_379548938)
| |
[8.1.1 Example script file (remove-onedrive.xml)](# RefHeading_ Toc1177_379548938)
| |
[8.1.2 Standard elements](# RefHeading_ Toc1179_379548938)
| |
[8.1.3 Acceptable values](# RefHeading_ Toc1181_379548938)
| |
[8.1.4 Special elements](# RefHeading_ Toc1183_379548938)
| |
[9 Command line options](# RefHeading_ Toc522_1610471585)
| |
[9.1 BCUninstaller.exe](# RefHeading_ Toc524_1610471585)
| |
[9.2 BCU-console.exe](# RefHeading_ Toc918_3487566792)
| |
[9.3 StoreAppHelper.exe](# RefHeading_ Toc526_1610471585)
| |
[9.4 SteamHelper.exe](# RefHeading_ Toc767_1317069549)
| |
[9.5 OculusHelper.exe](# RefHeading_ Toc939_3737477262)
| |
[9.6 UninstallerAutomatizer.exe](# RefHeading_ Toc769_1317069549)
|
Bulk Crap Uninstaller (or BCUninstaller) is a free (as in speech) program uninstaller. It excels at removing large amounts of applications with minimal user input. It can clean up leftovers, detect orphaned applications, run uninstallers according to premade lists, and much more!
BCU is fully compatible with Windows Store Apps, Steam, Windows Features and has special support for many uninstalling systems (NSIS, InnoSetup, Msiexec, and many other). Check below for a full list of functions.
Bulk Crap Uninstaller is licensed under Apache 2.0 open source license, and can be used in both private and commercial settings for free and with no obligations, as long as no conditions of the license are broken.
Official website and a contact form can be found at https://www.bcuninstaller.com/
Get the latest version or view the code at https://github.com/Klocman/Bulk-Crap-Uninstaller
•OS: Windows Vista or newer is recommended. BCU will also work on XP and 2003 with reduced functionality and possibly some bugs. Both 32bit and 64bit versions are supported.
•.NET: Recommended .NET 4.0 or newer, can run on only .NET 3.5 with reduced functionality.
•RAM: Around 300MB or more of free RAM.
•CPU: Doesn't really matter.
•Free space: 50MB or more.
•HDD: Anything will work, but slower drives will make scan times proportionally longer.
BCUninstaller needs administrator rights to start and function. They are needed to access some system functions during application scan, to uninstall applications and to delete leftovers. Some other functions might also need elevated permissions to function, therefore it’s not possible to run BCU with standard user permissions.
A list of applications that BCU managed to find in your system takes up most of the main window. The list can be sorted by the columns and filtered using options on the left.
By default, many items on the list have colored backgrounds according to their properties. Their meanings can be found in the Color legend in the bottom right corner. If the list is not visible, it can be enabled from the “View” menu.
Items with white backgrounds have no special properties.
BCU can read and verify certificates of uninstallers. Their details can be viewed in the properties window. This function not meant to indicate good or bad applications, use it only as a hint.
Verified certificate means that the executable is guaranteed to not have been modified in any way since leaving its publisher.
The following can cause a certificate to fail verification:
•It was impossible to verify the certificate because of invalid root certificates or no internet connection.
•At some point the executable has been modified in some way. This is normal for Windows Installer (MSI/MsiExec) uninstallers – they are modified by the system to save disk space.
•The certificate has been self-signed and is therefore impossible to verify.
•The signed file has been modified/corrupted during its travel through the intertubes.
Most applications can be rated by users of BCU. The ratings are automatically synchronized with the statistics server. The rating can be between 0 and 4 stars, color of the stars corresponds to their number.
If the stars are black, it means that they represent your own vote instead of the user average. You can hover over the stars to see the average rating.
Settings Sidebar contains mostly filtering options for the application list. It can be hidden from the “View” menu.
Search box is the same as a condition used in advanced filtering, check 6.3 Conditions for more information.
If Advanced filtering is enabled, the sidebar is automatically hidden.
At the bottom of the application, just above the status bar, you should see a bunch of colored tiles. This is a treemap – a visual representation of all the applications currently visible on the list.
The size of the square is based on application’s estimated size. If an application doesn’t have an estimated size, it will not be shown. The tiles are scaled using a non-linear algorithm - size differences will appear smaller than they really are.
You can hover over the treemap, and the application currently under cursor will be shown below. You can click and right-click on any of the tiles to open context menu, and left-click to select the applications. It works the same as the main list. Selected tiles will change color to the selection color.
Begins uninstallation of selected applications. Quiet uninstallation means that you do not have to click anything – the process is automatic. If it is impossible to quietly uninstall some items, a dialog will be shown with ability to remove the “loud” uninstallers from the selection.
If the application has a Product code / GUID attached to it you can try using MsiExec to uninstall it. It is not guaranteed to work on all applications.
Skips running the uninstaller (if it is available) and instead gives a list of files and registry keys that you can choose to delete manually.
It is not recommended to use this method unless it is impossible to uninstall the application in any other way.
Search all folders that are defined as default installation locations (usually only the Program Files folders) for leftovers. This includes empty folders and partially uninstalled applications. You will be given a choice of items to remove.
Opens a small tool window. Drag and drop the cross over a window you want to scan. BCU will try to find the application that owns the specified window and show it on the list.
Scan the system for installed Windows Features and add them to the application list. They are treated as normal applications after that point and can be uninstalled in bulk. The scan can take a while.
Some properties are displayed as background colors, check 2.1.1 Highlight Colors for more information.
Additional information not displayed on the list is available in the properties window.
The application is registered in the system registry, but its uninstaller is either corrupted or missing. It will have to be removed manually.
The application is not registered in the system registry, but is present on the drive. If the application still has a working uninstaller, BCU can often manage to find it and let you run it. If the uninstaller is not found, BCU will automatically generate a simple uninstaller.
The application is marked as protected in system registry. This is often used to indicate that it is a part of another package, or is required by other applications.
The new Windows 10 – styled applications are all called Store Apps, even if they do not come from Windows Store. They normally require a completely different method of removal, but BCU presents them as normal applications.
The application is marked to be important in some way to your system. Drivers and parts of bigger software packages are often marked as system components to hide them from the user. They are not actually required by the operating system.
Means that the item is an update to another application, or the OS. Uninstalling the actual application will usually remove all related updates automatically.
Settings are automatically applied and saved on application exit. It is possible to reset settings to their defaults by “Help\Reset settings” menu option, or by removing the “BCUninstaller.settings” file in BCU's directory.
•Prevent shutdown/restart will attempt to stop uninstallers from restarting the system.
•Intelligent uninstaller sorting will sort applications during bulk uninstallation to speed up the process. It will place loud uninstallers first so you can leave the computer earlier.
•Disable protection will stop blocking protected applications from being uninstalled.
•Turning Simulate uninstallation on will prevent BCU from uninstalling or removing anything from your system.
Concurrent uninstallation is an experimental feature that will schedule multiple uninstallers to be ran at the same time. It will do its best to prevent any collisions and sometimes this functionality will be completely unavailable.
It is not recommended to run more than 2 uninstallers at the same time unless you are using a fast SSD.
You can manually force uninstallers to run concurrently from the bulk uninstall window. Doing so will still be tested for collisions, but the check can be disabled (not recommended).
The pattern is a Composite Format String. It is automatically processed when written.
To enable use of escaped characters (\r, \t, \n, etc.) enable the “Unescape” check-box. It will convert any escaped characters to their unescaped form.
To insert a newline add “\r\n” (standard newline on Windows) to the pattern and enable “Unescape“. You should see the newline appear in the Results box.
The combo box contains all available variables that can be added to the pattern. Selecting one of the variables will automatically paste it at cursor position.
Advanced filtering can be enabled by clicking the “Advanced button” on the sidebar or by opening an existing uninstall list from the “File” menu.
If an uninstall list is loaded, its path is displayed in the application's title bar.
When advanced filtering is enabled, all basic filtering settings are ignored.
Filters are displayed in the “Filter list”. Each filter can contain multiple conditions.
It is possible to add filters from an existing uninstall list by the option on the toolbar. New filters are appended to the end of the list.
If the filter's type is set to include, it will only allow applications that match all of its conditions to appear on the list. They are executed before the exclude filters.
If the type is set to exclude, the filter will remove all applications that match all of its conditions from the list. They override the include filters.
If there are only exclude filters all applications are automatically included.
For a filter to match an application all of its conditions must match it. If any of the conditions fails to match the application the entire filter fails the match.
The filter text is compared against target property using selected comparison method. The result of the comparison can be optionally inverted (negated).
•Contains – Property contains the entire filter text.
•Contains any – Property contains any of the words in the filter text. They are separated by spaces.
•Equals – Property is exactly the same as the filter text.
•Starts with / Ends with – Property either starts or ends with the filter text.
•Regex – Filter text is matched to the property using a Regex engine. Regexonline manual.
Property of the application that will be compared against. “All properties” will try to match the filter text to any of the available properties.
The properties can be previewed by viewing properties of the applications.
.bcul files (also called “advanced filter lists” or “uninstall lists”) are used to store advanced filters information for later use. You can save your set of filters into a .bcul file that you can later use with the command line tool to automatically uninstall all applications that are matched by your filters.
To save a .bcul file, first open the Advanced filtering panel, specify your filters, and click on the “Save as…” button in the toolbar above the filter list. You should see a save file dialog with the .bcul extension.
To load a .bcul file, either click “File” > “Open Uninstall List…”, or open Advanced filtering panel and click on the “Open…” toolbar item.
To use a .bcul file with the command line tool to automatically uninstall applications (for example in a script), check the [BCU-console.exe](# RefHeading_ Toc918_3487566792)[parameter list](# RefHeading_ Toc918_3487566792).
BCU can uninstall single applications or multiple applications at the same time. To uninstall, select applications that you want to uninstall in the main list (you can select multiple by holding shift or control), and then click on the Uninstall / Uninstall Quietly button on the toolbar above or right click on your selection and select Uninstall / Uninstall Quietly in the context menu.
If you uninstalled any applications that were integrated into the system (e.g. drivers, extensions, antiviruses) then you should reboot the PC after BCU finishes uninstalling to make sure everything gets fully removed (some uninstallers continue to run after a reboot, while in other cases Windows is still using some of the files so they have to be removed on the next system boot).
There are two ways to uninstall an application – loud and quiet.
•Loud uninstallation refers to an uninstaller that requires user to go click through a few screens (by clicking on buttons like “Next”, “Finish”, etc.) to finish the uninstallation.
•Quiet uninstallation on the other hand requires no user input to complete. Because of this they are much easier to handle and faster to complete.
BCU is capable of generating quiet uninstallers for many applications using many techniques (e.g. UI automation).
After clicking on any of the Uninstall buttons you might be asked a few questions, most notably:
•If loud uninstallers should be removed from a quiet task.
•If protected items should be removed from the task (only if protection is enabled in settings).
•If BCU should create a System Restore point before running the task.
•If BCU should terminate applications that might interfere with running the task (see below).
The above window is shown if there are any running applications that might be using files that will be uninstalled in the task. It is recommended to close all of them, but false positives are possible – keep an eye out to avoid losing opened work.
The Uninstall progress window will appear to display progress of the uninstallation after the configuration. Uninstallers are grouped in following categories:
•Uninstalling – The uninstaller is running at this very moment. Multiple uninstallers can run at once if they are not colliding with each other. This behavior can be changed in the settings.
•Waiting – The uninstaller is waiting to be executed.
•Completed – The uninstaller appears to have completed successfully.
•Failed – The uninstaller failed to run or complete. If possible a reason for the failure is provided.
•Skipped – The uninstaller has been skipped by the user. If possible uninstallers closed by the “Cancel” button are put in this category.
By selecting an uninstaller on the list user can use functions located on the toolbar above.
•Run uninstaller now – Force the uninstaller to run now. By default, BCU will check if the uninstaller will collide with already running uninstallers before executing it. This safety check can be disabled in the settings.
•Skip – Do not execute the uninstaller. If the uninstaller is already running BCU will stop waiting for it.
•Terminate – Do not execute the uninstaller. If the uninstaller is already running BCU will terminate it before continuing.
At any point it is possible to abort the uninstall task by clicking “Cancel” or attempting to close the window. BCU will ask for confirmation before skipping all the remaining uninstallers.
Already running uninstallers are not closed, BCU will wait for them to complete. If the remaining uninstallers are stuck it might be necessary to manually skip or terminate them.
Once the uninstallation is completed BCU will ask to search for leftovers. If any are found, the above window will be displayed.
It is possible to open locations of the items and view their details through their context menus.
Export will only save data visible in the window (item paths, confidence ratings, etc.). This is not a backup tool.
All items are given a “Confidence” rating. The higher the confidence, the safer it is to remove an item. By default, only items of at least Good confidence are selected.
It is possible to show items with Bad confidence, but removing them is dangerous and recommended only for experienced users.
BCU will ask to create a backup of the registry entries before removing them.
Files and folders are moved to the recycle bin. If the recycle bin is disabled or has not enough capacity the items are removed permanently.
Starting with BCU version 4.9 it’s possible to add custom detection rules (from now on referred to as “Scripts”) that will create custom entries on the application list. This allows end-user to add custom rules to their installation of BCU and to later automate them.
Scripts are placed in the Resources\Scripts folder inside of BCU’s installation directory and have .xml extensions. They can be placed in subfolders.
System Tweaks introduced in version 4.9 are implemented as scripts and can be used as examples.
Scripts are simple .xml files that contain information necessary to create a new entry on the application list, as well as an optional condition.
<script>
<ConditionScript>remove-onedrive_check.ps1</ConditionScript>
<Script>remove-onedrive.ps1</Script>
<DisplayName>OneDrive</DisplayName>
<Publisher>Microsoft Corporation</Publisher>
<RatingId>OneDrive</RatingId>
<AboutUrl>https://onedrive.live.com/\</AboutUrl>
<InstallLocation>Registry::HKEY_CURRENT_USER\SOFTWARE\Microsoft\OneDrive\CurrentVersionPath</InstallLocation>
<DisplayVersion>Registry::HKEY_CURRENT_USER\SOFTWARE\Microsoft\OneDrive\Version</DisplayVersion>
<DisplayIcon>Registry::HKEY_CURRENT_USER\SOFTWARE\Microsoft\OneDrive\OneDriveTrigger</DisplayIcon>
</script>
Most properties of the ApplicationUninstallerEntry class, for example DisplayName, InstallLocation, can be assigned by creating an element with the property’s name.
To get a list of available element names with example values, open BCU and select File>Export, or right click on any application in the list and open Advanced Clipboard Copy. You can also check the source code.
Most elements can take an arbitrary constant string. It will be copied as-is to the entry on the application list, unless it’s invalid in some way.
If the value starts with “Registry::”, it will be treated as a full registry path to a value. The pointed value will be read from the registry and used instead of the registry path.
For example, using Registry::HKEY_CURRENT_USER\SOFTWARE\Microsoft\OneDrive\CurrentVersionPath in the InstallLocation element will cause BCU to read the value named CurrentVersionPath from registry key named HKEY_CURRENT_USER\SOFTWARE\Microsoft\OneDrive, and put its contents into the InstallLocation property.
•Script - path to a PowerShell script file that will be executed when this entry is “uninstalled”. It overrides UninstallString and QuietUninstallString elements. The path is relative to the .xml file. Either Script or UninstallString has to be assigned.
•ScriptArgs – optional arguments to be passed to the above script.
•ConditionScript – path to an optional PowerShell script that will be executed to see if this entry should be displayed. If the script returns error code 0, the entry will be displayed. If anything else than 0 is returned, the entry will not be displayed on the application list. The path is relative to the .xml file.
•ConditionScriptArgs - optional arguments to be passed to the above script
•SystemIcon – optional name of one of the .Net SystemIcons icons. It overrides the DisplayIcon element.
List of valid command line options to BCUninstaller and its helpers.
BCUninstaller [drive:][path]filename
[drive:][path] – Specifies drive and directory of the uninstall list.
filename – Specifies filename of the uninstall list
BCUninstaller /sm – Start only the Startup Manager. Does not enumerate installed applications so it
starts much faster. If BCU is already running, this switch will be ignored and
the running instance will be focused. (You can also use /startupmanager)
BCU-console [help | /?] - Show help (this screen)
BCU-console uninstall [drive:][path]filename [/Q] [/U] [/V] [/J=<Level>] - Uninstall applications.
[drive:][path] – Specifies drive and directory of the uninstall list.
filename – Specifies filename of the .bcul uninstall list that contains information about.
what applications to uninstall.
BCU-console export [drive:][path]filename [/Q] [/U] [/V] - Export installed application data to xml file.
[drive:][path] – Specifies drive and directory to where the export should be saved.
filename – Specifies filename of the .xml file to save the exported application information to.
Switches:
/Q - Use quiet uninstallers wherever possible (by default only use loud).
/U - Unattended mode (do not ask user for confirmation). WARNING: ONLY USE AFTER
THOROUGH TESTING. UNINSTALL LISTS SHOULD BE AS SPECIFIC AS POSSIBLE TO AVOID.
FALSE POSITIVES. THERE ARE NO WARRANTIES, USE WITH CAUTION.
/J=<Level> - Attempt to clean up leftover "junk" (Registry entries and files/folders) after
uninstall. If no level is passed then defaults to "VeryGood". ***WARNING***: USE
EXTREME CAUTION WHEN CHOOSING ANY LEVEL BELOW VeryGood. THERE ARE NO WARRANTIES.
Valid levels are: VeryGood, Good, Questionable, Bad, Unknown
/V - Verbose logging mode (show more information about what is currently happening).
Return codes:
0 - The operation completed successfully.
1 - Invalid arguments.
1223 - The operation was canceled by the user.
Examples:
BCU-console uninstall “D:\Test\my_list.bcul” /Q /U
BCU-console export out.xml
StoreAppHelper /query
StoreAppHelper /uninstall FullName
query – Returns a list of installed Store Apps for current user.
uninstall – Uninstalls a single Store App specified by its FullName.
Return codes:
0 - The operation completed successfully.
1627 - An unexpected error occurred.
10022 - Invalid arguments.
SteamHelper u[ninstall] [/s[ilent]] AppID
SteamHelper i[nfo] AppID
SteamHelper l[ist]
SteamHelper steam
AppID - Steam application ID.
u[ninstall] - Uninstall a Steam app.
i[nfo] - Show info about a Steam app.
l[ist] - List Steam app ID's.
steam - Show Steam install location.
s[ilent] - Don’t prompt for any user input.
Return codes:
0 - The operation completed successfully.
59 - An unexpected error occurred.
1223 - The operation was canceled by the user.
10022 - Invalid arguments.
OculusHelper /query
OculusHelper /uninstall CanonicalName
query – Returns a list of installed Oculus Apps for current user.
uninstall – Uninstalls a single Store App specified by its CanonicalName.
Return codes:
0 - The operation completed successfully.
1627 - An unexpected error occurred.
10022 - Invalid arguments.
UninstallerAutomatizer UninstallerType [/K] UninstallCommand
UninstallerType - Type of the uninstaller, taken from UninstallerType enumeration. At the moment of writing only “Nsis” is supported.
K - Kill the uninstaller if automatic uninstallation failed.
UninstallCommand - Path to the target uninstaller with optional arguments.
Return codes:
0 - The operation completed successfully.
1627 - An unexpected error occurred.
10022 - Invalid arguments.