https://github.com/magicien/joykeymapper

Nintendo Joy-Con/ProController Key mapper for macOS
https://github.com/magicien/joykeymapper

gamepad joy-con keymapping macos nintendo-switch pro-controller

Last synced: 9 months ago
JSON representation

Nintendo Joy-Con/ProController Key mapper for macOS

• Host: GitHub
• URL: https://github.com/magicien/joykeymapper
• Owner: magicien
• License: mit
• Created: 2019-07-13T06:29:15.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2022-04-07T17:01:30.000Z (about 4 years ago)
• Last Synced: 2025-07-26T14:01:23.701Z (9 months ago)
• Topics: gamepad, joy-con, keymapping, macos, nintendo-switch, pro-controller
• Language: Swift
• Homepage:
• Size: 6.35 MB
• Stars: 157
• Watchers: 5
• Forks: 17
• Open Issues: 23
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[日本語](https://github.com/magicien/JoyKeyMapper/blob/master/lang/ja/README.md)

# JoyKeyMapper

Nintendo Joy-Con/ProController Key mapper for macOS

![screenshot](https://github.com/magicien/JoyKeyMapper/blob/master/resources/screenshot/screenshot_1.png)

## Install from App Store (Recommended)

[Mac App Store page](https://apps.apple.com/app/joykeymapper/id1511416593)

## Install from Github

1. Download a dmg file (JoyKeyMapper-vX.X.X.dmg) from [Releases](https://github.com/magicien/JoyKeyMapper/releases)

2. Copy JoyKeyMapper.app to Applications

![screenshot_install](https://github.com/magicien/JoyKeyMapper/blob/master/resources/screenshot/screenshot_2.png)

## How to use

1. Connect your controller via Bluetooth

    1.1. Open "System Preferences" > "Bluetooth" on your Mac

    

    1.2. Hold down your controller's sync button

    

    1.3. Click the "Connect" button

    

    ![screenshot_usage_1_3](https://github.com/magicien/JoyKeyMapper/blob/master/resources/screenshot/screenshot_3.png)

2. Set key mappings

    2.1 Launch JoyKeyMapper.app

    

    2.2 Choose the "Settings..." menu

    ![screenshot_usage_2_2](https://github.com/magicien/JoyKeyMapper/blob/master/resources/screenshot/screenshot_4.png)    

    2.3 Add apps to set key mappings (optional)

    

    ![screenshot_usage_2_3](https://github.com/magicien/JoyKeyMapper/blob/master/resources/screenshot/screenshot_5.png)    

    

    2.4 Click a button to set a key

    

    ![screenshot_usage_2_4_1](https://github.com/magicien/JoyKeyMapper/blob/master/resources/screenshot/screenshot_6.png)

    ![screenshot_usage_2_4_2](https://github.com/magicien/JoyKeyMapper/blob/master/resources/screenshot/screenshot_7.png)

3. Allow JoyKeyMapper to control Accessibility

    3.1 When you start using your controller, you will see this alert.

    

    ![screenshot_usage_3_1](https://github.com/magicien/JoyKeyMapper/blob/master/resources/screenshot/screenshot_8.png)    

    

    3.2 Open "System Preferences" > "Security & Privacy" > "Privacy" tab > "Accessibility", and check "JoyKeyMapper.app"

    

    ![screenshot_usage_3_2](https://github.com/magicien/JoyKeyMapper/blob/master/resources/screenshot/screenshot_9.png)    

## See also

[JoyConSwift](https://github.com/magicien/JoyConSwift) - IOKit wrapper for Nintendo Joy-Con and ProController (macOS, Swift)