# How to Set Up X-KeyPad with the Zibo B738

## Table of Contents
- [How to Set Up X-KeyPad with the Zibo B738](#how-to-set-up-x-keypad-with-the-zibo-b738)
  - [Table of Contents](#table-of-contents)
  - [1. Buy and Download X-KeyPad](#1-buy-and-download-x-keypad)
  - [2. Download the Zibo B738 Profile](#2-download-the-zibo-b738-profile)
  - [3. Install the X-KeyPad Plugin](#3-install-the-x-keypad-plugin)
    - [Quarantine Fix on macOS](#quarantine-fix-on-macos)
  - [4. Install the Stream Deck Plugin](#4-install-the-stream-deck-plugin)
  - [5. Load the Zibo B738 and configure X-KeyPad](#5-load-the-zibo-b738-and-configure-x-keypad)
  - [6. Install the Stream Deck Profile](#6-install-the-stream-deck-profile)
  - [7. Final Steps and Customization](#7-final-steps-and-customization)
    - [Need Help?](#need-help)

---

## 1. Buy and Download X-KeyPad

1. Purchase **X-KeyPad** from the [X-Plane.org store](https://link.passengerflying.com/lj4o4m) or another authorized retailer.  
   ![Purchase Example](doc/images/x-plane-org-buy-xkeypad.png)
2. Download the plugin to your computer.  
   ![Download Example](doc/images/x-plane-org-download-xkeypad.png)

> ⚠ **Note:** The serial number shown in images is not real. 😏

---

## 2. Download the Zibo B738 Profile

1. Go to the **files section** of the [X-Plane.org forum](https://forums.x-plane.org).
2. Download the **B738 Stream Deck profile** for use with X-KeyPad.

---

## 3. Install the X-KeyPad Plugin

1. Locate the ZIP file you downloaded from the store.
2. Extract the ZIP file to your computer.  
   ![Extract ZIP](doc/images/finder-xkeypad.png)
3. Find your **X-Plane installation folder**:
   - **For Steam:**  
     - Right-click X-Plane in Steam, select *Properties* > *Installed Files*, then click *Browse...*.  
       ![Steam Path](doc/images/steam-x-plane11-installed-files.png)
   - **For Direct Download:** Use the installation path you selected.
4. Inside the X-Plane folder, go to `Resources/plugins`.
5. Copy the extracted **X-KeyPad** folder into the `plugins` folder.  
   ![Plugin Folder](doc/images/finder-x-plane-11-plugins.png)

---

### Quarantine Fix on macOS

> ⚠️ **Important for macOS Users:** Downloaded software is quarantined by default on macOS. To fix this:  
1. Open the **Terminal** app (found in Applications > Utilities).
2. Enter the following command:  
   `bash sudo xattr -r -d com.apple.quarantine <your X-Plane folder>`

   Replace `<your X-Plane folder>` with the actual path to your X-Plane installation.

This step is not required on Windows.

---

## 4. Install the Stream Deck Plugin

1. Open the **X-KeyPad** plugin folder.
2. Locate the `SD-plugin` folder.
3. Double-click the Stream Deck plugin file to install it.  
   ![Install SD Plugin](doc/images/finder-xkeypad-sd-plugin.png)

---

## 5. Load the Zibo B738 and configure X-KeyPad

1. Start X-Plane (version 11 or 12) and load the **Zibo B738** at any airport.
2. X-KeyPad will automatically create an empty configuration file for the Stream Deck in the aircraft folder.
3. Go to the menu:  
   **X-KeyPad** > **Stream Deck Configuration Editor**.  
   ![Configuration Editor](doc/images/SCR-20230801-tbic.png)

4. In the configuration editor window:
   - Choose **Append** to import a new profile (overwrites existing keys).
   - Optionally, choose **Selected Append** to import only selected keys.  
     ![Append Configuration](doc/images/SCR-20230801-tavn.png)

5. Ensure the JSON profile file `X-KeyPad-SD_b738.json` is located somewhere in your X-Plane folder.

---

## 6. Install the Stream Deck Profile

1. Double-click the Stream Deck profile file from the downloaded ZIP.
2. For smaller Stream Decks, experiment with layouts or manually add keys using X-KeyPad's configuration screen.

---

## 7. Final Steps and Customization

1. You're now set up! Start flying and enjoy the convenience of your Stream Deck integration.
2. If desired, customize profiles or add new keys using the X-KeyPad editor.

### Need Help?

You're done now. You don't have to edit anything in any of the profiles, unless you want to.
If you have any questions or issues, feel free to reach out:  

sander@passengerflying.com

January 20, 2025