Arabic QWERTY Keyboard for Android

A simple, open-source Arabic QWERTY Physical keyboard Layout for Android devices, built using native Android development with Kotlin and XML. This project serves as a basic example of how to create a custom Physical Keyboard Layout on Android. Designed to be a minimal and functional Physical keyboard Layout inspired from MacOS Arabic QWERTY.

Features

• Arabic QWERTY Layout: Standard QWERTY layout adapted for Arabic characters taken form MacOS Arabic QWERTY Layout.

Screenshots

Arabic QWERTY Keyboard Layout:

Getting Started

Prerequisites

• Android Studio
• An Android device or emulator running Android.

Installation & Setup

1. Clone the repository
2. Open in Android Studio:
   • Open Android Studio.
   • Select "Open an existing Android Studio project."
   • Navigate to the cloned directory and select it.
3. Build the project:
   • Let Android Studio sync Gradle and download dependencies.
   • Click Build > Make Project or run the app directly.
4. Run on a device/emulator:
   • Select your device/emulator from the dropdown.
   • Click the "Run" button (green play icon).

Enabling the Keyboard

After installing the app on your Android device:

1. Connect your bluetooth keyboard to your Phone.
2. Go to your device's Settings.
3. Navigate to System > Languages & input (this path might vary slightly depending on your Android version and manufacturer).
4. Tap on keyboard then Physical keyboard.
5. You need to select "MacOS Arabic QWERTY" for your Arabic language.
6. Open any text input field (e.g., in a messaging app) to start using your keyboard.

How to Contribute

Contributions are welcome! If you'd like to contribute, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix
3. Make your changes.
4. Test your changes thoroughly.
5. Commit your changes with a clear and descriptive commit message:
6. Push to your forked repository:
7. Open a Pull Request to the main branch of this repository.
   • Provide a clear title and description for your pull request.
   • Reference any related issues.

Areas for Contribution

• Adding settings/preferences for the keyboard.
• Bug fixes and performance improvements.
• Adding more keyboard layouts (e.g., different Arabic arrangements).