Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/blackswandevcom/blackswan-force-fa-numbers-switch

BlackSwan Force FA-Numbers Switch is an AutoIt script that replaces Numpad English digits with Persian digits and features a system tray toggle and a Ctrl + Numpad . hotkey.
https://github.com/blackswandevcom/blackswan-force-fa-numbers-switch

autoit3 persian persian-language windows-10 windows-11

Last synced: 7 days ago
JSON representation

BlackSwan Force FA-Numbers Switch is an AutoIt script that replaces Numpad English digits with Persian digits and features a system tray toggle and a Ctrl + Numpad . hotkey.

Awesome Lists containing this project

README 

        
# BlackSwan Force FA-Numbers Switch



**BlackSwan Force FA-Numbers Switch** is an AutoIt script that replaces English and Persian digits when typing on the Numpad. It includes a system tray icon with toggling functionality, allowing users to easily enable or disable the digit replacement feature. The script also supports switching between Persian and English number input using a custom hotkey (Ctrl+NumpadDot).



## Features



- **Persian Digit Replacement**: Replaces Numpad digits (0-9) with their Persian equivalents.

- **Toggle Functionality**: Easily enable or disable the digit replacement feature using a system tray icon or a hotkey.

- **Custom Tray Icon**: The system tray icon changes color and text based on the toggle state.

- **Hotkey Support**: Use `Ctrl + Numpad Dot (.)` to toggle the digit replacement feature.



## Installation



### Download and Run Precompiled Version



1. **Download the Precompiled Executable**: You can download the precompiled `.exe` version of the script from the following link:



   [Download BlackSwan Force FA-Numbers Switch](https://github.com/blackswanlab/BlackSwan-Force-FA-Numbers-Switch/releases/latest/download/BlackSwan_Force_FANumbers_Switch.exe)



2. **Run the Executable**: Run the `.exe` file after downloading. The script will start and place an icon in the system tray.



### Edit and Compile the Script Yourself



If you want to modify the script and compile it yourself, follow these steps:



1. **Download AutoIt**: Ensure you have AutoIt installed on your system. You can download it from the [AutoIt official website](https://www.autoitscript.com/site/autoit/downloads/).



2. **Clone the Repository**: Clone the repository to your local machine.



   ```bash

   git clone https://github.com/blackswanlab/BlackSwan-Force-FA-Numbers-Switch.git



## Usage



- **Enable/Disable Replacement**:

  - Click on the system tray icon to toggle the digit replacement feature on and off.

  - The tray icon will display "En" with a white background when enabled and "Fa" with a yellow background when disabled.



- **Hotkey for Toggle**:

  - Press `Ctrl + Numpad Dot (.)` to toggle the digit replacement feature on or off.



- **About Dialog**:

  - Right-click the system tray icon and select "About" to view information about the script.



## Keybindings



- **Numpad 0-9**: Replaced with Persian digits (۰-۹) when the feature is enabled.

- **Ctrl + Numpad Dot (.)**: Toggle the Persian digit replacement feature.



## Troubleshooting



- **Persian Digits Not Displaying**: Ensure you use a text editor or application supporting Persian digits and Unicode. I think you should consider using Microsoft Word for better Unicode support.

- **Tray Icon Not Updating**: If the system tray icon does not update correctly, try restarting the script.



## Contributing



Contributions are welcome! If you have suggestions or improvements, please submit a pull request or open an issue on the GitHub repository.



## License



This project is licensed under the MPL-2.0 license.



## Contact



For any questions or feedback, please get in touch with the project maintainer via GitHub issues or pull requests.