Giter Club home page Giter Club logo

installdebloater's Introduction

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

installdebloater's People

Contributors

ev3rgr33n avatar neatodev avatar patrxgt avatar thisnekoguy avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

installdebloater's Issues

Assassins Creed 1 - Bloat

Default Size is 6.73 GB.
Has a Support folder with 2 folders inside: Manual 3.44 MB and Readme 12 KB.
Saves 3.45 MB;
Has a DirectX folder 66.7 MB saved;
There's a Manual folder that takes up 4.10 MB;
Has a Readme folder 60 KB.
Has a Register folder 948 KB.
Has a Support folder with 2 folders inside: Manual 3.44 MB and Readme 12 KB.
Saves 3.45 MB;
-Everything from above is 75.2 MB

Additionally there's a Videos folder with 5 videos, total is 152 MB.
Demo Intro isn't really needed after say the first time you see it and it's size is 143 MB.

After leaving Loading Screen + logo/presents and disclaimer, size of the game is 6.51 GB.
From 6.73 GB to 6.51 GB

inMomentum - Bloat

Has a Redist folder that is 148 MB. Makes 774 MB game size into 625 MB

Prototype 1 - Bloat

Prototype 1 has DirectX folder - 88.9 MB; Docs - 191 KB; and a vcredist_x86.exe - 2.59 MB. Total saved 91.7 MB

Grand Theft Auto V - bloat

Errorcodes in x64/data folder (american not included) - 200 KB
Errorcodes in update\x64\data folder (american not included) - 356 KB
Installers folder - 208 MB
total should be like 209MB saved

Grand Theft Auto IV - Bloat

Game is 22.4 GB.
Has a 208 MB "Redistributables" folder for Rockstar Launcher and Social Club Setup.
Also has Manuals folder that's 35.7 MB in size.
Has yet another Redistributables folder inside the GTAIV folder.
It takes up 196 MB of space, has same launchers.
Game now takes up 22.0 GB

L.A Noire - Bloat

has two folders Redistributables (that has SC/RL -208 MB) &
Installers (that has SC/RL + VCRed/DirectX stuff - 298 MB) in total saving 507 MB.

there's also 6 txt readme's that are about 104 KB

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.