Skip to content
wiggly-sheetsPublic
forked from Pyroh/Fluor

About

A handy tool for macOS allowing you to switch Fn keys' mode based on active application.

Resources

Stars

1 star

Watchers

0 watching

Forks

 
 

Repository files navigation

Fluor app icon

Fluor

Make your Mac’s function keys fit the app you’re using.

A small, open-source menu bar utility for switching between media keys and
standard F1–F12 keys—automatically, per app, or with a shortcut.

macOS 26 or later Swift MIT License

Download  ·  How it works  ·  macOS 26  ·  Contribute

Fluor

Fluor keeps the top row of your keyboard in the mode that makes sense for the app in front of you. Use media controls everywhere, use F1–F12 everywhere, or let Fluor choose on an app-by-app basis.

Features

  • Two keyboard modes — switch between media-key behavior and standard function keys.
  • Per-app rules — give an app its own behavior, while unconfigured apps follow your default.
  • A clear menu bar indicator — see the active mode at a glance and change it from the menu.
  • Configurable global shortcut — toggle modes from any app. The default shortcut is ⌃⌥⌘F, and it can be replaced or cleared in Settings → General.
  • Flexible triggering — switch by active window, the Fn key, or a hybrid of both.
  • Lightweight controls — configure launch at login, notifications, menu-bar appearance, and whether the menu-bar item is shown.

How it works

Fluor’s menu bar indicator

Fluor lives in the menu bar. Its icon reflects the current keyboard mode, and its menu lets you change the default behavior, open Settings, edit rules, or temporarily disable Fluor. When disabled, Fluor restores the keyboard behavior it found when it launched.

Rules

Fluor Rules window

Rules let you set a mode for an individual app. Add an application, choose its behavior, and Fluor applies it when that app becomes active. Apps without a rule inherit the default mode.

For processes that are difficult to select in the Rules window, Running Applications lets you create the same rule from the apps currently open on your Mac.

Fluor Running Applications window

macOS 26

Fluor targets macOS 26 and later. It uses the current macOS keyboard preference and asks the system to apply mode changes; the legacy IOHIDSystem write path has been removed. Launch at login uses Apple’s native SMAppService API.

The configurable global shortcut requires Accessibility permission. Open Settings → Advanced, select Grant Access…, enable Fluor in System Settings, then return to Fluor. Permission is not required when you only use window-based switching.

Install

Download the latest Fluor.dmg from GitHub Releases, open it, and drag Fluor to Applications. The current community build is ad-hoc signed rather than notarized, so on first launch you may need to Control-click Fluor in Finder and choose Open.

Build and install from source

To build and install Fluor yourself, you need:

  • macOS 26 or later
  • Xcode 26
  • An Apple Silicon or Intel Mac

Clone the repository, open the project, and run the Fluor scheme:

git clone https://github.com/wiggly-sheets/fluor.git
cd fluor
open Fluor.xcodeproj

You can also build from Terminal:

xcodebuild -project Fluor.xcodeproj -scheme Fluor -configuration Release build

Copy the resulting Fluor.app to /Applications. Locally built copies are ad-hoc signed, so macOS may ask you to open the app once with Finder’s Open command.

The project builds for Apple Silicon and Intel. In Xcode, select the Fluor scheme and press ⌘R to run a Debug build, or use the Release command above. The Sparkle updater has been removed, so updating a locally built copy means rebuilding and replacing the app in /Applications.

Building from the command line

The repository carries a Makefile, so the same commands work in every product repository. Run make help for the full list.

make build             # debug build of the package
make test              # run the tests
make app               # build dist/Fluor.app
make dmg               # build release/Fluor.dmg
make release-artifacts # build the disk image and its checksums file

The app and the disk image are built with Xcode, because Xcode compiles the storyboards, the xib files, the asset catalog and the app icon, and the app looks its resources up in the main bundle. make release VERSION=2.8.0 builds the release artifacts with that version and tags the commit locally, then prints the command that pushes the tag.

The release workflow runs the test suite first, so a failing test blocks a release.

Open source

Fluor began as a small utility to make the keyboard behave the way its author needed: simple, thoughtfully designed, free, and useful to anyone with the same need. It remains open source so its behavior can be inspected, improved, and shared.

Contributions are welcome—fork it, hack on it, and open a pull request.

Original Fluor by Pierre Tacchi (Pyroh).

License

Fluor is released under the MIT License.

About

A handy tool for macOS allowing you to switch Fn keys' mode based on active application.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages