English | Deutsch

WinStorePackager

Local-first Windows GUI for preparing Python apps for Microsoft Store submission: AppxManifest, Store icons, project profiles, screenshots, and MSIX packaging

Quick Start • Features • Architecture • Lifecycle Flow • Visual Showcase • Project Profiles • Sibling Tools • Security Policy • Changelog • LLM Context

Note

AI Agent & LLM Integration Notice: High-level repository structure and context boundaries are documented in llms.txt. LLM agents and automated tools can inspect package schemas via PROJECT_PROFILE_FORMAT.md and winstorepackager-project-v1.json.

---

Start Here

I want to...	Start with
Package a Python desktop app for the Microsoft Store	WindowsStorePublisher_3.py on Windows
Run the SDK-free Unix (Linux/macOS) desktop preflight	unix_preflight.py
Share project metadata without local secrets	PROJECT_PROFILE_FORMAT.md
Dogfood the WinStorePackager Store profile	winstorepackager-project-v1.json
Check security, local-data, and privacy boundaries	SECURITY.md, PRIVACY_POLICY.md, and Local Data

WinStorePackager is built for solo developers and small teams that need a practical Python-to-Microsoft-Store workflow without setting up Visual Studio projects for every app. It focuses on the repetitive pieces: Store manifest fields, required icon sizes, screenshot collection, profile exchange, and Windows SDK packaging commands.

---

Features

Feature	Description
Manifest Generator	Automatically creates AppxManifest.xml from form inputs with XML schema validation
Icon Generator	Generates all required Store sizes: 44×44, 50×50, 150×150, 310×310, 310×150 (Wide)
6-Language GUI (i18n)	Full localization support (Tier 2 / P-006: DE, EN, ES, ZH, JA, RU)
Keyring Integration	Secure storage of certificate passwords via OS Keyring (no plaintext on disk)
Screenshot Assistant	Captures app screenshots directly via pygetwindow for Store listing assets
11 Store Categories	Predefined categories (Developer Tools, Productivity, Education, Utilities, ...)
Age Ratings	3+ to 18+ ratings with compliant manifest capabilities declaration
MSIX Build & Sign	Invokes makeappx.exe and signtool.exe from the Windows SDK with SHA-256 signing
Settings Persistence	Host-local JSON configuration outside Git with atomic migration safety
SDK-Free Preflight	Cross-platform validation of manifests, profiles, and listings on Linux & macOS

---

Architecture & Packaging Pipeline

flowchart TD
    subgraph Input["1. Application Input"]
        A["Python App Source & Entry Point"]
        B["Application Base Icon / PNG"]
        C["Store Listing & Metadata (v1.json)"]
    end

    subgraph Core["2. WinStorePackager Core"]
        D["WinStorePackager GUI / CLI"]
        E["AppxManifest.xml Templating & Schema Guard"]
        F["Pillow Multi-Scale Icon Builder (44..310px)"]
        G["Project Profile Redactor & Exporter"]
    end

    subgraph Build["3. Windows SDK Packaging & Signing"]
        H["Windows SDK makeappx.exe pack"]
        I["OS Keyring Cryptographic Password Retrieval"]
        J["Windows SDK signtool.exe sign (SHA-256)"]
    end

    subgraph Output["4. Release & Submission"]
        K["Signed MSIX / AppX Package"]
        L["Windows App Certification Kit (WACK) Preflight"]
        M["Microsoft Partner Center Store Submission"]
    end

    A & B & C --> D
    D --> E & F & G
    E & F --> H
    H --> K
    K --> J
    I --> J
    J --> L
    L --> M

    subgraph Unix["Cross-Platform Preflight (Linux / macOS)"]
        N["unix_preflight.py"] --> O["SDK-Free Validation of Manifests, Profiles & Assets"]
    end

Loading

---

Packaging Lifecycle Flow

sequenceDiagram
    autonumber
    actor Dev as Developer
    participant GUI as WinStorePackager GUI / CLI
    participant Profile as Project Profile (v1.json)
    participant Manifest as AppxManifest Generator
    participant Icons as Store Icon Builder (Pillow)
    participant SDK as Windows SDK (makeappx / signtool)
    participant Keyring as OS Keyring Storage
    participant Store as Microsoft Partner Center

    Dev->>GUI: Launch & Load Project / Profile
    GUI->>Profile: Validate schema & sanitize local paths
    Dev->>GUI: Configure App Identity, Version & Capabilities
    GUI->>Manifest: Build AppxManifest.xml with schema validation
    Dev->>GUI: Supply Base Icon / Image Asset
    GUI->>Icons: Generate 44x44, 50x50, 150x150, 310x310 & 310x150 assets
    Dev->>GUI: Trigger Build & Package
    GUI->>SDK: Invoke makeappx.exe pack /d payload /p package.msix
    GUI->>Keyring: Retrieve certificate password securely
    GUI->>SDK: Invoke signtool.exe sign /f cert.pfx /fd SHA256
    SDK-->>GUI: Signed MSIX Package ready
    GUI-->>Dev: Ready for local WACK testing & Store submission
    Dev->>Store: Upload MSIX to Microsoft Partner Center

Loading

---

Visual Showcase & Store Assets

Store Feature	Visual Overview
Main Overview & Packaging Interactive desktop GUI for application identity, source paths, and Windows SDK toolchain setup.
Store Metadata & Ratings Predefined Store categories, age ratings, capabilities, support URLs, and localized privacy policies.
Multi-Resolution Icon Builder Automated generation and preview of all required Microsoft Store square and wide tile icon formats.
MSIX Packaging & Signing One-click MSIX package compilation, OS Keyring certificate authentication, and WACK preflight.

Rebuild the curated Microsoft Store screenshot set at any time with:

python generate_store_screenshots.py

