PourInput v1.3.4 for macOS

PourInput v1.3.4 for macOS

This is the official macOS release of PourInput v1.3.4.

Downloads

• Apple Silicon (M1 or later): PourInput-1.3.4-macOS-arm64.zip
• Intel Mac: PourInput-1.3.4-macOS-x86_64.zip

SHA-256 files are provided for both archives.

Manual validation

The Intel build was run from the packaged app on a MacBook Air
(MacBookAir9,1) with macOS 15.7.7 and a Logitech MX Master 3 connected over
Bluetooth Low Energy. PourInput started successfully, detected the mouse as
VID 0x046D / PID 0xB023, displayed the correct device name and layout, and
unlocked the mapping UI without an immediate exception.

Both Intel and Apple Silicon builds also passed the repository's automated
tests, QML lint, bundle/resource verification, architecture check, archive
integrity check, and packaged offscreen startup smoke test. Apple Silicon has
not yet been validated on physical hardware.

Installation

1. Download the ZIP for your Mac architecture.
2. Extract PourInput.app.
3. Move it to /Applications if desired.
4. Right-click the app and choose Open.
5. Grant PourInput access under System Settings → Privacy & Security →
   Accessibility when prompted.

Important notes

• This release is not signed with an Apple Developer ID and is not notarized.
  Gatekeeper may warn about or block it according to local policy.
• Generic Mouse Mode remains Windows-only.
• Automatic in-place updates are unavailable on macOS; update checks open the
  release page for manual installation.
• Apple Silicon hardware, disconnect/reconnect behavior, sleep/wake, login
  startup, and the full physical-button matrix still need broader validation.

Build commit: 51634243e47d43884e7f765ae00af06efab5b169

PourInput v1.3.4

PourInput v1.3.4

Release date: 2026-07-19

Repository: pour-soi/PourInput

Highlights

PourInput v1.3.4 completes the device-specific MX Master 3 Back and Forward path on Windows, including native-event suppression, reliable physical-hold state, and packaged screenshot clipboard delivery.

Fixed

• Fixed MX Master 3 Back and Forward mappings still allowing native browser navigation.
• Added targeted suppression of matching Windows XBUTTON events while preserving Generic Mouse Mode separation.
• Fixed transient HID++ empty-state reports splitting one physical hold into multiple logical presses.
• Physical release is now confirmed using the matching Windows XBUTTON UP event.
• Fixed full-screen screenshot-to-clipboard delivery in packaged Windows builds using durable native CF_DIB.
• Prevented duplicate screenshot actions during a continuous side-button hold.
• Improved persistent diagnostics for HID++, suppression, action execution, screenshot capture, and clipboard delivery.

Hardware validation

• Verified with a real Logitech MX Master 3 connected over Bluetooth with Generic Mouse Mode disabled.
• Confirmed Back CID 0x0053 and Forward CID 0x0056 reach their independent selected actions while matching native browser events remain suppressed.
• Confirmed a continuous Forward hold produces one logical DOWN, one action, no premature release, and one logical UP after the matching Windows XBUTTON UP.
• Confirmed full-screen screenshots remain available as native CF_DIB clipboard data and paste successfully into Paint.
• Logitech receiver transport has not yet been validated.
• Logitech Options and Options+ coexistence has not yet been validated.

Compatibility

• Windows remains the only official public release target.
• Existing profiles, configuration storage, input timing, supported devices, and updater behavior remain compatible.
• Generic Mouse Mode continues to support Middle Button, Side Button 1 (Back), and Side Button 2 (Forward).

Checksums

The official Windows ZIP SHA-256 is provided in PourInput-v1.3.4-Windows.zip.sha256 and in pourinput-v1.3.4-update.json.

PourInput v1.3.3

PourInput v1.3.3

Release date: 2026-07-19

Repository: pour-soi/PourInput

Highlights

PourInput v1.3.3 fixes device-specific Back and Forward shortcut editing for the Logitech MX Master 3 on Windows.

Fixed

• Fixed MX Master 3 Back and Forward shortcut changes not taking effect.
• Added a dedicated Logitech HID++ route for Back CID 0x0053 and Forward CID 0x0056.
• Fixed a reconnect loop caused by adding and removing side-button HID++ diverts during connection refresh.
• Device-specific mappings now remain separate from Generic Mouse Mode.
• Side-button mappings apply immediately, remain profile-specific, and persist after restart.

Hardware validation

