compylr 1.0.0

A modern GUI desktop app to compile Python scripts to Windows executables using Nuitka

Compylr

A modern, powerful, and intuitive GUI for transforming Python scripts into standalone executables using Nuitka.

📌 Overview

Compylr takes the complexity out of compiling Python applications. It provides a sleek, modern user interface built with CustomTkinter that lets you configure Nuitka's powerful compilation options visually. No more memorizing long command-line flags — just point, click, and build.

✨ Features

• Modern & Responsive UI: Fully redesigned using CustomTkinter with dark and light mode support.
• Visual Configuration: Configure build modes, output settings, windows options, metadata, and data files through an intuitive sidebar menu.
• Live Command Preview: See the exact Nuitka command being generated in real-time.
• Integrated Terminal: View color-coded compilation progress, warnings, and errors directly inside the app.
• Smart Troubleshooting: Automatically suggests fixes for common compilation errors (e.g., corrupted caches, missing modules).
• Clean Build Support: One-click option to safely clean old .build and .dist directories before recompiling.

📸 Screenshots

1. Compilation Mode & Output Settings

2. Windows Options & Version Metadata

3. Compiler & Build Options

4. Python Flags & Package Inclusions

5. Plugins & Data Files

6. Compiler Terminal & Live Build

🚀 Installation

Install Compylr directly using pip:

pip install compylr

Requirements

• Python 3.8+
• C Compiler (MinGW64 or MSVC on Windows) — required by Nuitka for compilation.

💻 Usage

Launch the application directly from your terminal:

compylr

1. Select Script: Browse for the .py file you want to compile.
2. Select Interpreter: (Optional) Pick a specific Python executable to run Nuitka.
3. Configure Options: Navigate through the sidebar sections (Compilation Mode, Windows Options, Plugins, etc.) to set your desired flags.
4. Build: Go to the Build section and click 🚀 Build Executable.

📁 Project Structure

compylr/
├── src/
│   └── compylr/
│       ├── logo/              # Window icon and branding logo assets
│       │   ├── logo.ico
│       │   └── logo.png
│       ├── __init__.py
│       ├── main.py            # Application entry point
│       ├── app.py             # Main CustomTkinter application and layout
│       ├── widgets.py         # Custom reusable UI components
│       ├── theme.py           # Color palettes and font definitions
│       └── nuitka_options.py  # Definition of all Nuitka flags and groups
├── readme-assets/             # Screenshots and README header logo assets
├── requirements.txt           # Python dependencies
├── pyproject.toml             # Pyproject settings metadata
├── LICENSE                    # MIT License file
└── README.md                  # This file

🛠 Technologies Used

• Python - Core programming language
• CustomTkinter - Modern UI framework
• Nuitka - The Python compiler

🔮 Future Improvements

• Profile management (save and load compilation profiles for different projects).
• Direct compilation to macOS and Linux formats (when supported on host).
• Integrated dependency analyzer.

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

📝 License

This project is MIT licensed.

---

Made with ❤️ by Thisal