This release adds microphone processing controls and local chat controls, expands platform packages, and synchronizes the website and guides. It also fixes native H.264 input/format handling, signaling recovery, fresh STUN discovery, and UDP ownership during overlapping connections. This is **v1.8.0**. Browser/Server v23, Native control v9 and capture v7 remain unchanged, with the existing 1440p ceiling. Additional resolutions, capability negotiation and Magicsock are separate follow-up work. ## Validation - Full local Web check: 79 files / 1,317 tests, TypeScript and production build. - Full Go checks, platform builds and Windows native capture regressions/probe. - Native H.264 Host lifecycle, Browser-to-App fanout and App-exit recovery, and Native H.264 through embedded SFU: all passed with owned process/port/profile cleanup. - Website build, documentation and repository hygiene passed. Existing UI acceptance covers narrow screens, both languages/themes, architecture downloads and all 23 film checks; final packaging and Go race checks run on the merged revision in CI. - Physical macOS/Linux capture, representative public networks and unmatched field reports retain their documented evidence limits. No claim that every blur/disconnection report is resolved. ## Release notes ### 中文 这是一次功能与兼容性更新:麦克风和聊天增加了实用的小选项,App 与 Server 支持更多设备,同时修复了原生分享和连接恢复中的若干问题。现有 1.x 协议保持不变。 #### 新增与改进 - 浏览器麦克风新增「降噪与回声消除」开关,默认开启回声消除、降噪和自动增益;分享音乐或使用虚拟音频输入时,可按需关闭。 - 可调整弹幕字号和透明度,并将当前保留的聊天记录导出为 TXT。当前会话最多保留 1,000 条文字消息,刷新页面后清空;需要保存时请先导出。 - 新增 Intel Mac、Linux ARM64 App,以及 Linux ARM64 Server 和容器镜像。官网下载区可直接选择对应架构,并显示最新版本和发布时间。 - 更新官网演示、README 截图和中英文教程,明确浏览器分享也可选择窗口或屏幕;开始分享前显示房间号占位,保持底栏控件位置稳定。 - 官网新增直达问题排查的入口,补充浏览器 WebRTC 限制、校园网和 Windows 显卡相关的排查步骤。 - App 模式选择页显示免费开源说明、作者与贡献者署名,以及官方网站和源码链接。 #### 修复 - 修正部分 H.264 原生分享的格式兼容性校验,以及 Windows 编码器输入长度和输出缓冲区对齐问题。 - 清理已失效的重连任务和 Native 接收信令,避免旧连接继续影响当前会话。 - 修复 App 重连时可能复用过期公网地址的问题;重新探测使用当前地址,并处理探测丢包和过期响应,保留其他正常连接。 - 修复 App 新旧媒体连接重叠时共用端口造成的冲突,避免准备或撤销新连接打断仍在使用的画面;关闭连接时及时取消未完成的端口映射请求。 - 无站点密码时,连接恢复不再误引导用户输入站点密码。 - 房间失效或会话终止时,开播前后的原因提示统一显示在电视状态图标中,避免额外提示条。 - 修正 Linux 原生采集的时间戳与关键帧时间基准。感谢 Pedro Antonio 在 [#449](https://github.com/TNTcraftHIM/Piik/pull/449) 的贡献。 #### 使用说明 下载对应平台的完整压缩包,退出旧 App 后解压使用。Windows 继续提供 x64;macOS 提供 Apple 芯片与 Intel 版本,原生采集需要 macOS 13 或更新版本。Linux 提供 x64 与 ARM64,原生采集还需安装[系统组件](https://github.com/TNTcraftHIM/Piik/blob/main/native/capture/linux/README.md)。macOS 和 Linux 的实机覆盖仍有限,欢迎反馈。 ### English This update adds useful microphone and chat controls, brings Piik to more devices, and fixes several native-sharing and connection-recovery issues. The existing 1.x protocols remain unchanged. #### New and improved - Browser microphones now have a “Noise & echo reduction” toggle. Echo cancellation, noise suppression and automatic gain control are on by default; turn them off when appropriate for music or virtual audio inputs. - Adjust chat-overlay text size and opacity, and export retained messages as TXT. The current session keeps up to 1,000 text messages and clears on page refresh; export first if you want to keep them. - Added Intel Mac and Linux ARM64 App packages, plus Linux ARM64 Server and container images. The website provides architecture selectors and shows the latest release and publication date. - Updated the website demonstration, README screenshots and bilingual guides, clarifying that browser capture can also select windows or screens. A room-code placeholder keeps the bottom bar stable before sharing starts. - Added direct website links to troubleshooting, with steps for browser WebRTC restrictions, campus networks and Windows graphics issues. - The App mode-selection page now shows its free and open-source status, author and contributor credit, and links to the official website and source. #### Fixes - Corrected H.264 format compatibility checks and Windows encoder input-length and output-buffer alignment handling. - Retired stale reconnect tasks and Native receive signals so they cannot continue affecting the current session. - Fixed App reconnection reusing an expired public address. Fresh discovery handles lost probes and stale responses while preserving other working connections. - Fixed UDP socket conflicts between overlapping App media connections so preparing or canceling a replacement preserves the active picture. Closing a connection now cancels unfinished gateway mapping requests. - Connection recovery on passwordless sites no longer incorrectly asks for a site passphrase. - Expired-room and session-termination reasons now use the same TV status indicator before and during sharing, without an extra notice strip. - Corrected Linux native capture timestamps and keyframe time bases. Thanks to Pedro Antonio for [#449](https://github.com/TNTcraftHIM/Piik/pull/449). #### Updating Download the complete archive for your platform, quit the old App, and extract the new package. Windows remains x64-only. macOS packages support Apple silicon and Intel; native capture requires macOS 13 or newer. Linux supports x64 and ARM64 and requires additional [system components](https://github.com/TNTcraftHIM/Piik/blob/main/native/capture/linux/README.md) for native capture. Physical-device coverage on macOS and Linux remains limited; feedback is welcome. ## Attribution Co-authored-by: Pedro Antonio <wrenchwastaken@gmail.com>
137 lines
8.1 KiB
Markdown
137 lines
8.1 KiB
Markdown
# Current Status
|
|
|
|
Last updated: 2026-10-04
|
|
|
|
This is the compact execution/deployment index. Product modules own behavior,
|
|
[verification status](./verification-status.md) owns unresolved physical limits,
|
|
and Git/PRs own completed history.
|
|
|
|
## Accepted Release Contract
|
|
|
|
- Browser/server v23, Native control v9 and capture v7 form the current contract.
|
|
[Versioning](./standards/versioning.md#public-compatibility-promise) owns
|
|
compatibility between published Web/App/Server versions.
|
|
- Hosted Server defaults to SQLite schema 2. Room authority has no inactivity
|
|
expiry; explicit replacement/deletion or grant rotation/revocation ends the
|
|
corresponding authority. Explicit memory mode and App Local end rooms at
|
|
process exit. Site access retains its separate 24-hour idle lifetime within
|
|
one service run; service restart requires site-password entry again.
|
|
- Browser/App entry lifecycle and current-edge reconnect ownership repairs
|
|
are implemented. Browser node-local pooling and detailed local Debug export
|
|
remain part of the accepted media surface. Product modules own their behavior;
|
|
[configuration](./standards/configuration.md#diagnostics) owns Debug activation,
|
|
report contents and disclosure.
|
|
- Shared feedback composition is implemented: generic loading uses the wink
|
|
mascot, concrete media waits use their owning comic, and waiting captions are
|
|
secondary to literal status. Website reduced-motion preference and player
|
|
tooltip placement follow the same presentation owners.
|
|
- Camera sharing and Host microphone commentary are accepted product features.
|
|
Both Browser and native App audio use the existing media routes; device
|
|
selection and sharing settings keep their current resource owners. The
|
|
[capture assessment](./research/camera-and-microphone.md) owns platform behavior
|
|
and the remaining physical evidence limits.
|
|
|
|
Website delivery includes a bilingual reader documentation center generated
|
|
from the repository's guides alongside the homepage, with search and detailed
|
|
troubleshooting separate from the homepage FAQ.
|
|
|
|
## Accepted Interaction Phase
|
|
|
|
The accepted [room-interaction design](./research/room-interactions.md) includes
|
|
the verified media repairs. It adds authenticated text and reactions
|
|
over existing signaling, with optional local chat overlay and a shared floating
|
|
panel. Its opted-in room session can outlive a publication; capture, quality and
|
|
route owners remain unchanged. Optional Windows screen-audio exclusion uses the
|
|
existing source/mixer boundary. Hosted Server
|
|
also accepts an optional SFU-only policy through the same route controller.
|
|
Windows native capture and thumbnails now share automatic HDR-to-SDR conversion;
|
|
synthetic GPU and Browser reception checks pass, with physical HDR display
|
|
acceptance still pending in [verification status](./verification-status.md).
|
|
Room voice is outside the product plan; Host microphone commentary remains.
|
|
These features are published; physical device limits remain open.
|
|
Release artifacts and operator deployment records own delivery completion;
|
|
[TODO](./todo.md#now) owns remaining work.
|
|
|
|
## Current Candidate
|
|
|
|
The owner authorized v1.8.0 publication on 2026-10-04. This phase retains the
|
|
published protocols and 1440p ceiling; immutable release artifacts own delivery
|
|
completion. Follow-up work reviews extension boundaries, implements 4K and more
|
|
resolutions with capability negotiation, then develops Native Magicsock NAT
|
|
traversal. The isolated transport experiment is not part of v1.8.0; its product
|
|
integration and connectivity benefit still require verification.
|
|
[TODO](./todo.md#now) owns remaining work and later release authorization.
|
|
|
|
## Deployment
|
|
|
|
Source, package identity, GitHub repository and local worktree paths use Piik.
|
|
Runtime code keeps only the Piik wire labels and stored keys.
|
|
The immutable release descriptor, runtime `REVISION` and operator deployment
|
|
record own exact identity and postflight results.
|
|
|
|
The existing deployment uses one Go process for Web, room authority/signaling,
|
|
Binding-only STUN on UDP 3478/3479/3480 and optional SFU on UDP 7882. nginx owns
|
|
HTTPS; external LiveKit/coturn services remain disabled. Participants, routes and
|
|
media remain process-only. This private service is not a public demonstration.
|
|
|
|
The separate US [public demo](https://demo.piik.tv) is deployed with open site
|
|
entry, persistent room authority and P2P-only media. Cloudflare fronts HTTP/WSS
|
|
and caches static bundles; STUN uses a separate DNS-only hostname. Caddy owns
|
|
origin HTTPS, and the standard systemd service runs the published Server package.
|
|
Public DNS,
|
|
HTTPS, runtime assets, all three STUN listeners and a bounded browser P2P
|
|
sharing/stop check passed; the browser check used synthetic video on one network.
|
|
The operator record owns exact identity and postflight evidence.
|
|
|
|
[TODO](./todo.md) owns remaining verification and follow-up work. The owner declared the first
|
|
public release on 2026-09-12. Source is public, main protection is active, and
|
|
`piik.tv` runs on GitHub Pages behind Cloudflare with HTTPS. The private service
|
|
remains a separate deployment. Release descriptors and GitHub deployment records
|
|
identify published artifacts and website revisions.
|
|
|
|
The matching Server and three App packages are published on GitHub and Gitee;
|
|
anonymous mirror downloads match the original checksums. Public-repository CI
|
|
and native packaging passed. App entry, update links
|
|
and bounded two-build interoperability have acceptance evidence. Accepted
|
|
product changes publish automatically; standalone website and documentation
|
|
changes validate and deploy the website without creating App/Server versions.
|
|
GitHub/Gitee release comparison, mirror publishing and PR-sourced notes follow
|
|
[versioning](./standards/versioning.md). [Verification status](./verification-status.md#device-evidence-boundary)
|
|
owns the remaining physical limits; shared lessons live in
|
|
[engineering](./standards/engineering.md).
|
|
|
|
## Media Evidence And Limits
|
|
|
|
- Compatible Native consumers share one complete stock WebRTC encoding and
|
|
adaptation pipeline per local output. Different weak demands stay independent;
|
|
suitable received media can be forwarded without decoding/re-encoding.
|
|
Pion/LiveKit retain transport, estimation, pacing and forwarding ownership.
|
|
- Windows H264/VP8 have bounded encoding/adaptation evidence. Actual Native
|
|
relay checks cover compatible sharing, weak-budget separation and rejoining,
|
|
source retirement and large encoded-frame delivery. These results do not
|
|
establish a universal encoder count, CPU saving or Browser-equivalent quality.
|
|
- Windows Host acceptance covers live and paused settings, quiet-source
|
|
preparation/restore, source changes and subsequent sharing. The owner
|
|
confirmed Windows 10 whole-display capture resolved. Specific new game/device
|
|
failures should be reopened from new evidence.
|
|
- Native Host publication through embedded SFU retains video/audio; Browser to
|
|
App fanout and App-exit fallback have bounded physical checks. Two
|
|
independent Native sessions have simultaneous media/retirement evidence.
|
|
- The Linux runtime container has non-root/read-only, memory/SQLite, diagnostic
|
|
export, STUN and listener-lifecycle evidence. This does not establish every
|
|
operator's proxy/firewall or public-media configuration.
|
|
- The independent Browser producer in ADR-0014 is integrated.
|
|
Bounded H264/VP8 checks cover direct and received-track sharing, weak-child
|
|
isolation/recovery, live/quiet settings, pause, source change and ordinary
|
|
fallback. Its native allocation and complete-frame output replace the earlier
|
|
payload-only Worker path. Fewer full encodes are established; total CPU gains
|
|
depend on codec/hardware. [Browser research](./research/browser-local-encoding-pool.md)
|
|
owns these measurements and failed controls. The owner accepted this scoped
|
|
Browser composition for release; actual deployment identity stays in the
|
|
runtime descriptor.
|
|
- Slow adaptation recovery, the extreme CPU-overload sampling limit and missing
|
|
broad device/network/endurance results remain explicit in
|
|
[encoder research](./research/webrtc-encoder-pool.md) and verification status.
|
|
macOS/Linux physical capture is deferred by the owner; Windows App and
|
|
Browser are this phase's primary targets.
|