Skip to content

fix(website): finding-soundswitch FAQ — reopening opens settings - #2221

Merged
Belphemur merged 2 commits into
devfrom
docs/finding-soundswitch-reopen
Jun 15, 2026
Merged

fix(website): finding-soundswitch FAQ — reopening opens settings#2221
Belphemur merged 2 commits into
devfrom
docs/finding-soundswitch-reopen

Conversation

@Belphemur

Copy link
Copy Markdown
Owner

What changed

The finding-soundswitch.md FAQ incorrectly claimed:

Reopening the application from the Start menu won't bring the settings window back.

This is wrong. Launching SoundSwitch a second time detects the already-running instance and signals it to open the settings window — this behavior is confirmed by the settings-open-at-startup.md FAQ. In fact, reopening is the easiest way to get the settings back.

Changes

  • Removed the incorrect claim about reopening not working
  • Added a new "The quick way: reopen SoundSwitch" section as the first recommendation
  • Enhanced the tray icon section with bullet points for right-click, double-click, and hover actions (with a link to General Settings for double-click configuration)
  • Updated the description frontmatter to reflect that reopening works

Before / After

Before After
Tells users to find the tray icon, claims reopening doesn't work Promotes reopening as the quickest option, then explains the tray icon method

… open settings

Remove the incorrect claim that reopening SoundSwitch from the Start menu
won't bring the settings window back. In reality, launching a second instance
detects the already-running instance and signals it to open settings — this
is confirmed by the settings-open-at-startup FAQ. Add a "quick way" section
promoting the reopen method as the easiest option, and enhance the tray icon
section with more context about right-click, double-click, and hover actions.
Copilot AI review requested due to automatic review settings June 15, 2026 01:45
@coderabbitai

coderabbitai Bot commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1cebe3d9-9b42-49f8-9c1f-a4051dc2e50a

📥 Commits

Reviewing files that changed from the base of the PR and between 9adf0c2 and 82de4a1.

📒 Files selected for processing (1)
  • website/src/faq/finding-soundswitch.md

📝 Walkthrough

Summary by CodeRabbit

  • Documentation
    • Updated the SoundSwitch FAQ to clarify tray behavior after the first launch and how to reopen the settings window from the Start menu or a desktop shortcut.
    • Reworked the “I can’t find SoundSwitch” section with a clearer “quick way” and structured tray-icon instructions (right-click for Settings, double-click to cycle playback/recording devices, and hover to view the active device).

Walkthrough

The finding-soundswitch.md FAQ page is updated to explain that SoundSwitch hides in the Windows system tray after first launch. The front matter description and body text are rewritten to add a "quick way" to reopen via Start menu or desktop shortcut, and tray-icon interactions (right-click, double-click, hover) are documented as bullets.

Changes

SoundSwitch FAQ – Tray Icon Guidance

Layer / File(s) Summary
FAQ front matter and body rewrite
website/src/faq/finding-soundswitch.md
Front matter description updated to mention system tray behavior; body section rewritten with a quick-reopen step and structured bullets for right-click (Settings), double-click (cycle playback), and hover (show active device); sources line retained.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐇 Hop and look, but don't despair,
The switch hides softly in the tray down there!
Right-click for settings, double to spin,
Hover to see what sound you're in.
No more searching — just wiggle that ear! 🎵

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title 'fix(website): finding-soundswitch FAQ — reopening opens settings' accurately describes the main change: correcting the FAQ to explain that reopening SoundSwitch from the Start menu does open settings.
Description check ✅ Passed The description is directly related to the changeset, explaining what was incorrect, what was changed, and why—matching the documented updates to the finding-soundswitch.md file.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/finding-soundswitch-reopen

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

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the FAQ documentation for finding SoundSwitch, clarifying that reopening the application from the Start menu or desktop shortcut will automatically open the settings window. It also expands on the tray icon's capabilities (right-click, double-click, and hover actions). A review comment suggests updating the double-click action description to accurately reflect that it can cycle through either playback or recording devices, depending on the configuration.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread website/src/faq/finding-soundswitch.md Outdated
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 15, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
✅ Deployment successful!
View logs
soundswitch 82de4a1 Jun 15 2026, 01:47 AM

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@Belphemur
Belphemur merged commit 590b247 into dev Jun 15, 2026
9 of 11 checks passed
@Belphemur
Belphemur deleted the docs/finding-soundswitch-reopen branch June 15, 2026 01:47

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR corrects and improves the “Where did SoundSwitch go?” FAQ page in the website docs by clarifying the fastest way to reopen the settings window and by making the tray icon guidance more actionable.