• Verified with a real Logitech MX Master 3 connected over Bluetooth with Generic Mouse Mode disabled.
• Confirmed Back CID 0x0053 and Forward CID 0x0056 reach their independent selected actions through the dedicated Logitech HID++ route.
• Logitech receiver transport has not yet been validated.
• Logitech Options and Options+ coexistence has not yet been validated.

Compatibility

• Windows remains the only official public release target.
• Existing profiles, configuration storage, input timing, supported devices, and updater behavior remain compatible.
• Generic Mouse Mode continues to support Middle Button, Side Button 1 (Back), and Side Button 2 (Forward).

Checksums

The official Windows ZIP SHA-256 is provided in PourInput-v1.3.3-Windows.zip.sha256 and in pourinput-v1.3.3-update.json.

PourInput v1.3.2

PourInput v1.3.2

Release date: 2026-07-17

Repository: pour-soi/PourInput

Highlights

PourInput v1.3.2 is a maintenance release focused on reliable Windows side-button mapping, startup and tray stability, and clearer multilingual presentation.

Fixed

• MX Master 3 Back and Forward mappings now use the active Generic Mouse Mode route selected in the UI.
• The application starts correctly with the required Qt slot integration.
• Reopening the main window from the system tray no longer emits a QML focus error.
• Windows side-button handling is more robust during mapping changes, reconnects, queue pressure, and shutdown.
• Locale-aware font fallback and translated labels are more consistent across the interface.

Hardware validation

• Verified with a real Logitech MX Master 3 connected over Bluetooth.
• Logitech receiver transport has not yet been validated.
• Logitech Options and Options+ coexistence has not yet been validated.

Compatibility

• Windows remains the only official public release target.
• Existing profiles, mappings, configuration storage, input timing, supported devices, and updater behavior remain compatible.
• Generic Mouse Mode continues to support Middle Button, Side Button 1 (Back), and Side Button 2 (Forward).

Checksums

The official Windows ZIP SHA-256 is provided in PourInput-v1.3.2-Windows.zip.sha256 and in pourinput-v1.3.2-update.json.

PourInput v1.3.1

PourInput v1.3.1

Release date: TBD

Repository: pour-soi/PourInput

Highlights

PourInput v1.3.1 is a maintenance release focused on localization consistency, clearer Generic Mouse button labels, and improved bilingual project documentation.

Fixed

• Generic Mouse labels and action summaries now refresh consistently when switching languages.
• Side Button 1 is presented as Back and Side Button 2 as Forward without changing their physical button IDs or saved mappings.
• Remaining fallback device, default profile, fallback note, and About build-mode labels are localized at render time.

Documentation

• Improved the GitHub repository homepage.
• Added dedicated English and Simplified Chinese screenshot sets.
• Updated screenshot guidance and Windows packaging references for the bilingual assets.

Compatibility

• Windows remains the only official public release target.
• Existing profiles, mappings, configuration storage, input timing, supported devices, and updater behavior remain compatible with v1.3.0.
• Generic Mouse Mode continues to support Middle Button, Side Button 1 (Back), and Side Button 2 (Forward).

Checksums

The official Windows ZIP SHA-256 is provided in PourInput-v1.3.1-Windows.zip.sha256 and in pourinput-v1.3.1-update.json.

PourInput v1.3.0

PourInput v1.3.0 — Visual System and Architecture

Release date: TBD

Repository: pour-soi/PourInput

Maintainer: pour-soi

English

PourInput v1.3.0 gives the application and project a cohesive visual identity while keeping its input, remapping, device, and profile behavior unchanged.

Highlights

• A redesigned desktop interface with a consistent PourInput visual system, refined navigation, spacing, typography, controls, profiles, settings, and light/dark themes.
• Finalized PourInput branding across the Windows executable, macOS and Linux application assets, tray presentation, About view, and repository homepage.
• A complete design-system documentation set covering shared tokens, components, brand assets, screenshots, and visual release checks.
• A complete architecture documentation set covering runtime ownership, event flow, mappings, profiles, settings, state management, QML structure, and project layout.
• Simplified, aligned English and Simplified Chinese README pages with a clearer Windows download path.

This release does not intentionally change mouse input handling, mappings, action execution, device capabilities, profile behavior, updater behavior, or supported platforms.

简体中文

PourInput v1.3.0 为应用程序和项目建立了统一的视觉识别，同时保持输入、重映射、设备与配置文件行为不变。

主要内容

