A high-performance Python desktop application that compiles Windows scripts (.bat, .cmd, .ps1, .vbs) into standalone .exe executables using PyInstaller, complete with embedded base64 payloads, custom windowless execution modes, PE version metadata, and digital signature support.
MateAGYTis the exclusive official repository creator. Avoid running unverified builds from external sources.
- 1. About
- 2. Disclaimer & License
- 3. Features
- 4. Why LittleCompiler?
- 5. Comparison
- 6. Requirements
- 7. Installation
- 8. Troubleshooting & FAQ
- 9. Roadmap
- 10. Credits
- 11. Contributing
LittleCompiler is an advanced script launcher compiler built for administrators, developers, and power users who need to convert standard Windows batch and PowerShell automation scripts into compiled binary executables. Instead of exposing raw plaintext scripts, the application embeds script payloads securely inside a hardened Python launcher wrapper compiled via PyInstaller.
The interface features a custom dark-themed CustomTkinter design featuring an animated background canvas, automated PyInstaller bootstrap installation, multi-resolution icon conversion via Pillow, full PE file version property injection, and optional code signing support via signtool.
a) Disclaimer. This software is provided strictly for educational purposes, legitimate administrative automation, and authorized software packaging. The author assumes no responsibility for any misuse or malicious activities conducted with binaries compiled through this utility.
b) License. MIT License. See LICENSE for complete terms.
Comprehensive options for script wrapping, process control, and executable customization.
| Feature | Description |
|---|---|
| Multi-Format Support | Compiles .bat, .cmd, .ps1, and .vbs scripts into native PE executables. |
| Embedded Base64 Payload | Encodes target scripts into memory-safe base64 strings decoded dynamically at runtime. |
| Automatic PyInstaller Bootstrap | Automatically checks for and installs PyInstaller dependencies if missing from the Python environment. |
| Multi-Resolution Icon Injection | Accepts .ico, .png, .jpg, or .bmp files, automatically converting images into multi-resolution .ico assets. |
| PE Version Metadata Editor | Customizes file version, product version, company name, copyright details, and internal descriptions. |
| Digital Code Signing | Integrates with Windows signtool to sign compiled binaries using .pfx certificates with timestamp server verification. |
- Windowless Mode: Suppresses terminal windows entirely using background process flags for silent background execution.
- Console Mode: Preserves standard command prompt or terminal visibility for interactive scripts.
- Forced UAC Administrator: Automatically embeds flags to request elevated administrator privileges on launch.
- Process Synchronization: Configurable execution waiting behavior to capture and propagate exit codes correctly.
- Automatic Cleanup: Optionally purges extracted temporary script artifacts from
%TEMP%upon completion.
- Zero Plaintext Exposure: Scripts are compiled directly into the binary layout rather than sitting loosely on disk.
- Robust Wrapper Logic: Built-in fallback mechanisms handle command interpreters, standard input streams, and directory paths smoothly.
- Polished Modern UI: Non-blocking asynchronous worker threads keep the interface responsive during heavy PyInstaller compilation phases.
- All-in-One Packaging: Combines version resource generation, icon scaling, and signing into a single streamlined workspace.
| Feature | LittleCompiler | Basic Batch Converters | Manual PyInstaller Setup | Raw Script Execution |
|---|---|---|---|---|
| Offline Capable | ✅ | ✅ | ✅ | ✅ |
| Multi-Format Support (Bat/PS1/VBS) | ✅ | ❌ | 🟡 | ✅ |
| Custom Windowless Execution | ✅ | ❌ | 🟡 | ❌ |
| Built-in PE Version Metadata Editor | ✅ | ❌ | ❌ | ❌ |
| Automated Icon Conversion (PNG/JPG to ICO) | ✅ | ❌ | ❌ | ❌ |
| Integrated Code Signing Support | ✅ | ❌ | ❌ | ❌ |
- Operating System: Windows 10/11 (x64)
- Runtime: Python 3.10+ (with Python added to system PATH)
- Dependencies:
customtkinter,pillow(optional, for icon conversion),PyInstaller(auto-installed if missing)
- Verify Python 3.10+ is installed with the PATH option enabled.
- Clone or download the repository source files.
- Install required runtime packages via command prompt:
py -m pip install customtkinter pillow
- Launch the application:
py main.py
- PyInstaller Installation Fails: Ensure your system has internet access so pip can retrieve PyInstaller, or install it manually via
py -m pip install pyinstaller. - Antivirus False Positives: Compiled PyInstaller binaries wrapping scripts frequently trigger heuristic detection alerts on Windows Defender. Use designated exclusions or sign binaries using a valid certificate.
- Script Fails to Execute Silently: If a PowerShell script fails in windowless mode, verify that its execution policy allows local script execution or test it with console mode enabled to view error outputs.
- Custom compression toggles for output executables.
- Support for bundling additional external dependency files and folders.
- Preset configuration profiles save/load system.
- Advanced obfuscation layer before payload encoding.
- CustomTkinter — Modern Python UI widget framework.
- PyInstaller — Executable packaging engine.
- Pillow — Image processing and icon conversion utility.
- Fork the repository.
- Create your feature branch (
git checkout -b feature/new-compiler-feature). - Commit your modifications.
- Open a Pull Request detailing your changes.