FluxOptimizer

Advanced System Maintenance & Optimization Suite
Multi-Platform | 104 Languages | Professional Grade

Overview

FluxOptimizer is a professional-grade system maintenance and optimization suite designed to enhance system performance across Windows, Linux, and macOS platforms. Built with a modern dark-themed interface using CustomTkinter, it provides real-time system monitoring, intelligent cleanup algorithms, and comprehensive system optimization tools.

The application features automatic language detection based on system configuration, supporting 104 languages out of the box, making it accessible to users worldwide.

Features

Core Capabilities

Real-Time System Monitoring
- CPU load visualization with animated circular charts
- RAM usage tracking with percentage indicators
- Temporary files detection and size monitoring
- Live trend analysis with sparkline graphs
System Optimization
- Memory optimization and cache clearing
- Temporary files cleanup (system and application caches)
- Package cache management (apt, yum, pacman, Homebrew)
- Browser cache cleaning
Professional Interface
- Modern dark-themed UI with gradient effects
- Terminal-style logging console
- Animated buttons and interactive elements
- Responsive dashboard layout
Multi-Language Support
- Automatic language detection from system settings
- 104 supported languages via JSON translation files
- Easy language switching and customization

Platform-Specific Features

Feature	Windows	Linux	macOS
Memory Optimization	✅ `EmptyWorkingSet`	✅ `purge` / `drop_caches`	✅ `purge` command
Registry Cleaning	✅	❌	❌
Temp File Cleanup	✅	✅	✅
Package Cache Clean	❌	✅ (apt/yum/pacman)	✅ (Homebrew)
Admin Elevation	✅ Auto	✅ sudo required	✅ sudo required

System Requirements

Minimum Requirements

OS: Windows 10/11, Ubuntu 20.04+, macOS 10.15+
RAM: 4 GB
Storage: 100 MB free space
Python: 3.8 or higher (for source execution)
Privileges: Administrator/Root access required for optimization features

Dependencies

psutil>=5.9.0
customtkinter>=5.2.0
Pillow>=9.0.0
pygame>=2.1.0

Installation

Windows

Option 1: Pre-compiled Executable (Recommended)

Download FluxOptimizer_Windows.exe from the releases page
Double-click to run (administrator privileges will be requested automatically)
The application will detect your system language automatically

Option 2: Run from Source

# Clone the repository
git clone https://github.com/yourusername/FluxOptimizer.git
cd FluxOptimizer

# Install dependencies
pip install -r requirements.txt

# Run the application
python src/windows/main.py

Linux

Step 1: Download and Extract

# Download the Linux package
wget https://github.com/yourusername/FluxOptimizer/releases/download/v2.0/FluxOptimizer-Linux.tar.gz
tar -xzf FluxOptimizer-Linux.tar.gz
cd FluxOptimizer-Linux

Step 2: Install Dependencies

# Run the installation script
bash install.sh

# Or manually install:
# Debian/Ubuntu
sudo apt-get install python3 python3-pip
pip3 install psutil customtkinter pillow pygame

# RHEL/CentOS/Fedora
sudo yum install python3 python3-pip
pip3 install psutil customtkinter pillow pygame

# Arch Linux
sudo pacman -S python python-pip
pip3 install psutil customtkinter pillow pygame

Step 3: Run

cd dist/linux
sudo python3 main.py

macOS

Step 1: Download and Extract

# Download the macOS package
curl -L -o FluxOptimizer-Mac.tar.gz https://github.com/yourusername/FluxOptimizer/releases/download/v2.0/FluxOptimizer-Mac.tar.gz
tar -xzf FluxOptimizer-Mac.tar.gz
cd FluxOptimizer-Mac

Step 2: Install Dependencies

# Run the installation script
bash install.sh

# Or manually:
# Install Homebrew if not present
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Python and dependencies
brew install python@3.11
pip3 install psutil customtkinter pillow pygame

Step 3: Run

cd dist/mac
sudo python3 main.py

Building from Source

Windows Build

# Run the Windows compiler script
.\compile_windows.bat

