# Microsoft Store Listing Packager 1.0.0 Build a reviewable listing import folder from your fresh Partner Center CSV export, explicit translated field replacements, and optional desktop PNG screenshots. Python 3.10+ standard library only. No credentials, subscription, other product, or network connection is needed. This is an independent utility, not a Microsoft product. ## Native app Extract the entire product ZIP. Run `python app.py` (or `py -3 app.py` on Windows). The native file-picker interface requires Tkinter, included in the standard Windows Python installer. Choose your CSV export, changes JSON, screenshot root folder, and a new output ZIP path. Click **Validate and build new ZIP**. The results pane reports every changed cell. The CLI does not require Tkinter. ## CLI and first run Run `python packager.py examples/export.csv examples/changes.json example-result.zip`. The examples are synthetic; use your own fresh export for actual listing work. For screenshots add `--assets path/to/screenshots`. Exit 0 means local archive built; exit 2 means validation or I/O failed. Existing output files are never overwritten and validation failures create no output. Extract the result ZIP. Read `review-report.json`, including before/after values and default-fallback indicators. Review the screenshots. In Partner Center select Import listings > Import folder and choose the extracted **store-import** directory, which contains one listing.csv and any new images. Do not upload the ZIP itself. Partner Center's actual validation remains authoritative; this utility never submits, sends review requests or publishes anything. ## Changes format ```json { "texts": { "en-us": {"Description": "Your app description", "ReleaseNotes": ""}, "es": {"Description": "Descripción de la aplicación"} }, "screenshots": {"es": {"DesktopScreenshot1": "spanish/home.png"}} } ``` Only change the cells you intend to replace. Omitted cells, unknown field rows, other languages, trailers, legal fields, default values and metadata are preserved. No automatic English copying occurs. Language columns and edited field rows must already exist in the fresh export. Add languages in Partner Center and export again before using them. Both Type and Type (Type) metadata headers are accepted. Supported text fields: Description, ReleaseNotes, ShortDescription, ShortTitle, VoiceTitle, Title, Feature1–20, SearchTerm1–7 and DesktopScreenshotCaptionN. Each changed language requires an effective Description and a desktop screenshot or existing asset reference. Description/Title cannot be emptied. Optional fields can be blank; a nonempty default cell can then supply fallback text. Effective search-term totals include defaults. Titles must still match your reserved names in Partner Center. Limits: 5 MiB per input, 2000 field rows, 100 columns; desktop PNGs at most 20 MiB each and 100 MiB total. Screenshot paths must stay beneath the chosen asset root. Only PNG header/dimension preflight is provided, not full image decoding, visual inspection or Store screenshot certification. Existing URLs are preserved without fetching. Arbitrary URLs and other device-family asset replacements are not supported. Text limits are conservatively counted in UTF-16 code units. CSV cells are preserved exactly as text; use a text editor to avoid spreadsheet formula interpretation. ## Validation and source references `python -m unittest discover -s tests -v` tests bilingual changes, metadata and unknown-field preservation, bounds, path restrictions, CLI ZIP round-trip and refusal to overwrite. Actual Partner Center import and native visual acceptance are separate. Implementation follows Microsoft's [import/export documentation](https://learn.microsoft.com/en-us/windows/apps/publish/publish-your-app/pwa/import-and-export-store-listings) and [listing field documentation](https://learn.microsoft.com/en-us/windows/apps/publish/publish-your-app/pwa/add-and-edit-store-listing-info), checked 2026-10-30. In particular, metadata must not change, blank optional release notes are valid, and relative asset paths include the selected import folder name.