## Problem and outcome The App console could show a launch address that still contained private activation data when copied, while the terminal hyperlink opened a cleaned address. On narrow phones, playback controls could wrap into a second row and cover too much of the video. The handoff now presents the same safe, activation-preserving address everywhere, and the playback bar keeps one compact row with a shorter flexible volume control. ## Changes - Sanitize the App activation URL before rendering both copyable console output and terminal hyperlinks, preserving App handoff without exposing credentials. - Keep the mobile playback bar on one row; let the volume slider shrink with the available width and hide the nonessential percentage readout at the narrowest sizes. - Add bilingual macOS browser/App audio-capture troubleshooting guidance and record the physical-device boundary. ## Verification - `npm run check`: TypeScript, 73 test files / 1008 tests, and the Web production build passed. - `npm run check:go-core`: Go tests, formatting, vet and supported core target builds passed. - `node scripts/check-docs.mjs` and `scripts/check-project-state.ps1` passed. - Narrow-layout browser checks covered 320px, 360px, 375px, 390px, 430px, 768px and 1280px widths without wrapping or horizontal overflow. - The interaction prototype remains local and uncommitted for later acceptance; it is not part of this PR. ## Release notes ### 中文 这是一个维护版本,改善 App 启动链接的安全提示和手机上的播放控制体验。 #### 修复 - 修复 App 控制台复制链接时可能带出私有激活参数的问题。复制、终端链接和手动打开地址现在保持一致,并继续支持自动唤起 App。 - 修复窄屏手机上的播控挤成两行、遮挡画面的问题。控件保持单行,音量滑条会按可用空间缩短,过窄时隐藏非关键的百分比读数。 - 补充 macOS 浏览器与 App 采集声音选项的排查说明,明确不同浏览器和系统版本的能力边界。 #### 兼容性 本版本不改变通信协议、配置格式或存储格式。App 公网邀请、本地模式和已部署站点按原方式更新即可;已打开的页面刷新后使用新的播控布局。 ### English This maintenance release improves App launch links and playback controls on phones. #### Fixes - Fixed the App console sometimes exposing private activation parameters in a copied launch address. The copied address, terminal hyperlink and manual URL now match while still supporting App handoff. - Fixed narrow phone layouts wrapping playback controls into a second row and covering the video. Controls stay on one row, the volume slider shrinks with the available space, and the nonessential percentage readout hides when space is tight. - Added macOS troubleshooting guidance for browser and App audio capture, including the current browser and OS support boundaries. #### Compatibility This release changes no wire protocol, configuration format or storage format. Update the App for public invitations or Local mode, or update the deployed site as usual; refresh an open page to use the new playback layout.
Piik documentation
Share your screen with friends, or open their invitation to watch in your browser. Choose a guide for what you want to do.
Start using Piik
| I want to… | Start here |
|---|---|
| Watch a friend | Open an invitation; no installation needed. |
| Share my screen | Download Piik App, then follow the App steps. |
| Use Piik without installing | Open the online site and follow the online guide. |
| Use my group's Piik site | Connect the App or share in a browser. |
| Understand App options | Modes, platform requirements and diagnostics. |
Get help
Troubleshooting covers sound, screen sources, startup and playback. If the page opens but the picture will not connect, start with connection troubleshooting.
Still stuck? Report a problem with your version, system, browser and reproduction steps. The diagnostic guide explains how to collect useful reports.
Run a site for your group
Self-hosting is an advanced option requiring a server, domain and network configuration.
- Deploy Piik Server with Docker Compose or the server package.
- Keep it running and update.
- Look up configuration settings.
Help improve Piik
Translate Piik, contribute, or explore the developer and maintainer documentation.