• 重新设计桌面界面，统一 PourInput 视觉系统，并优化导航、间距、字体、控件、配置文件、设置以及明暗主题。
• 完成 Windows 可执行文件、macOS 与 Linux 应用资源、托盘、关于页面和仓库主页中的 PourInput 品牌统一。
• 新增完整的设计系统文档，包括共享设计变量、组件、品牌资源、截图规范和视觉发布检查表。
• 新增完整的架构文档，包括运行时职责、事件流、映射、配置文件、设置、状态管理、QML 结构和项目目录。
• 简化并对齐英文和简体中文 README，提供更清晰的 Windows 下载路径。

此版本不会有意更改鼠标输入处理、映射、动作执行、设备能力、配置文件行为、更新行为或支持的平台。

Release Policy

Windows is the only official public release target for v1.3.0.

The public GitHub Release should contain only:

• PourInput-v1.3.0-Windows.zip
• PourInput-v1.3.0-Windows.zip.sha256
• pourinput-v1.3.0-update.json

macOS and Linux CI/build validation may remain, but public macOS and Linux packages are not part of the official v1.3.0 release.

Validation

The release candidate is expected to pass:

• The full automated test suite.
• Windows PyInstaller packaging and executable startup checks.
• SHA-256 verification of the uploaded Windows archive.
• Version and build-metadata checks inside the packaged application.
• Documentation-link and release-asset audits.
• The PourInput visual release checklist against the candidate build.

Known Limitations

• Windows remains the only official release target.
• Generic Mouse Mode is Windows-only and supports Middle Button, Side Button 1, and Side Button 2.
• Generic Mouse Mode cannot currently distinguish multiple standard mice by physical source device.
• Device support depends on firmware, operating-system exposure, and HID++ features.
• Long-press timeout is fixed at 300 ms; double-click, macros, and sequential actions are not implemented.

PourInput v1.2.1 — Generic Mouse Status Fix

PourInput v1.2.1 — Generic Mouse Status Fix

Release date: 2026-07-09

Repository: pour-soi/PourInput

Based on: TomBadash/Mouser

Maintainer: pour-soi

English

PourInput v1.2.1 is a small patch release for the device status shown when Generic Mouse Mode is active.

Generic Mouse Mode functionality itself was already working: a standard mouse could use configured Generic Mouse Mode actions without a supported Logitech mouse. The issue was that the Mouse page status badge still reported the device as disconnected because it only reflected supported Logitech HID++ connection state.

This release keeps Logitech device detection separate from Generic Mouse Mode readiness:

• Supported Logitech device connected: Connected — <device name>
• No supported Logitech device and Generic Mouse Mode enabled: Generic Mouse Mode Ready
• No supported Logitech device and Generic Mouse Mode disabled: No supported mouse detected

Generic Mouse Mode still does not identify a specific physical standard mouse. It does not claim a standard mouse name or per-device identity.

No input, remapping, hook, blocking, button support, Logitech HID++, or localization-scope behavior changed in this release.

简体中文

PourInput v1.2.1 是一个小型补丁版本，修正通用鼠标模式启用时鼠标页面显示的设备状态。

通用鼠标模式本身此前已经可以正常工作：即使没有受支持的 Logitech 鼠标，普通鼠标也可以通过通用鼠标模式使用已配置的操作。问题在于鼠标页面的状态标签只反映受支持 Logitech HID++ 设备的连接状态，因此会误显示为未连接。

此版本将 Logitech 设备连接状态与通用鼠标模式就绪状态分开显示：

• 已连接受支持的 Logitech 设备：已连接 — <device name>
• 没有受支持的 Logitech 设备，但已启用通用鼠标模式：通用鼠标模式已就绪
• 没有受支持的 Logitech 设备，且未启用通用鼠标模式：未检测到受支持的鼠标

通用鼠标模式仍然不会识别某一只具体的普通鼠标，也不会显示虚构的标准鼠标名称或物理设备身份。

此版本没有改变输入、重映射、鼠标钩子、事件阻止、按键支持、Logitech HID++ 或本地化范围。

Release Policy

Windows remains the only official release target for v1.2.1.

The public GitHub Release should contain only:

• PourInput-v1.2.1-Windows.zip
• pourinput-v1.2.1-update.json

macOS and Linux CI/build validation may remain, but public macOS and Linux release packages are not part of the official v1.2.1 release.

Validation

This patch release is covered by focused tests for:

• Backend device status states.
• Generic Mouse Mode status transitions.
• Locale manager translations.
• QML policy coverage for the status labels.
• Update/version behavior.

Known Limitations

• Windows remains the only official release target.
• Generic Mouse Mode is Windows-only.
• Generic Mouse Mode supports Middle Button, Side Button 1, and Side Button 2 only.
• Generic Mouse Mode cannot currently distinguish multiple standard mice by physical source device.
• Device support still depends on firmware, operating system exposure, and HID++ features.