Changes:

  • Updates the frontmatter description and removes the incorrect statement that reopening SoundSwitch won’t restore the settings window.
  • Adds a new top recommendation section explaining that reopening the app will bring the settings back.
  • Expands the tray icon instructions with clear right-click / double-click / hover behaviors and links to the relevant General Settings documentation.

github-actions Bot pushed a commit that referenced this pull request Jun 21, 2026
## [7.1.1-beta.2](v7.1.1-beta.1...v7.1.1-beta.2) (2026-06-21)

### Enhancements

* **tray:** reduce click delay to 250ms, add Disabled double-click option ([aa2c03b](aa2c03b))

### Bug Fixes

* **app-rules:** fallback to glob when regex pattern is invalid ([4672c6b](4672c6b))
* **banner:** prevent focus stealing and fix drag-position/NRE bugs in BannerForm ([feefcd6](feefcd6))
* **banner:** prevent focus stealing in fullscreen games with multi-layer defense ([#2241](#2241)) ([a81f169](a81f169)), closes [#2240](#2240)
* build error and review feedback ([6f4ef44](6f4ef44))
* **build:** avoid CS8417 compiler bug with using var and await using in PlaySoundJob.cs ([9b7e9a9](9b7e9a9))
* clean up doc comments and add dispose idempotency ([366ecb4](366ecb4))
* **installer:** update required .NET version to 10.0.9 in installer scripts ([385819b](385819b))
* **notification:** implement mic mute sound notification and harden PlaySoundJob ([d030236](d030236)), closes [#2187](#2187)
* review feedback improvements ([ddc896f](ddc896f))
* **tray-icon:** add monochrome systray icon option ([05e08e5](05e08e5)), closes [#2029](#2029)
* **website:** finding-soundswitch FAQ — reopening opens settings ([#2221](#2221)) ([590b247](590b247))

### Languages

* **Chinese (Simplified Han script):** Translated Settings using Weblate ([99cb9be](99cb9be))
* **Chinese (Simplified Han script):** Translated Tray Icon using Weblate ([5cb5e90](5cb5e90))
* **French:** Translated Settings using Weblate ([d823469](d823469))
* **Hebrew:** Translated Tray Icon using Weblate ([385e059](385e059))
* **Italian:** Translated Settings using Weblate ([e8dfb91](e8dfb91))
* **Italian:** Translated Settings using Weblate ([0541491](0541491))
* **Italian:** Translated Tray Icon using Weblate ([c83eb2b](c83eb2b))
* **Japanese:** Translated Settings using Weblate ([2bfdf54](2bfdf54))
* **Japanese:** Translated Tray Icon using Weblate ([ba89f4a](ba89f4a))
* **Portuguese (Brazil):** Translated Tray Icon using Weblate ([f18b4dd](f18b4dd))
* **Spanish:** Translated Settings using Weblate ([44bbb0e](44bbb0e))
* **Spanish:** Translated Tray Icon using Weblate ([a38c28c](a38c28c))
* **Spanish:** Translated Update Download using Weblate ([906b4ac](906b4ac))
* **Swedish:** Translated Settings using Weblate ([0696a33](0696a33))
* **Swedish:** Translated Tray Icon using Weblate ([c038b30](c038b30))
github-actions Bot pushed a commit that referenced this pull request Aug 20, 2026
## [7.2.0](v7.1.0...v7.2.0) (2026-08-20)

### Features

* **cli:** add global --json output option and devices command ([44c421a](44c421a))
* **cli:** add status command for active profile and current audio devices ([09f9d77](09f9d77))
* **telemetry:** add feature-usage telemetry via Sentry Metrics ([#2346](#2346)) ([e0a5585](e0a5585))
* **tray-icon:** draw theme-based speaker icon at runtime with Segoe glyph ([7a48f44](7a48f44))
* **tray-icon:** replace monochrome icon with theme-based icon that adapts to Windows dark mode ([1e27c61](1e27c61))

### Enhancements

* Added Toggle Microphone Mute as Double-click Action option ([9fec9f2](9fec9f2))
* **tray:** reduce click delay to 250ms, add Disabled double-click option ([aa2c03b](aa2c03b))

### Bug Fixes

* address PR feedback and release dry-run errors ([fd43a13](fd43a13))
* **app-rules:** fallback to glob when regex pattern is invalid ([4672c6b](4672c6b))
* **banner:** apply display option to notification banners ([5a5c1a9](5a5c1a9)), closes [#2306](#2306)
* **banner:** clear stale image when reusing banner forms ([2a3713c](2a3713c)), closes [#2308](#2308)
* **banner:** Disable layer approach. Banner is staggered. ([638bd1e](638bd1e))
* **banner:** precisely detect true exclusive fullscreen, show banners in borderless windowed ([#2259](#2259)) ([514088d](514088d)), closes [#2240](#2240)
* **banner:** prevent focus stealing and fix drag-position/NRE bugs in BannerForm ([feefcd6](feefcd6))
* **banner:** prevent focus stealing in fullscreen games with multi-layer defense ([#2241](#2241)) ([a81f169](a81f169)), closes [#2240](#2240)
* build error and review feedback ([6f4ef44](6f4ef44))
* **build:** avoid CS8417 compiler bug with using var and await using in PlaySoundJob.cs ([9b7e9a9](9b7e9a9))
* **ci:** add PR merge gate for docs and dotnet checks ([adbef45](adbef45))
* **ci:** address all nightly workflow review comments ([170e38b](170e38b))
* **ci:** define semantic-release branches for dry-run checks ([2674993](2674993))
* **ci:** grant contents write to release-dry-run for semantic-release push check ([03106c9](03106c9))
* **ci:** pin conventionalcommits preset to v9 to restore changelog generation ([47d910a](47d910a)), closes [semantic-release/release-notes-generator#992](semantic-release/release-notes-generator#992)
* **ci:** release stable versions from master branch ([5d47634](5d47634))
* **ci:** scope workflow token permissions ([bb3a56c](bb3a56c))
* **ci:** use semantic-release CLI dry run in PR gate ([ed88743](ed88743))
* clean up doc comments and add dispose idempotency ([366ecb4](366ecb4))
* **cli:** address PR review — JSON output safety, COM disposal, NameClean, failure contract ([3d20e3f](3d20e3f))
* **cli:** cache JsonSerializerOptions static field, address reviewer nitpick ([ea63fbd](ea63fbd))
* **cli:** document empty-string device values in status --json output ([b97b1d7](b97b1d7))
* **common:** avoid icon extractor type-init crash on invalid fallback resources ([01a7a43](01a7a43)), closes [#2243](#2243)
* **device:** allow hotkey to force switch to only configured device ([5fc53d3](5fc53d3)), closes [#2211](#2211)
* Force switch to the only configured device when current Windows default mismatches ([3630da0](3630da0))
* **installer:** bump required .NET runtime to 10.0.11 ([7274b93](7274b93))
* **installer:** update required .NET version to 10.0.9 in installer scripts ([385819b](385819b))
* **notification:** implement mic mute sound notification and harden PlaySoundJob ([d030236](d030236)), closes [#2187](#2187)
* **pipe:** always respond to IPC requests and close startup race ([ec4add7](ec4add7))
* **pipe:** exit accept loop cleanly if shutdown hits during retry delay ([62a752b](62a752b))
* **pipe:** validate message length prefixes and harden accept loop ([27ef90c](27ef90c))
* **profile:** Add reset per-app audio settings on profile switch ([#2262](#2262)) ([d39b88f](d39b88f)), closes [#2258](#2258) [#2258](#2258)
* **profile:** trigger on startup on session change ([85ae6ba](85ae6ba))
* review feedback improvements ([ddc896f](ddc896f))
* **tray-icon:** add monochrome systray icon option ([05e08e5](05e08e5)), closes [#2029](#2029)
* **tray-icon:** prevent TypeInitializationException in SpeakerIconGenerator static cctor ([a559e7b](a559e7b))
* **updater:** handle 4-part version strings for nightly builds ([9b55ab1](9b55ab1)), closes [#2248](#2248)
* **updater:** use last 5 digits of nightly revision as patch version ([1382766](1382766))
* **website:** finding-soundswitch FAQ — reopening opens settings ([#2221](#2221)) ([590b247](590b247))

### Languages

* **Bulgarian:** Translated Settings using Weblate ([f833f4d](f833f4d))
* **Chinese (Simplified Han script):** Translated Settings using Weblate ([99cb9be](99cb9be))
* **Chinese (Simplified Han script):** Translated Settings using Weblate ([e1286cf](e1286cf))
* **Chinese (Simplified Han script):** Translated Tray Icon using Weblate ([5cb5e90](5cb5e90))
* **Dutch:** Translated Settings using Weblate ([a150073](a150073))
* **Dutch:** Translated Settings using Weblate ([dd17cbf](dd17cbf))
* **Dutch:** Translated Settings using Weblate ([f30a384](f30a384))
* **Dutch:** Translated Settings using Weblate ([6174238](6174238))
* **Dutch:** Translated Tray Icon using Weblate ([85084d5](85084d5))
* **Dutch:** Translated Update Download using Weblate ([6eeda3a](6eeda3a))
* **French:** Translated Settings using Weblate ([d823469](d823469))
* **Hebrew:** Translated Tray Icon using Weblate ([385e059](385e059))
* **Italian:** Translated Settings using Weblate ([e8dfb91](e8dfb91))
* **Italian:** Translated Settings using Weblate ([0541491](0541491))
* **Italian:** Translated Tray Icon using Weblate ([c83eb2b](c83eb2b))
* **Japanese:** Translated About using Weblate ([3753e3e](3753e3e))
* **Japanese:** Translated Settings using Weblate ([2bfdf54](2bfdf54))
* **Japanese:** Translated Settings using Weblate ([3d52068](3d52068))
* **Japanese:** Translated Settings using Weblate ([3acc682](3acc682))
* **Japanese:** Translated Settings using Weblate ([50f2037](50f2037))
* **Japanese:** Translated Tray Icon using Weblate ([ba89f4a](ba89f4a))
* **Japanese:** Translated Tray Icon using Weblate ([0479f4e](0479f4e))
* **Japanese:** Translated Update Download using Weblate ([0650f7c](0650f7c))
* **Korean:** Translated Settings using Weblate ([be49871](be49871))
* **Korean:** Translated Settings using Weblate ([eb218c6](eb218c6))
* **localization:** update tray icon option label to Theme Based ([20180f5](20180f5))
* **Portuguese (Brazil):** Translated Settings using Weblate ([b5145af](b5145af))
* **Portuguese (Brazil):** Translated Tray Icon using Weblate ([f18b4dd](f18b4dd))
* **Spanish:** Translated Settings using Weblate ([44bbb0e](44bbb0e))
* **Spanish:** Translated Tray Icon using Weblate ([a38c28c](a38c28c))
* **Spanish:** Translated Update Download using Weblate ([906b4ac](906b4ac))
* **Swedish:** Translated Settings using Weblate ([0696a33](0696a33))
* **Swedish:** Translated Settings using Weblate ([11674cb](11674cb))
* **Swedish:** Translated Settings using Weblate ([7932972](7932972))
* **Swedish:** Translated Tray Icon using Weblate ([c038b30](c038b30))

### Tests

* **cycler:** deterministic single-device tests with proper resource cleanup ([6eecdcc](6eecdcc))
* **downloader:** serve download test from local server instead of blender.org ([b0c5f13](b0c5f13))
@github-actions

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 7.2.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants