fix(linux): apply the window title to frameless windows

[julianstorer]

Description

linuxWebviewWindow.setTitle skips gtk_window_set_title entirely when the window was created with Frameless: true:

func (w *linuxWebviewWindow) setTitle(title string) {
	if !w.parent.options.Frameless {
		...
	}
}

newWindowImpl applies options.Title through that same method, so a frameless window never receives a title at all, and every later SetTitle call is dropped too. The window keeps whatever the WM falls back to — the g_set_prgname program name — for its entire lifetime.

The guard looks like it is protecting a titlebar, but on Linux the title is not a titlebar: gtk_window_set_title writes the WM_NAME / _NET_WM_NAME hints that taskbars, window switchers and pagers label the window with. It draws nothing on an undecorated window. Decorations are governed separately, by gtk_window_set_decorated in setFrameless / setBorderless, so removing this guard does not bring a titlebar back.

The user-visible effect is that a frameless app with multiple windows shows the same label for every one of them, so they cannot be told apart in the taskbar or in alt-tab. This was reported against a frameless Wails app by a user on Cinnamon/X11, but it applies to any frameless window on any Linux desktop.

Windows (SetWindowText) and macOS (setTitle:) have no equivalent guard, so this is Linux-only.

Changes

• Remove the Frameless guard from setTitle in both the GTK4 (linux_cgo.go) and GTK3 (linux_cgo_gtk3.go) backends, and note why the call is unconditional.
• Add an entry to v3/UNRELEASED_CHANGELOG.md.

No API or behaviour change for decorated windows — for them this path was already running.

Testing

Verified by inspection and by the reported symptom: the change unwraps three unchanged statements from an if, so decorated windows are unaffected, and frameless windows now get their _NET_WM_NAME set at creation and on each SetTitle.

Worth a second pair of eyes from someone running a frameless v3 app on GTK4 and GTK3 to confirm the taskbar label updates as expected.

Summary by CodeRabbit

• Bug Fixes
  • Frameless Linux windows now display their titles in taskbars and window switchers.
  • Window titles are applied consistently across supported GTK versions.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Team

Run ID: 76cd096d-4de8-41d4-9622-eaabc1c4d7a0

📥 Commits

Reviewing files that changed from the base of the PR and between 9f2fbd3 and 3596356.

📒 Files selected for processing (3)

• v3/UNRELEASED_CHANGELOG.md
• v3/pkg/application/linux_cgo.go
• v3/pkg/application/linux_cgo_gtk3.go

🚧 Files skipped from review as they are similar to previous changes (3)

• v3/pkg/application/linux_cgo_gtk3.go
• v3/pkg/application/linux_cgo.go
• v3/UNRELEASED_CHANGELOG.md

Included review availability: Your plan provides up to 10 included reviews per hour; 9 remain after this review.

---

Walkthrough

Linux GTK3 and GTK4 window title updates now apply to frameless windows. The changelog records this behavior.

Changes

Linux window title updates

Layer / File(s)	Summary
Apply titles to frameless windows v3/pkg/application/linux_cgo.go, v3/pkg/application/linux_cgo_gtk3.go, v3/UNRELEASED_CHANGELOG.md	GTK3 and GTK4 setTitle methods now assign titles without a frameless-window check. The changelog records the update.

Estimated code review effort: 2 (Simple) | ~5 minutes

Merge Risk: ⚪ Minimal · up to 35963

This change makes frameless Linux windows receive and update their titles without affecting decorated windows; no actionable merge-blocking risk remains beyond normal checks and review.

Poem

A rabbit checks the title bar bright,
Frameless windows show their names right.
GTK hops in, both three and four,
Taskbars know each window’s door.
Carrots cheer the changelog light!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description explains the problem, technical cause, implementation, and expected behavior. However, it omits the issue link, selected change type, reproducible test instructions, Linux distribution…	Add the relevant issue reference, select the applicable change type, provide reproducible test steps and Linux environment details, include wails doctor output or a detailed explanation, and complete the checklist.】【。

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely describes the primary change: applying Linux window titles to frameless windows.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 2…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Full details: Description check

Explanation

The description explains the problem, technical cause, implementation, and expected behavior. However, it omits the issue link, selected change type, reproducible test instructions, Linux distribution and version, wails doctor output, and completed checklist items.

Full details: Docstring Coverage

Explanation

No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 2 files. (1 skipped: 1 unsupported.)

• Fix all pre-merge checks with AI

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Note

GitHub couldn't provide a complete incremental comparison for this pull request, so CodeRabbit is performing a full review instead. This review may take a little longer.