Skip to content

Environment ‐ Building Temp_Cleaner GUI from source

Jump to bottom
Ziad edited this page Jun 10, 2025 · 2 revisions

Setting up the environment

This will be a precise step by step guide on how to prepare your work environment to build Temp_Cleaner GUI from source into a final executable that can be executed/ran on Computers without Python installed.

Hardware Requirements

To be able to build Temp_Cleaner GUI from source, your PC has to meet at least these system requirements:

  • If you are building for Windows:

    • CPU (Processor): An x86_64 (64-bit) Dual-Core CPU running at 2.3 GHz or higher.
    • RAM (System Memory): At least 4GB of RAM, although I recommend that you have at least 8 GB of RAM.
    • Free Space: At least 1 GB of free disk space for storing the cloned repository, build temporary files, and the compiled binary alongwith all its files.
    • Internet Access: You will need it to clone the repository, install Python 3.9+, download and install the required dependencies, and probably asking for help in case something goes wrong.
    • Screen Resolution: must be at least 1024x768

  • If you are building for GNU/Linux:

    • CPU (Processor): An x86_64/arm64 (64-bit, or AArch64) Dual-Core CPU running at 2.3 GHz or higher.
    • RAM (System Memory): At least 4GB of RAM, although I recommend that you have at least 8 GB of RAM.
    • Free Space: At least 1.5 GB of free disk space for storing the cloned repository, build temporary files, and the compiled binary alongwith all its files.
    • Internet Access: You will need it to clone the repository, install Python 3.9+, download and install the required dependencies, and probably asking for help in case something goes wrong.
    • Screen Resolution: must be at least 1024x768

TL;DR: Most PCs today will meet these requirements already.

Installing required dependenices

To build Temp_Cleaner GUI from source you have to install all of the following required dependencies (libraries, tools, and modules):

  • Python 3.9 or newer

  • Python3 pip (Python package manager)

    • Chances are really high that you already have that installed if you used the default configuration while installing Python on your Windows PC.

    • If you are running GNU/Linux, You may need to install the package python3-pip using your distro's default package manager, for example on ubuntu it is sudo apt install python3-pip

  • Python's Tkinter UI Framework

    • If you are on Windows and you used the default install configuration this will come pre-installed by default.

    • If you are running GNU/Linux, You may need to install the package manually, it will be called python3-tk on ubuntu for example, use your distro's package manager to install that.

  • Pyinstaller (Required as a tool for building Temp_Cleaner GUI)

    • Can be obtained on Windows by running pip install pyinstaller, on GNU/Linux it can be installed by running sudo pip3 install pyinstaller

    • On some linux distributions you may find it as a normal package in your distro's package manager if you can't install it using pip.

    • You may also want to use auto-py-to-exe if you prefer using a Graphical Interface instead of the default Command Line Interface that pyinstaller only provides.

  • Some code editor or IDE

    You will need that later, just trust me.

  • Some other dependencies that will be installed via pip

    pip install AwesomeTkinter colorama customtkinter darkdetect packaging pefile Pillow==9.5.0 psutil pyinstaller-hooks-contrib pywin32 requests tkinterweb urllib3
    • If it says "Requirement already satisfied" or "Package not found" then the packages are already installed.
    • If you can't download then try disabling IPv6 on your Network Adapter settings.
    • You may have to replace pip with pip3 if you are on GNU/Linux (DO NOT use sudo in this case).

  • git

    • Download it from the link provided if you are on Windows, if you are on GNU/Linux, then install the package git using your distro's package manager.

Cloning the repository & Preparing the Working directory

  • Create a folder to store the source code of Temp_Cleaner GUI in (for example we will create folder tcg_src in C:\

    C:
cd \
mkdir tcg_src
cd tcg_src

    If you are on GNU/Linux, simply do: (This will create a folder called tcg_src in the home directory)

    cd ~
mkdir tcg_src
cd tcg_src

  • Next, Clone the official repository for Temp_Cleaner GUI:

    git clone https://github.com/InsertX2k/temp_cleaner_gui .

    (This will clone the repository into the current directory)

  • Now, it's the time to run tests before actually starting the building process:

    This step is precisely explained in Running test script

Temp_Cleaner GUI's official GitHub Wiki - Download Temp_Cleaner GUI - Donate - Website

Clone this wiki locally