2026-04-21 13:16:36 +08:00

70 lines
2.1 KiB
Markdown

# xpra-html5
HTML5 client for Xpra remote desktop server.
## Version
This is based on **xpra-html5 version 19** from the official Xpra project.
## License
This project is licensed under the Mozilla Public License Version 2.0 (MPL-2.0).
See the [LICENSE](LICENSE) file for the full license text.
## Copyright
Copyright (c) 2013 Antoine Martin <antoine@xpra.org>
Copyright (c) 2014 Joshua Higgins <josh@kxes.net>
## Source
This is a modified version of the xpra-html5 client from the official Xpra project:
- Official repository: https://github.com/Xpra-org/xpra-html5
- Project website: https://xpra.org/
- Version: 19
## Modifications from v19
This version has been modified for integration with GNS3 Web UI:
### Client.js
No modifications - using original v19 code.
### Protocol.js
- **Line 191**: Added documentation comment clarifying that the 'binary' subprotocol is required by xpra protocol
- Code remains unchanged from v19
### index.html
- **Lines 927-933**: Simplified connection close callback
- **Before**: Redirected to connect.html with extensive parameter passing
- **After**: Only logs the close reason, no redirection
- **Impact**: Simplified error handling for embedded GNS3 Web UI usage
- Removed 82 lines of redirection logic
### TypeScript Service (xpra-console.service.ts)
- **buildXpraConsolePageUrl()**: Improved WebSocket URL parsing
- **Before**: Manual parsing and concatenation of path and token
- **After**: Using URL API to correctly extract pathname and search
- **Impact**: More reliable handling of query parameters and tokens
## Summary of Changes
- **Total files modified**: 3
- **Lines added**: 11
- **Lines removed**: 95
- **Net change**: -84 lines (simplified)
All modifications maintain compliance with MPL-2.0 license requirements.
## License Compliance
This project complies with the MPL-2.0 license requirements:
- All source code modifications are made available under MPL-2.0
- Original copyright notices are preserved
- A copy of the MPL-2.0 license is included
- Modifications are clearly documented
For more information about MPL-2.0, see:
https://www.mozilla.org/en-US/MPL/2.0/FAQ/