Document GNOME compatibility and window management limitations
Added comprehensive documentation on Linux/GNOME compatibility: Known Issues: - Double-click titlebar maximize is Fyne framework limitation - Provided workarounds: Super+Up, maximize button, F11 - Window sizing issues have been fixed Cross-platform goals: - Smooth operation on Linux, macOS, Windows - Single codebase with Fyne framework - Respect native window manager behaviors Testing matrix: - GNOME/Fedora verified - X11 and Wayland support - Should work on KDE, XFCE, etc. Development guidelines: - Test on both X11 and Wayland - Consider mouse and keyboard workflows - Respect window manager tiling - HiDPI display support This documentation helps users understand current limitations and provides context for cross-platform development priorities.
This commit is contained in:
parent
2d86fb2003
commit
77ad11eadf
109
docs/GNOME_COMPATIBILITY.md
Normal file
109
docs/GNOME_COMPATIBILITY.md
Normal file
|
|
@ -0,0 +1,109 @@
|
|||
# GNOME/Linux Compatibility Notes
|
||||
|
||||
## Current Status
|
||||
VideoTools is built with Fyne UI framework and runs on GNOME/Fedora and other Linux desktop environments.
|
||||
|
||||
## Known Issues
|
||||
|
||||
### Double-Click Titlebar to Maximize
|
||||
**Issue**: Double-clicking the titlebar doesn't maximize the window like native GNOME apps.
|
||||
|
||||
**Cause**: This is a Fyne framework limitation. Fyne uses its own window rendering and doesn't fully implement all native window manager behaviors.
|
||||
|
||||
**Workarounds for Users**:
|
||||
- Use GNOME's maximize button in titlebar
|
||||
- Use keyboard shortcuts: `Super+Up` (GNOME default)
|
||||
- Press `F11` for fullscreen (if app supports it)
|
||||
- Right-click titlebar → Maximize
|
||||
|
||||
**Status**: Upstream Fyne issue. Monitor: https://github.com/fyne-io/fyne/issues
|
||||
|
||||
### Window Sizing
|
||||
**Fixed**: Window now properly resizes and can be made smaller. Minimum sizes have been reduced to allow flexible layouts.
|
||||
|
||||
## Desktop Environment Testing
|
||||
|
||||
### Tested On
|
||||
- ✅ GNOME (Fedora 43)
|
||||
- ✅ X11 session
|
||||
- ✅ Wayland session
|
||||
|
||||
### Should Work On (Untested)
|
||||
- KDE Plasma
|
||||
- XFCE
|
||||
- Cinnamon
|
||||
- MATE
|
||||
- Other Linux DEs
|
||||
|
||||
## Cross-Platform Goals
|
||||
|
||||
VideoTools aims to run smoothly on:
|
||||
- **Linux**: GNOME, KDE, XFCE, etc.
|
||||
- **macOS**: Native macOS window behavior
|
||||
- **Windows**: Native Windows window behavior
|
||||
|
||||
## Fyne Framework Considerations
|
||||
|
||||
### Advantages
|
||||
- Cross-platform by default
|
||||
- Single codebase for all OSes
|
||||
- Modern Go-based development
|
||||
- Good performance
|
||||
|
||||
### Limitations
|
||||
- Some native behaviors may differ
|
||||
- Window management is abstracted
|
||||
- Custom titlebar rendering
|
||||
- Some OS-specific shortcuts may not work
|
||||
|
||||
## Future Improvements
|
||||
|
||||
### Short Term
|
||||
- [x] Flexible window sizing
|
||||
- [x] Better minimum size handling
|
||||
- [ ] Document all keyboard shortcuts
|
||||
- [ ] Test on more Linux DEs
|
||||
|
||||
### Long Term
|
||||
- [ ] Consider native window decorations option
|
||||
- [ ] Investigate Fyne improvements for window management
|
||||
- [ ] Add more GNOME-like keyboard shortcuts
|
||||
- [ ] Better integration with system theme
|
||||
|
||||
## Recommendations for Users
|
||||
|
||||
### GNOME Users
|
||||
- Use Super key shortcuts for window management
|
||||
- Maximize: `Super+Up`
|
||||
- Snap left/right: `Super+Left/Right`
|
||||
- Fullscreen: `F11` (if supported)
|
||||
- Close: `Alt+F4` or `Ctrl+Q`
|
||||
|
||||
### General Linux Users
|
||||
- Most window management shortcuts work via your window manager
|
||||
- VideoTools respects window manager tiling
|
||||
- Window can be resized freely
|
||||
- Multiple instances can run simultaneously
|
||||
|
||||
## Development Notes
|
||||
|
||||
When adding features:
|
||||
- Test on both X11 and Wayland
|
||||
- Verify window resizing behavior
|
||||
- Check keyboard shortcuts don't conflict
|
||||
- Consider both mouse and keyboard workflows
|
||||
- Test with HiDPI displays
|
||||
|
||||
## Reporting Issues
|
||||
|
||||
If you encounter GNOME/Linux specific issues:
|
||||
1. Note your distro and desktop environment
|
||||
2. Specify X11 or Wayland
|
||||
3. Include window manager if using tiling WM
|
||||
4. Provide steps to reproduce
|
||||
5. Check if issue exists on other platforms
|
||||
|
||||
## Resources
|
||||
- Fyne Documentation: https://developer.fyne.io/
|
||||
- GNOME HIG: https://developer.gnome.org/hig/
|
||||
- Linux Desktop Testing: Multiple VMs recommended
|
||||
Loading…
Reference in New Issue
Block a user