PourInput v1.2.0 — Generic Mouse Mode

English | 简体中文

English

Version Summary

PourInput v1.2.0 adds Generic Mouse Mode for standard Windows mouse buttons and completes the English / Simplified Chinese application and GitHub documentation experience.

Generic Mouse Mode is Windows-only, disabled by default, and enabled manually in Settings. It works without a connected supported Logitech mouse and supports Middle Button, Side Button 1, and Side Button 2 with separate Click Action and Long Press Action mappings.

The application can switch the visible UI between English and Simplified Chinese immediately from Settings. English remains the default when no saved preference exists, and the selected language is saved and restored on the next launch.

Highlights

• Added Generic Mouse Mode for standard Windows middle and side-button events.
• Added Middle Button support.
• Added Side Button 1 and Side Button 2 support.
• Added Click + Long Press Multi-Action support for all three generic buttons.
• Generic Mouse Mode works without a connected supported Logitech mouse.
• Generic Mouse Mode is disabled by default and enabled manually in Settings.
• Added English / Simplified Chinese application UI switching with immediate visible UI updates.
• Added persistent saved language preference.
• Completed the Simplified Chinese application UI.
• Completed the Simplified Chinese GitHub documentation.

Generic Mouse Mode

• Generic Mouse Mode is Windows-only.
• It supports Middle Button, Side Button 1, and Side Button 2.
• All three supported buttons support Click Action and Long Press Action.
• Existing Logitech-specific controls remain available without duplicate middle-button or side-button entries.
• Multiple standard mice cannot currently have separate generic mappings because standard Windows mouse events are not distinguished by physical source device.
• Left-button remapping, right-button remapping, scroll up/down remapping, and arbitrary extra mouse buttons are not supported by Generic Mouse Mode.

Language Support

• Supported application languages are English and 简体中文.
• English remains the default when no saved preference exists.
• The selected language is saved and restored on the next launch.
• Language switching changes visible UI labels without changing internal action IDs, button keys, mappings, or profile data.
• Existing user mappings remain compatible.

Reliability Fixes

• Corrected Generic Mouse Mode button visibility without a Logitech connection.
• Restored correct runtime Generic Mouse Mode OFF behavior: disabling the mode removes generic mouse callbacks and blocking, returning buttons to native middle-click and Back / Forward behavior.
• Prevented stale XBUTTON interception after Generic Mouse Mode is disabled.
• Corrected Generic Mouse Mode CI regression coverage across platforms.

Release Platform

Windows remains the only official release target for v1.2.0.

The public GitHub Release contains only:

• PourInput-v1.2.0-Windows.zip
• pourinput-v1.2.0-update.json

macOS and Linux CI/build validation may remain, but public macOS and Linux release packages are not part of the official v1.2.0 release.

Known Limitations

• Windows remains the only official release target.
• Generic Mouse Mode is Windows-only.
• Generic Mouse Mode supports Middle Button, Side Button 1, and Side Button 2 only.
• Generic Mouse Mode cannot currently distinguish multiple standard mice by physical source device.
• Device support still depends on firmware, operating system exposure, and HID++ features.
• Some devices may be detected but expose only partial controls.
• Double Click is planned but not implemented yet.
• Long Press timeout defaults to 300 ms and is not editable in the UI yet.
• Macro support and sequential actions are not implemented yet.

Download Instructions

Download PourInput-v1.2.0-Windows.zip from this release, extract the archive, then run PourInput.exe from the extracted folder.

简体中文

版本概要

PourInput v1.2.0 新增了面向 Windows 标准鼠标按键的通用鼠标模式（Generic Mouse Mode），并完成了 English / 简体中文应用界面切换和 GitHub 文档的中文支持。

通用鼠标模式仅支持 Windows，默认关闭，需要在设置中手动启用。该模式不需要连接受支持的 Logitech 鼠标，可以为中键、侧键 1 和侧键 2 分别设置单击操作和长按操作。

应用现在可以在设置中即时切换 English 和 简体中文。没有保存偏好时默认使用 English，用户选择的语言会保存，并在下次启动时恢复。

主要更新