The generator writes four 1920x1080 PNGs to releases/windowsstore/screenshots/ and uses only neutral demo metadata without exposing private paths, credentials, or Publisher IDs.

---

Project Profile Exchange and Local Profile Helper

WinStorePackager ships with a shared project profile format: PROJECT_PROFILE_FORMAT.md. The desktop app can import and export winstorepackager-project-v1.json so that Store metadata can be prepared outside Windows without exposing local Publisher IDs, SDK paths, certificate paths, or passwords.

This repository includes its own dogfooding profile, winstorepackager-project-v1.json. Load it in the desktop app to package WinStorePackager with WinStorePackager, or validate it without the Windows SDK:

python unix_preflight.py --project-root . --profile-path winstorepackager-project-v1.json

The profile intentionally keeps Partner Center Publisher IDs, certificate paths, SDK paths, and passwords out of Git. Add those values only in local settings before building or signing an MSIX.

---

Prerequisites & Installation

• Python 3.9–3.12+
• Windows 10/11 (for MSIX build and signing) or Linux/macOS (for preflight validation)
• Windows SDK (for makeappx.exe and signtool.exe)
• Microsoft Store developer account (for submission)

git clone https://github.com/file-bricks/WinStorePackager.git
cd WinStorePackager
pip install -r requirements.txt
python WindowsStorePublisher_3.py

Or on Windows, double-click START.bat.

---

SDK-Free Unix Preflight (Linux / macOS)

For Linux/macOS workstations or CI runs without the Windows SDK, the repository includes a metadata-only preflight:

python unix_preflight.py --project-root .
python unix_preflight.py --project-root . --profile-path ./winstorepackager-project-v1.json

The Unix preflight checks project structure, store_package.json, README, privacy policy, Store listing, screenshot/icon artifacts, and exported project profiles without building MSIX packages or requiring Windows binaries.

---

Local Data and Build Artifacts

WinStorePackager operates on local project files only:

• Host-Local Runtime Directories: Machine-specific settings and rotating logs live outside the source checkout in %LOCALAPPDATA%\WinStorePackager (Windows), ~/Library/Application Support/WinStorePackager (macOS), or ${XDG_CONFIG_HOME:-~/.config}/winstorepackager (Linux).
• Keyring Cryptographic Storage: Certificate passwords remain in the operating-system Keyring and are never written to disk or JSON files.
• Git Hygiene: Generated MSIX packages, EXE builds, temporary staging folders, certificates, and release bundles are strictly ignored by Git.

Template for machine-specific runtime settings (settings_store_packager.json):

{
  "app_name": "MyApp",
  "publisher": "CN=YOUR-PUBLISHER-ID",
  "publisher_display": "Your Name",
  "version": "1.0.0.0",
  "makeappx_path": "C:/Program Files (x86)/Windows Kits/10/App Certification Kit/makeappx.exe",
  "signtool_path": "C:/Program Files (x86)/Windows Kits/10/App Certification Kit/signtool.exe"
}

---

Sibling Tools & Ecosystem

WinStorePackager is part of the file-bricks and open-bricks open-source software family:

Tool	Ecosystem	Purpose
ProSync	file-bricks	Local-first file synchronization & SQLite WAL consistency guard
CleanMarkdown	doc-bricks	Markdown sanitization, whitespace repair & document formatting
DokuZen	doc-bricks	Fast, local-first technical documentation & knowledge organizer
UniversalDocsGrabber	doc-bricks	Universal document ingestion, OCR conversion & search engine
ellmos-filecommander-mcp	ellmos-ai	Local MCP server for safe file management, OCR & search
open-bricks	open-bricks	Umbrella organization for modular desktop & developer tools

---

Comparison with Alternatives

Feature	WinStorePackager	MSIX Packaging Tool	Visual Studio	Advanced Installer
GUI	✅	⚠️	✅	✅
Python Focus	✅	❌	❌	❌
Auto-Icons (All Sizes)	✅	❌	⚠️	✅
Manifest Generator	✅	❌	✅	✅
Free / Open Source	✅	✅	⚠️	❌
Screenshot Assistant	✅	❌	❌	❌
Keyring Security	✅	❌	❌	❌
6-Language Localization	✅	❌	⚠️	⚠️
Cross-Platform Preflight	✅	❌	❌	❌

---

Search and Discovery Context

Useful search phrases for this repository:

• WinStorePackager Python Microsoft Store MSIX
• file-bricks WinStorePackager
• Python AppxManifest generator
• local-first MSIX packaging tool
• Microsoft Store packaging GUI for Python apps
• MSIX packaging tool without Visual Studio

---

Documentation & Governance

• 📄 Security Policy: SECURITY.md — Bilingual vulnerability disclosure & local-first guarantees
• 📝 Changelog: CHANGELOG.md — Version history and release notes
• 🤖 LLM Reference: llms.txt — Machine-readable architectural guide
• 📦 Profile Format: PROJECT_PROFILE_FORMAT.md — Portable project profile specification

---

License & Liability

Dieses Projekt steht unter der MIT License.

Dieses Projekt ist eine unentgeltliche Open-Source-Schenkung im Sinne der §§ 516 ff. BGB. Die Haftung des Urhebers ist gemäß § 521 BGB auf Vorsatz und grobe Fahrlässigkeit beschränkt. Ergänzend gilt der Haftungsausschluss der MIT License.

Nutzung auf eigenes Risiko. Keine Wartungszusage, keine Verfügbarkeitsgarantie, keine Gewähr für Fehlerfreiheit oder Eignung für einen bestimmten Zweck.

This project is an unpaid open-source donation. Liability is limited to intent and gross negligence (§ 521 German Civil Code). Use at your own risk. No warranty, no maintenance guarantee, no fitness-for-purpose assumed.