Stu Leak 77ad11eadf 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.

2025-12-04 01:49:39 -05:00

3.0 KiB

Raw Blame History

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

Flexible window sizing
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:

Note your distro and desktop environment
Specify X11 or Wayland
Include window manager if using tiling WM
Provide steps to reproduce
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

3.0 KiB Raw Blame History