Skip to content

LMLK-seal/PortableXE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

12 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ“ฆ PortableXE Professional

Transform any Windows application into a portable, self-contained package

License: MIT Python 3.8+ Platform: Windows

PortableXE Screenshot

๐Ÿš€ Overview

PortableXE Professional is a comprehensive tool that converts Windows executables and installers into portable applications that can run from any location without installation. Perfect for creating USB-portable software, testing applications in isolated environments, or maintaining clean systems.

โœจ Key Features

๐Ÿ”ง Advanced Extraction Engine

  • Multi-format Support: 7-Zip, Inno Setup, MSI, NSIS, InstallShield, and more
  • Intelligent Detection: Automatically identifies installer types and extraction methods
  • Fallback Mechanisms: Multiple extraction strategies ensure maximum compatibility

๐ŸŽฏ Smart Application Analysis

  • PE Structure Analysis: Deep inspection of executable architecture and subsystem
  • Installer Detection: Recognizes setup files vs. standalone applications
  • Hash Verification: SHA256 checksums for file integrity

๐Ÿ“ Professional Portable Structure

  • Standard Directory Layout: App/, Data/, Documentation/, Plugins/
  • Environment Isolation: Redirects AppData, Registry, and Temp folders
  • Multiple Launchers: Batch, PowerShell, and conversion scripts included

๐Ÿ› ๏ธ Advanced Features

  • System Dependencies: Automatic Visual C++ Redistributable inclusion
  • Registry Backup: Optional registry key preservation
  • Compression Options: Configurable compression levels
  • Detailed Logging: Comprehensive operation tracking

๐Ÿ“‹ System Requirements

  • Operating System: Windows 10/11 (64-bit recommended)
  • Python: 3.8 or higher
  • Memory: 4GB RAM minimum, 8GB recommended
  • Storage: 500MB for application + space for portable apps

๐Ÿ”— Optional Dependencies (Recommended)

  • 7-Zip: For advanced archive extraction
  • innoextract: For Inno Setup installer processing

๐Ÿ› ๏ธ Installation

Option 1: Python Installation

# Clone the repository
git clone https://github.com/LMLK-seal/portablexe.git
cd portablexe

# Install required packages
pip install customtkinter tkinter pathlib configparser

# Install optional dependencies for enhanced functionality
pip install pywin32

Option 2: Portable Executable

Download the pre-compiled executable from the Releases page.

๐ŸŽฎ Quick Start

๐Ÿ–ฅ๏ธ GUI Mode (Recommended)

  1. Launch PortableXE.py or the executable
  2. Select your installer or executable file
  3. Configure app name and output directory
  4. Click "Create Portable App"
  5. Done! Your portable app is ready

๐Ÿ’ป Command Line Usage (Optional)

python PortableXE.py --input "installer.exe" --output "C:\PortableApps" --name "MyApp"

๐Ÿ“ Output Structure

MyApp_Portable/
โ”œโ”€โ”€ ๐Ÿ“ App/                    # Core application files
โ”‚   โ”œโ”€โ”€ MyApp.exe
โ”‚   โ”œโ”€โ”€ Dependencies/          # System libraries
โ”‚   โ””โ”€โ”€ ...
โ”œโ”€โ”€ ๐Ÿ“ Data/                   # Portable data storage
โ”‚   โ”œโ”€โ”€ AppData/              # Redirected AppData
โ”‚   โ”œโ”€โ”€ Registry/             # Registry backups
โ”‚   โ””โ”€โ”€ Profile/              # User profile data
โ”œโ”€โ”€ ๐Ÿ“ Documentation/          # User documentation
โ”œโ”€โ”€ ๐Ÿ“ Plugins/               # Application plugins
โ”œโ”€โ”€ ๐Ÿš€ RUN.bat                # Quick launcher
โ”œโ”€โ”€ โš™๏ธ MyApp.bat              # Advanced launcher
โ”œโ”€โ”€ ๐Ÿ”ง ConvertInstaller.bat   # Installer converter
โ””โ”€โ”€ ๐Ÿ“„ README.md              # Usage instructions

๐ŸŽฏ Supported Formats

Format Support Level Notes
Inno Setup โœ… Excellent Full extraction with innoextract
NSIS โœ… Excellent 7-Zip based extraction
MSI โœ… Excellent Native Windows Installer support
InstallShield ๐ŸŸจ Good 7-Zip extraction
WiX Toolset ๐ŸŸจ Good Standard MSI handling
ZIP/RAR Archives โœ… Excellent Native support
Standalone EXE โœ… Perfect Direct portable conversion

โš™๏ธ Configuration

PortableXE stores configuration in %USERPROFILE%\PortableXE\config.ini:

[General]
default_output_dir = C:\PortableApps
theme = dark
auto_analyze = true

[Advanced]
include_dependencies = true
create_launcher = true
compression_level = 6

[Extraction]
timeout_seconds = 300
use_7zip = true
use_innoextract = true

๐Ÿ” Troubleshooting

๐Ÿ› Common Issues

Extraction Failed

  • Ensure 7-Zip and innoextract are installed and in PATH
  • Try running as administrator for system-level installers
  • Check installer isn't corrupted or password-protected

Application Won't Start

  • Verify all dependencies are in the Dependencies folder
  • Check Windows version compatibility
  • Review creation logs for missing files

Large File Sizes

  • Adjust compression level in settings
  • Exclude unnecessary language packs or documentation
  • Use selective extraction options

๐Ÿ“ž Getting Help

  1. Check the Creation Log tab for detailed error messages
  2. Review generated README.md in the portable app folder
  3. Enable detailed logging in configuration
  4. Consult the ConvertInstaller.bat for manual conversion guidance

๐Ÿ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ™ Acknowledgments

  • 7-Zip project for archive extraction capabilities
  • innoextract for Inno Setup installer support
  • CustomTkinter for the modern GUI framework
  • Microsoft for Windows Installer technology

Made with โค๏ธ by LMLK-seal

โญ Star us on GitHub โ€ข ๐Ÿ“ Report Issues โ€ข ๐Ÿ’ฌ Discussions

About

Transform any Windows application into a portable, self-contained package

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages