Skip to content

Conversation

@kpvdev
Copy link

@kpvdev kpvdev commented Feb 7, 2026

Summary

This PR fixes compatibility with FreeRDP 3.x, which introduced breaking changes to the /app: parameter syntax. Without these changes, winapps fails on modern Linux distributions shipping FreeRDP 3.x.

Changes Made

  • Updated /app: parameter syntax in bin/winapps (6 locations)
  • Updated /app: parameter syntax in installer.sh (1 location)
  • Changed /app:"executable" to /app:program:executable
  • Moved /app-cmd: parameter inside /app: as cmd:
  • Moved /app-icon: parameter inside /app: as icon:

Testing

  • Tested on Fedora 42 with FreeRDP 3.21.0
  • Verified bin/winapps check works correctly
  • Verified installer successfully detects and configures applications
  • Verified applications launch correctly from command line and application menu

Affected Systems

This fixes winapps for users on distributions shipping FreeRDP 3.x:

  • Fedora 40+
  • Ubuntu 24.10+

Error Messages Fixed

  • Command line parsing failed at 'app' value 'explorer.exe' [-1002]
  • Unexpected keyword errors during installation
  • Applications failing to launch after installation

- Updated /app: parameter syntax from v2 to v3 format
- Changed /app:"executable" to /app:program:executable
- Moved /app-cmd: parameter inside /app: as cmd:
- Moved /app-icon: parameter inside /app: as icon:
- Fixed installer.sh to use correct FreeRDP 3.x syntax
- Tested on Fedora 42 with FreeRDP 3.21.0

This fixes compatibility for users on modern Linux distributions
shipping FreeRDP 3.x (Fedora 40+, Ubuntu 24.10+, etc.)

Fixes issues where winapps would fail with 'Unexpected keyword'
or 'Command line parsing failed' errors.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant