Skip to content

Save disk space by deleting unneeded components from your apps and games.

License

Notifications You must be signed in to change notification settings

Patrxgt/InstallDebloater

 
 

Repository files navigation

InstallDebloater - Saving the Bytes

What is it?

InstallDebloater is a commandline application that aims to reduce the total file size of applications and games without breaking them. We offer a constantly expanding list of curated, hand-crafted and tested templates that remove the clutter from your apps and games without impacting the core experience. It just saves space on your drives.

How does it work?

InstallDebloater works with templates. These templates contain one main .ini file, three optional .txt files and a .bat file to run the whole thing. The .ini file specifies which deletion methods are going to be used and the .txt files define which files and folders are going to get deleted.

What gets deleted?

It depends on the specific game or application. Sometimes we remove unused localization files or multiplayer components that had their servers shut down. Often times developers ship unused assets that bloat the installation size as well, we remove those too.

Ultimately, what gets deleted and what stays is very specific to that game or application, please check the next section for more information on templates.

Templates

In the 'templates' directory, you will find curated and tested configurations for games and applications that you can just download and run yourself. Every template that we provide has been thoroughly tested by EVERGREEN and myself.

Each template has its own unique and detailed README file that explains what it does.

Examples

In the first example, we manage to reduce the file size of Batman: Arkham Origins by over 40%. The template deletes unused localizations and outdated multiplayer components:

Origins

In the second example, we reduce the size of Resident Evil: Revelations 2 by 8,96%. In this case, we remove localization files (sounds, texts, menus...) that we do not use.

Rev2

Usage

  1. Download the latest release. The provided .exe file is needed for the process to work.
  2. (Batch Method) If you use a provided .bat file, make sure the folder structure is correct. And the .exe and INIFile are in the correct places relative to each other.
  3. (CMD Method) If you run the tool through the commandline, make sure to pass the full path relative to InstallDebloater.exe as an argument.
  4. Run it! (Execute .bat file/Run the command in CMD)

Donate

Custom Templates

While we provide curated and tested templates, you can also create your own.

First, you need an .ini file. The name does not matter, but it needs to be universal for all .txt files that depend on it (see structure). The contents of the .ini file need to look like this:

; This is an example for a comment. You can place comments anywhere.

[CORE]
ROOT=GAMEFOLDER
RELATIVE=true/false
NAMING_SCHEME=true/false
FOLDER=true/false

Once you've prepared your .ini file, you need sub-files that actually do the work. These sub-files all have the .txt format and are only needed if you set their value in .ini to true. They all follow identical formatting rules.

# This is an example for a comment. You can place comments anywhere.

dat\relative\example\file.txt

dat\folder\example\dir

naming_scheme.example
naming\scheme\folder.example

Important notice for Linux users: Yes, the back slashes will work. Only use forward slashes to set your root folder!

In the _RELATIVE.txt file, you specify FULL path to files that are RELATIVE to the root folder defined in the .ini file.

In the _FOLDER.txt file, you specify the FULL PATH to folders that are RELATIVE to the root folder defined in the .ini file. All files and sub-folders within that folder will get deleted too.

In the _NAMING_SCHEME.txt file, you specify certain naming schemes. Every file and folder (starting from root) will get scanned and matching files will get deleted. You can also provide a partial folder structure as long as it contains a target file.

The structure for all files is as follows:

Application.ini--|
                 |--Application_FOLDER.txt*
                 |--Application_NAMING_SCHEME.txt*
                 |--Application_RELATIVE.txt*

*Only required if the value is 'true' in the .ini file.

Contributing

We are happy to receive template contributions for apps and games that we do not currently support ourselves. If you would like to contribute and submit a Pull Request, please make sure that you follow the naming & formatting structure in the 'templates' folder. Please also make sure to only submit one application/game as a commit at a time.

License

License: GPL v3

About

Save disk space by deleting unneeded components from your apps and games.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 70.0%
  • Batchfile 28.5%
  • Shell 1.5%