2.5.2

2.5.2 (2026-07-15)

Bug fixes

• Escape white characters in Linux desktop files.
  The freedesktop.org
  specification allows for white space, which can be used to inject a malicious Exec instruction
  into unrelated fields such as Description. (GHSA-fqh4-w37r-x339, #514)

Contributors

• @marcoesters
• @jaimergp

2.5.1

2.5.1 (2026-06-10)

Bug fixes

• Gracefully handle permission errors when writing menuinst.toml in read-only environments. (#496)

Other

• Refactor some tests to use temporary directories instead of using sys.prefix. (#496)

Contributors

• @lrandersson

2.5.0

2.5.0 (2026-06-02)

Enhancements

• Improved logging of warnings during installation (#464 via #475)

Bug fixes

• Registry entries are now properly quoted. This resolves an issue where opening files associated with a program could fail if its path included blank spaces. (#290 via #404)
• On Windows, the @elevate_as_needed decorator now respects the .nonadmin marker file when running as admin, using user mode instead of system mode. (#453 via #454)
• On Windows, fixed path quoting in activation scripts for installations with spaces in the path. (#454)
• install_all and remove_all now skip malformed JSON files with a warning instead of crashing. (#459 via #460)
• Resolved an issue where menus containing some platform-specific shortcuts would lead to install and removal errors (#463 via #475)

Other

• Remove support for Python 3.9. (#445)
• Update Python versions in canary builds: remove version 3.9 and add 3.13. (#445)

Contributors

• @larsoner
• @jaimergp
• @lrandersson

2.4.2

Enhancements

• Allow for arbitrary Info.plist properties in macOS app bundles. (#195, #410 via #415)

Bug fixes

• For Linux platforms, MimeTypes with defined glob patterns are now properly handled when xdg-mime is not on the system. (#296 via #403)
• When uninstalling shortcuts as administrator, check user locations if no system shortcuts have
  been found and prefixes contain .nonadmin files. This allows removing single-user shortcuts
  as an administrator. (#341 via #414)

Contributors

• @marcoesters
• @lrandersson

2.4.1

Bug fixes

• Add entry point to recipe. (#395)
• Pass __spec__ to apipkg initializers to allow module discovery in PyInstaller. (#396)
• Catch COM errors during registry tests. (#398)

Contributors

• @jaimergp
• @marcoesters

2.4.0

Enhancements

• Add a CLI and conda plug-in. (#368 via #372)
• Support NSCameraUsageDescription, NSMainCameraUsageDescription, NSMicrophoneUsageDescription, and NSAudioCaptureDescription in macOS app bundles. (#362 via #375)

Bug fixes

• Prepend XDG_MENU_PREFIX to filename when writing applications.menu file on Linux. (#340)

Other

• Replace the deprecated conda.cli.python_api module with the CondaCLIFixture. (#389)

Contributors

• @drammack
• @jaimergp
• @Jrice1317
• @marcoesters
• @mrclary

2.3.1

Bug fixes

• Restore behavior where the absence of a platform key in the MenuItem platforms dictionary disables shortcut creation for that platform. (#234, #240 via #350)
• Allow null for icon and platforms.(win|osx|linux). This bumps the schema version to 1-1-1. (#345 via #351)
• Restore menuinst.default.json and menuinst.schema.json to prevent errors during conda update. (#358 via #359)

Other

• Update _schema.py to use pydantic v2. (#351)
• Fix some type hints. (#352)

Contributors

• @jaimergp
• @marcoesters
• @soapy1

2.3.0

Enhancements

• Version the JSON schema using SchemaVer. Current version is 1-1-0. Previous versions are still available as 1-0-0 (as published in menuinst v2.0.0), 1-0-1 (as published in menuinst v2.1.0), and 1-0-2 (as published in menuinst v2.2.0) (#288)
• Add activator for env files generated by conda 25.3+. (#321 via #330)

Bug fixes

• Make sure the Pydantic field descriptions make it to the generated JSON schema. (#281)
• Use $schema to indicate which schema will validate the menuinst shortcut.
  This means that menuinst shortcuts must now include a $schema key pointing to a URL containing the relevant menuinst JSON schema version. (#282 via #283, #313)
• Remove quotes around SETUPTOOLS_SCM_PRETEND_VERSION recipe variable. (#317)

Deprecations

• $id key is no longer required in the schema, and is now deprecated. (#282 via #283)

Other

• Add setuptools_scm to build recipe. (#309)
• Replace deprecated run_command function with conda_cli. (#310)
• Use ruff for linting and formatting. (#315, #318)
• Check and pretty-format JSON files. (#315)
• Increase timeout for Windows shortcuts tests to 30 seconds. (#319)

Contributors

• @dbast
• @jaimergp
• @marcoesters

2.2.0

Enhancements

• Partially backport privilege elevation logic from v2 to v1. (#260)
• Add support for SingleMainWindow in the Linux platform-specific options to allow disabling the New Window option in the app's context menu. (#264 via #265)

Deprecations

• In v2-style schemas, Windows setting quicklaunch default value is now false and using it is considered deprecated. (#244 via #272)

Docs

• Add missing comma to base/non-base example. (#248)

Other

• Update Python versions in canary builds: remove version 3.8 and add 3.12. (#266)
• Drop Python 3.8 from the CI test matrix. (#263)

Contributors

• @jaimergp
• @marcoesters

New Contributors

• @larsoner made their first contribution in #265

2.1.2

Bug fixes

• Display shortcut name in Windows' "Open with" menu entries. (#225)
• Fix default MIME type registration on Linux. (#226 via #227)
• Add setuptools to recipe host requirements. (#237)

Contributors

• @jaimergp
• @marcoesters
• @zklaus