# Or manually with PyInstaller:
pyinstaller --noconfirm --onefile --windowed `
    --name "FluxOptimizer_Windows" `
    --add-data "locales\translations.json;locales" `
    --add-data "assets\images\favicon.ico;assets\images" `
    --add-data "assets\images\logo.png;assets\images" `
    --add-data "assets\sounds\notification.mp3;assets\sounds" `
    --add-data "assets\sounds\danger.mp3;assets\sounds" `
    --icon "assets\images\favicon.ico" `
    "src\windows\main.py"

Linux Build

# Prepare the distribution package
./compile_linux.bat  # On Windows

# Or manually on Linux:
cd src/linux
pyinstaller --onefile --windowed \
    --name "FluxOptimizer" \
    --add-data "../../locales/translations.json:locales" \
    --add-data "../../assets/images/favicon.ico:assets/images" \
    main.py

macOS Build

# Prepare the distribution package
./compile_mac.bat  # On Windows

# Or manually on macOS:
cd src/mac

# Option 1: Using py2app (creates .app bundle)
pip3 install py2app
python3 setup.py py2app

# Option 2: Using PyInstaller
pip3 install pyinstaller
pyinstaller --onefile --windowed \
    --name "FluxOptimizer" \
    --add-data "../../locales/translations.json:locales" \
    --add-data "../../assets/images/favicon.ico:assets/images" \
    main.py

Build All Platforms at Once

# On Windows, run the master compiler
.\compile_all.bat

This will create:

dist/windows/FluxOptimizer_Windows.exe
dist/linux/ (ready to package)
dist/mac/ (ready to package)

Beta Version (Lightweight Edition) - v1.5.0

FluxOptimizer Beta is a simplified, lightweight version focused on core system monitoring and temporary file cleanup. It provides the essential features without the complexity of the full PRO version.

What's the Beta Version?

Aspect	PRO Version	Beta Version
Size	Larger bundle	Minimal footprint
Features	Full optimization suite	CPU + RAM + Temp monitoring only
Languages	104 languages	English only
Interface	Full dashboard	Simplified 3-panel dashboard
Target	Power users	Quick system checks

Beta Features

Real-Time CPU Monitoring: Circular animated chart showing CPU load percentage
RAM Usage Tracker: Visual gauge with high-memory warnings (alerts when >90%)
Temp Files Counter: Detects and displays count + size of temporary files
One-Click Cleanup: Cleans temporary files with progress logging
Sound Notifications: Success/danger sounds with pygame (optional)
Admin Auto-Elevation: Automatically requests administrator privileges on Windows

When to Use the Beta

Quick system health checks: Monitor CPU/RAM without full optimization
Portable usage: Smaller file size for USB drives
Temporary file cleanup only: When you don't need full system optimization
Testing: Lighter version for testing CustomTkinter interfaces

Building the Beta Version

Windows

# Run the Beta compiler script
.\compile_windows_beta.bat

# Output: dist/FluxOptimizer_Beta.exe

Requirements for compilation:

Python 3.8+
psutil
customtkinter
pillow
pygame (for sound notifications)
pyinstaller

Manual Build