• 新增适用于 Windows 标准中键和侧键事件的通用鼠标模式。
• 新增中键支持。
• 新增侧键 1 和侧键 2 支持。
• 中键、侧键 1、侧键 2 均支持单击 + 长按的多操作（Multi-Action）映射。
• 通用鼠标模式无需连接受支持的 Logitech 鼠标即可使用。
• 通用鼠标模式默认关闭，需要在设置中手动启用。
• 新增 English / 简体中文 应用界面切换，切换后可见界面会立即更新。
• 新增语言偏好保存和启动时恢复。
• 完成简体中文应用界面。
• 完成简体中文 GitHub 文档。

通用鼠标模式

• 通用鼠标模式仅支持 Windows。
• 支持中键、侧键 1、侧键 2。
• 三个受支持按键都可以分别配置单击操作和长按操作。
• 现有 Logitech 专用控件仍然可用，不会产生重复的中键或侧键条目。
• 多只标准鼠标目前还不能分别设置不同的通用映射，因为标准 Windows 鼠标事件不会区分事件来自哪一只物理鼠标。
• 通用鼠标模式不支持左键重映射、右键重映射、滚轮上/下滚动重映射或任意额外鼠标按键。

软件语言支持

• 支持的应用语言为 English 和 简体中文。
• 没有保存偏好时默认使用 English。
• 选择的语言会保存，并在下次启动时恢复。
• 语言切换只改变可见界面文本，不会改变内部动作 ID、按键键名、映射或配置文件数据。
• 现有用户映射保持兼容。

稳定性修复

• 修正未连接 Logitech 鼠标时通用鼠标模式按键显示不正确的问题。
• 修正运行时关闭通用鼠标模式后的行为：关闭后会移除通用鼠标回调和拦截，让中键点击和浏览器后退 / 前进恢复原生行为。
• 防止关闭通用鼠标模式后仍残留 XBUTTON 拦截。
• 修正跨平台 CI 回归测试覆盖。

发布平台

v1.2.0 的官方发布平台仅限 Windows。

公开 GitHub Release 只包含：

• PourInput-v1.2.0-Windows.zip
• pourinput-v1.2.0-update.json

macOS 和 Linux 的 CI / 构建验证可以继续保留，但公开发布资产中不包含 macOS 或 Linux 安装包。

已知限制

• Windows 仍然是唯一官方发布平台。
• 通用鼠标模式仅支持 Windows。
• 通用鼠标模式目前只支持中键、侧键 1 和侧键 2。
• 通用鼠标模式目前无法区分多只标准鼠标的物理来源，因此不能为多只标准鼠标分别设置不同映射。
• 设备支持仍取决于固件、操作系统暴露的信息和 HID++ 能力。
• 部分设备可能可以被检测到，但只暴露部分控制能力。
• 双击操作已规划，但尚未实现。
• 长按判定时间默认为 300 ms，暂时不能在界面中配置。
• 宏和连续动作尚未实现。

下载说明

请下载 PourInput-v1.2.0-Windows.zip，先解压这个压缩包，然后从解压后的文件夹中运行 PourInput.exe。

PourInput v1.1.0 — Capability-Based Device Support

PourInput v1.1.0 – Capability-Based Foundation

This release introduces the foundation for a more scalable Logitech HID++ architecture.

Highlights

• 🚀 Introduced a capability-based architecture for Logitech HID++ devices.
• 🖱️ Shifted from model-specific logic toward runtime capability discovery where appropriate.
• 🔋 Unified battery, DPI, Smart Shift, gesture, and button support behind a common capability system.
• 🛡️ Added safer fallback behavior for compatible Logitech HID++ devices.
• 📦 Improved release packaging and versioned release asset generation.

Notes

• MX Master 3 remains the primary validated device.
• The new architecture lays the foundation for broader Logitech HID++ device support in future releases.

Looking Ahead

Future releases will focus on:

• Additional Logitech mouse support
• Expanded capability coverage
• Enhanced Easy-Switch features
• Continued architecture cleanup and refinement

PourInput v1.0.0 — Initial Release

🎉 PourInput v1.0.0

This is the first official release of PourInput.

Highlights

• Rebranded the project as PourInput.
• Added a generic Multi-Action framework.
• Supports independent Click and Long Press actions for supported mouse buttons.
• Improved Mode Shift event detection for better stability and compatibility.
• Updated application branding, executable, packaging, documentation, and project metadata.
• Windows release package is now distributed as PourInput.

Notes

This release focuses on establishing PourInput as an independent project while preserving existing functionality and compatibility. It also lays the foundation for future enhancements, including additional button actions and multi-device features.

Acknowledgements

Special thanks to the original Mouser project for providing the foundation that made this work possible. PourInput will continue to build upon that foundation with new features, improvements, and ongoing development while respecting and acknowledging its upstream origins.