K380 Fn

一个原生 macOS 状态栏小工具，用来切换 Logitech K380 顶部按键的默认行为。
A native macOS menu bar utility for switching the default top-row key behavior on the Logitech K380.

Reference project: jergusg/k380-function-keys-conf

Download Latest Release · 中文 · English

• 中文文档: README.zh-CN.md
• English docs: README.en.md

Highlights

• Menu bar only, no main window
• One-click switch between F1-F12 and media keys
• Direct HID write to the keyboard, no macOS key remapping
• Auto-restore preferred mode when the keyboard reconnects
• Single release build for macOS 12+

Download

从 GitHub Releases 下载最新的 .zip 包，解压后将 K380Fn.app 拖入 Applications。
Download the latest .zip from GitHub Releases, unzip it, and move K380Fn.app into Applications.

Latest release: github.com/sundyme/k380-fn/releases/latest

Compatibility

当前项目采用单一构建，目标系统为：

• macOS 12 Monterey
• macOS 13 Ventura
• macOS 14 Sonoma
• macOS 15 Sequoia

No split builds are needed right now because the app now uses an AppKit status item and shared IOKit HID core.

Build

./Scripts/build-app.sh

生成 GitHub Release 压缩包：

./Scripts/package-release.sh 0.1.1 1