pyinstaller --noconfirm --onefile --windowed `
    --name "FluxOptimizer_Beta" `
    --icon "assets\images\favicon.ico" `
    --add-data "assets\images\logo.png;assets\images" `
    --add-data "assets\images\favicon.ico;assets\images" `
    --add-data "assets\sounds\notification.mp3;assets\sounds" `
    --add-data "assets\sounds\danger.mp3;assets\sounds" `
    --hidden-import=psutil `
    --hidden-import=customtkinter `
    --hidden-import=PIL `
    --hidden-import=pygame `
    "src\windows\main_beta.py"

Beta Architecture

FluxOptimizer Beta/
├── src/windows/main_beta.py    # Single-file implementation
├── compile_windows_beta.bat    # Windows compiler
└── assets/                     # Same assets as PRO
    ├── images/
    └── sounds/

Key differences in code:

Single-file architecture (main_beta.py vs modular main.py)
No TranslationManager (hardcoded English)
Simplified UI: 3-column dashboard only
No registry cleaning, package managers, or browser cache cleaning

Supported Languages

FluxOptimizer supports 104 languages through an extensible JSON-based translation system:

Language	Code	Status
English	`en`	✅ Complete
Spanish	`es`	✅ Complete
French	`fr`	✅ Complete
German	`de`	✅ Complete
Portuguese	`pt`	✅ Complete
Italian	`it`	✅ Complete
Russian	`ru`	✅ Complete
Japanese	`ja`	✅ Complete
Chinese (Simplified)	`zh`	✅ Complete
Chinese (Traditional)	`zh-TW`	✅ Complete
Korean	`ko`	✅ Complete
Arabic	`ar`	✅ Complete
Hindi	`hi`	✅ Complete
...and 91 more

Adding a New Language

Edit locales/translations.json
Add a new key with your language code (e.g., "sv" for Swedish)
Copy the structure from an existing language
Translate all values
Restart the application

Architecture

Project Structure

FluxOptimizer/
├── assets/
│   ├── images/
│   │   ├── favicon.ico       # Application icon
│   │   ├── logo.png          # Logo asset
│   │   └── cover.png         # README cover image
│   └── sounds/
│       ├── notification.mp3  # Success sound
│       └── danger.mp3        # Warning sound
├── locales/
│   └── translations.json     # 104 language translations
├── src/
│   ├── windows/
│   │   ├── main.py           # Windows PRO implementation
│   │   └── main_beta.py      # Windows Beta (lightweight)
│   ├── linux/
│   │   └── main.py           # Linux-specific implementation
│   └── mac/
│       └── main.py           # macOS-specific implementation
├── compile_windows.bat       # Windows compiler (PRO)
├── compile_windows_beta.bat  # Windows compiler (Beta)
├── compile_linux.bat         # Linux preparer
├── compile_mac.bat           # macOS preparer
├── compile_all.bat           # Master compiler
├── requirements.txt          # Python dependencies
└── README.md                 # This file

Language Detection Priority

The application detects system language in the following order:

Windows UI Language (GetUserDefaultUILanguage) - User's display language setting
System Default Language (GetSystemDefaultLangID) - System locale
Keyboard Layout (GetKeyboardLayout) - Input language (fallback)
Python Locale (locale.getdefaultlocale) - Last resort

This ensures the application appears in the user's preferred language as configured in their operating system settings.

Key Components

Component	Description
`TranslationManager`	Singleton class handling 104-language support
`ModernChart`	Animated circular progress indicators
`TechCard`	Styled information cards with icons
`AnimatedButton`	Interactive buttons with hover effects
`SystemMaintenanceSuite`	Main application controller

License

MIT License

Copyright (c) 2026 FluxOptimizer Team

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Made with precision. Optimized for performance.
_{FluxOptimizer v2.0 - Professional System Maintenance Suite}

Name		Name	Last commit message	Last commit date
Latest commit History 3,002 Commits
assets		assets
dist		dist
locales		locales
src		src
README.md		README.md
activity_log.txt		activity_log.txt
compile_all.bat		compile_all.bat
compile_linux.bat		compile_linux.bat
compile_mac.bat		compile_mac.bat
compile_windows.bat		compile_windows.bat
compile_windows_beta.bat		compile_windows_beta.bat
create_translations.py		create_translations.py
create_version_info.py		create_version_info.py
requirements.txt		requirements.txt

Folders and files

Latest commit

History

Repository files navigation

FluxOptimizer

Table of Contents

Overview

Features

Core Capabilities

Platform-Specific Features

System Requirements

Minimum Requirements

Dependencies

Installation

Windows

Option 1: Pre-compiled Executable (Recommended)

Option 2: Run from Source

Linux

Step 1: Download and Extract

Step 2: Install Dependencies

Step 3: Run

macOS

Step 1: Download and Extract

Step 2: Install Dependencies

Step 3: Run

Building from Source

Windows Build

Linux Build

macOS Build

Build All Platforms at Once

Beta Version (Lightweight Edition) - v1.5.0

What's the Beta Version?

Beta Features

When to Use the Beta

Building the Beta Version

Windows

Manual Build

Beta Architecture

Supported Languages

Adding a New Language

Architecture

Project Structure

Language Detection Priority

Key Components

License

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages