https://github.com/artginzburg/functiontoggler

 Quickly toggle the fn key behavior (macOS app)
https://github.com/artginzburg/functiontoggler

applescript keyboard-shortcuts macos preferences shortcut spotlight toggles

Last synced: 6 months ago
JSON representation

 Quickly toggle the fn key behavior (macOS app)

• Host: GitHub
• URL: https://github.com/artginzburg/functiontoggler
• Owner: artginzburg
• License: mit
• Created: 2019-08-07T00:43:33.000Z (about 6 years ago)
• Default Branch: main
• Last Pushed: 2023-06-26T12:40:35.000Z (over 2 years ago)
• Last Synced: 2025-04-24T05:13:30.484Z (6 months ago)
• Topics: applescript, keyboard-shortcuts, macos, preferences, shortcut, spotlight, toggles
• Language: AppleScript
• Homepage:
• Size: 4.16 MB
• Stars: 7
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


   Function Toggler 





   Quickly* toggle the "Use all F1, F2, etc. keys as standard function keys" option in macOS System Preferences



> \* Through the shortcut

![keyboard settings](screenshots/kb-sets.png)

## Install

### Via [Homebrew Cask](//brew.sh) (Recommended)

```ps1

brew install --cask --no-quarantine artginzburg/tap/functiontoggler

```

> Check out [the cask][cask] if you're interested.

### Direct Download

**[Latest Release ![GitHub release](https://img.shields.io/github/release/artginzburg/functiontoggler?label=%20)](//github.com/artginzburg/FunctionToggler/releases/latest/download/FunctionToggler.zip)**

### Using Source Code

Clone, set current directory, install dependencies and run the build command.

> also allows to `make uninstall`

```ps1

git clone https://github.com/artginzburg/FunctionToggler

cd FunctionToggler

make

make build

make install

```

> I use [`platypus`](https://github.com/sveinbjornt/Platypus) CLI for building instead of `osacompile -o MyScript.app MyScript.scpt` because it offers better interface and for some reason compiles to less size.

---

   Function Toggler needs Accessibility Control

1.  Open the app once (for it to appear in Accessibility tab)

2.  Go to `System Preferences` > `Security & Privacy` > `Privacy` > `Accessibility`

3.  `Click the lock to make changes` and tick `Function Toggler` under `Allow the apps below to control your computer`.

![preferences](screenshots/privacy-sets.png)

## Usage

Simply run the app.

I like to do it from Spotlight:

1. Press ⌘ + space (or similar) to open Spotlight.

2. Start typing `fun` or `ft`, continue until `Function Toggler` appear in the Top Hit section.

3. Hit Enter.

## Enable the Keyboard shortcut

Go to `System Preferences` > `Keyboard` > `Shortcuts` > `Services` > `General` (at the end of the list) and assign a new shortcut to `Function Toggler` service

![keybard-shortcut](screenshots/kb-short.png)

> The workflow (service) just runs the app, so it won't work without it.

### How to release

1. Run `make build` and `make release`.

2. Upload the generated archive — `dist/FunctionToggler.zip` — to GitHub Releases.

3. Update [the cask][cask] with the new version number and the checksum that lies in your clipboard after running `make release`.

[cask]: https://github.com/artginzburg/homebrew-tap/blob/main/Casks/functiontoggler.rb