arabic-layout-fixer 0.5.1__tar.gz

arabic_layout_fixer-0.5.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abdulrahman Elassal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

arabic_layout_fixer-0.5.1/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: arabic-layout-fixer
+Version: 0.5.1
+Summary: Fix text typed on the wrong keyboard layout (Arabic <-> English) with one hotkey.
+Author: Abdulrahman Elassal
+License: MIT
+Project-URL: Homepage, https://github.com/Aelassal/arabic_english_layout_fixer
+Project-URL: Source, https://github.com/Aelassal/arabic_english_layout_fixer
+Project-URL: Issues, https://github.com/Aelassal/arabic_english_layout_fixer/issues
+Project-URL: Releases, https://github.com/Aelassal/arabic_english_layout_fixer/releases
+Keywords: arabic,keyboard-layout,wrong-layout,hotkey,tray,productivity,clipboard
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications
+Classifier: Environment :: MacOS X
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Arabic
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pynput>=1.7.7
+Requires-Dist: pyperclip>=1.8.2
+Requires-Dist: pystray>=0.19.5
+Requires-Dist: Pillow>=10
+Dynamic: license-file
+
+# Arabic Layout Fixer
+
+Typed in Arabic by mistake (or English with the Arabic layout on)? Select the text, press
+**Ctrl + Alt + A** (changeable in Settings), and it is replaced with what you meant to type.
+Works in both directions and picks the direction automatically. Free and open source.
+
+![Demo: Arabic typed by mistake is fixed with one hotkey](https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/assets/demo.gif)
+
+`اثممخ` → `hello` &nbsp;·&nbsp; `hello` → `اثممخ`
+
+Press the hotkey again on the converted text (within 10 minutes) to **undo** it.
+
+## Install
+
+**One line** (installs for your user only, no admin rights, and checks the download against the published
+SHA256 checksum before installing):
+
+| System | Paste this |
+|---|---|
+| Windows (PowerShell) | `irm https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/install.ps1 \| iex` |
+| macOS (Terminal) | `curl -fsSL https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/install.sh \| sh` |
+| Linux (terminal) | `curl -fsSL https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/install.sh \| sh` |
+
+The scripts are short, so you can read [install.sh](https://github.com/Aelassal/arabic_english_layout_fixer/blob/main/install.sh) and [install.ps1](https://github.com/Aelassal/arabic_english_layout_fixer/blob/main/install.ps1) first.
+To remove the app, run the same line with `--uninstall` (macOS/Linux: `... \| sh -s -- --uninstall`) or, on
+Windows, `$env:LAYOUTFIX_UNINSTALL=1` before it.
+
+**Or with Python** (a tiny download from PyPI, the same on all three systems; also avoids the
+"unknown publisher" prompt, because nothing unsigned is run):
+```
+pipx install arabic-layout-fixer      # or: pip install arabic-layout-fixer
+arabic-layout-fixer-tray              # starts the tray app (no console window on Windows)
+```
+On Linux the Settings window needs Tk: `sudo apt install python3-tk` (Debian/Ubuntu) or `sudo dnf install python3-tkinter`.
+
+**Or download by hand** from **Releases**. Each release also lists SHA256 checksums (`SHA256SUMS.txt`).
+
+- **Windows:** run `ArabicLayoutFixer-Windows.exe` (one file, about 11 MB; `ArabicLayoutFixer-Windows.zip` is the same app as a folder, which starts faster). SmartScreen may warn "unknown publisher" because the
+  app is not code-signed: click *More info → Run anyway*.
+- **macOS:** open the `.dmg` (Apple Silicon or Intel), drag the app to *Applications* and open it. The first
+  time macOS blocks it: open *System Settings → Privacy & Security* and click **Open Anyway**. Then allow it under
+  *Privacy & Security → Accessibility* and *Input Monitoring*. Because the app is not notarized, macOS may ask
+  again after an update. Default hotkey on Mac: **Ctrl + Shift + A**.
+- **Linux (X11):** run `ArabicLayoutFixer-Linux` (one file, about 12 MB; `ArabicLayoutFixer-Linux.tar.gz` is the same app as a folder, which starts faster). Nothing else is needed (`xclip` is only used as a fallback).
+- **Linux (Wayland, e.g. GNOME):** the desktop blocks global hotkeys, so use a system shortcut instead. Install
+  `ydotool` (the `ydotoold` service must be running), then add a custom shortcut
+  (GNOME: Settings → Keyboard → Custom Shortcuts) that runs `ArabicLayoutFixer-Linux --once`.
+  (The one-line installer adds the GNOME shortcut Ctrl+Alt+A for you.)
+  The clipboard is handled through XWayland (on by default in GNOME; `DISPLAY` must be set for the shortcut),
+  so no helper programs run and no window ever opens. If XWayland is disabled, `wl-clipboard` is used as a
+  fallback; note that on GNOME each `wl-copy`/`wl-paste` call opens a tiny window to get focus, which makes
+  the dock flicker.
+
+A green swap-arrows icon appears in the tray / menu bar. Click it for **Settings...** and **Start with computer**.
+On GNOME the tray icon needs the AppIndicator extension; the hotkey works without it.
+
+## How it behaves
+- It converts the **highlighted** text and pastes the result over it. On Windows and macOS it copies with
+  Ctrl/Cmd+C (Ctrl+Insert on Windows) and pastes with Ctrl/Cmd+V (Shift+Insert on Windows).
+  Linux reads the highlighted text directly and pastes with Shift+Insert.
+- **Your clipboard is put back** afterwards. If the clipboard holds an image or files, Linux restores them;
+  on Windows and macOS the app refuses to run and tells you, so nothing is lost.
+- In a terminal the fixed text is pasted at the cursor (a terminal cannot replace highlighted output).
+- On Linux the paste key goes out about 0.25 s after the hotkey press (so the hotkey is released first) and the
+  clipboard is put back as soon as the app has read the text. If no app has read the text after 0.6 s (the paste
+  key was swallowed, e.g. because a hotkey key was still held), the text is offered again and the paste key is
+  sent once more; it is never sent again once the app has read the text, so nothing is pasted twice. A small
+  background process keeps serving the restored clipboard until you copy something else, like `wl-copy` would.
+- Nothing is sent anywhere. The app has no network code. It does not log or store what you type, except the
+  last conversion (kept for 10 minutes, in your settings folder) so the hotkey can undo it.
+- Problems are written to a log file in the settings folder (`%APPDATA%\ArabicLayoutFixer`,
+  `~/Library/Application Support/ArabicLayoutFixer` or `~/.config/arabic-layout-fixer`). On Linux each fix
+  logs a timeline from the hotkey press (process start) to the clipboard restore: lengths, timings and which
+  window asked for the text (an X11 window id), never the text itself.
+
+## Change the hotkey
+Tray icon → **Settings...**, tick the modifier keys (Ctrl, Alt, Win/Cmd; Shift alone is not allowed),
+pick a key, press **Save**. It takes effect immediately.
+
+The fix starts when you **let go** of the hotkey, not when you press it. The app then sends its own keys
+(copy, paste) with none of your hotkey's keys still held down, which is what makes it work reliably in browsers,
+Electron apps and chat boxes. If you keep holding the keys, it simply waits.
+
+A **function key on its own** (F1-F12) also works as a hotkey, for example **F9**. It has no modifier that can be
+held down at all. Apps still see that key too, so pick one you don't use.
+On Linux with Wayland (GNOME) you set the key in *Settings → Keyboard → Custom Shortcuts* instead.
+
+<img src="https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/assets/settings.png" width="328" alt="Settings window">
+
+## Run from source
+```
+pip install .
+arabic-layout-fixer           # tray app (or: python -m layoutfix)
+python -m layoutfix --once    # fix the current selection once (for custom shortcuts)
+python -m unittest discover -s tests
+```
+
+## Limitations
+- Assumes the standard Arabic 101 layout.
+- The key that types `لا` is read as `b`; a real `g` then `h` is ambiguous.
+- Plain-symbol results such as `][/` cannot be converted back, since nothing marks them as Arabic.
+- If nothing is highlighted on Linux, an older highlight may still be the "current selection".
+- Rich formatting (bold, links) is not kept in the converted text, and may be lost from the clipboard
+  on Windows/macOS when it held formatted text.
+- Not code-signed or notarized yet.

arabic_layout_fixer-0.5.1/README.md

@@ -0,0 +1,105 @@
+# Arabic Layout Fixer
+
+Typed in Arabic by mistake (or English with the Arabic layout on)? Select the text, press
+**Ctrl + Alt + A** (changeable in Settings), and it is replaced with what you meant to type.
+Works in both directions and picks the direction automatically. Free and open source.
+
+![Demo: Arabic typed by mistake is fixed with one hotkey](https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/assets/demo.gif)
+
+`اثممخ` → `hello`  ·  `hello` → `اثممخ`
+
+Press the hotkey again on the converted text (within 10 minutes) to **undo** it.
+
+## Install
+
+**One line** (installs for your user only, no admin rights, and checks the download against the published
+SHA256 checksum before installing):
+
+| System | Paste this |
+|---|---|
+| Windows (PowerShell) | `irm https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/install.ps1 \| iex` |
+| macOS (Terminal) | `curl -fsSL https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/install.sh \| sh` |
+| Linux (terminal) | `curl -fsSL https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/install.sh \| sh` |
+
+The scripts are short, so you can read [install.sh](https://github.com/Aelassal/arabic_english_layout_fixer/blob/main/install.sh) and [install.ps1](https://github.com/Aelassal/arabic_english_layout_fixer/blob/main/install.ps1) first.
+To remove the app, run the same line with `--uninstall` (macOS/Linux: `... \| sh -s -- --uninstall`) or, on
+Windows, `$env:LAYOUTFIX_UNINSTALL=1` before it.
+
+**Or with Python** (a tiny download from PyPI, the same on all three systems; also avoids the
+"unknown publisher" prompt, because nothing unsigned is run):
+```
+pipx install arabic-layout-fixer      # or: pip install arabic-layout-fixer
+arabic-layout-fixer-tray              # starts the tray app (no console window on Windows)
+```
+On Linux the Settings window needs Tk: `sudo apt install python3-tk` (Debian/Ubuntu) or `sudo dnf install python3-tkinter`.
+
+**Or download by hand** from **Releases**. Each release also lists SHA256 checksums (`SHA256SUMS.txt`).
+
+- **Windows:** run `ArabicLayoutFixer-Windows.exe` (one file, about 11 MB; `ArabicLayoutFixer-Windows.zip` is the same app as a folder, which starts faster). SmartScreen may warn "unknown publisher" because the
+  app is not code-signed: click *More info → Run anyway*.
+- **macOS:** open the `.dmg` (Apple Silicon or Intel), drag the app to *Applications* and open it. The first
+  time macOS blocks it: open *System Settings → Privacy & Security* and click **Open Anyway**. Then allow it under
+  *Privacy & Security → Accessibility* and *Input Monitoring*. Because the app is not notarized, macOS may ask
+  again after an update. Default hotkey on Mac: **Ctrl + Shift + A**.
+- **Linux (X11):** run `ArabicLayoutFixer-Linux` (one file, about 12 MB; `ArabicLayoutFixer-Linux.tar.gz` is the same app as a folder, which starts faster). Nothing else is needed (`xclip` is only used as a fallback).
+- **Linux (Wayland, e.g. GNOME):** the desktop blocks global hotkeys, so use a system shortcut instead. Install
+  `ydotool` (the `ydotoold` service must be running), then add a custom shortcut
+  (GNOME: Settings → Keyboard → Custom Shortcuts) that runs `ArabicLayoutFixer-Linux --once`.
+  (The one-line installer adds the GNOME shortcut Ctrl+Alt+A for you.)
+  The clipboard is handled through XWayland (on by default in GNOME; `DISPLAY` must be set for the shortcut),
+  so no helper programs run and no window ever opens. If XWayland is disabled, `wl-clipboard` is used as a
+  fallback; note that on GNOME each `wl-copy`/`wl-paste` call opens a tiny window to get focus, which makes
+  the dock flicker.
+
+A green swap-arrows icon appears in the tray / menu bar. Click it for **Settings...** and **Start with computer**.
+On GNOME the tray icon needs the AppIndicator extension; the hotkey works without it.
+
+## How it behaves
+- It converts the **highlighted** text and pastes the result over it. On Windows and macOS it copies with
+  Ctrl/Cmd+C (Ctrl+Insert on Windows) and pastes with Ctrl/Cmd+V (Shift+Insert on Windows).
+  Linux reads the highlighted text directly and pastes with Shift+Insert.
+- **Your clipboard is put back** afterwards. If the clipboard holds an image or files, Linux restores them;
+  on Windows and macOS the app refuses to run and tells you, so nothing is lost.
+- In a terminal the fixed text is pasted at the cursor (a terminal cannot replace highlighted output).
+- On Linux the paste key goes out about 0.25 s after the hotkey press (so the hotkey is released first) and the
+  clipboard is put back as soon as the app has read the text. If no app has read the text after 0.6 s (the paste
+  key was swallowed, e.g. because a hotkey key was still held), the text is offered again and the paste key is
+  sent once more; it is never sent again once the app has read the text, so nothing is pasted twice. A small
+  background process keeps serving the restored clipboard until you copy something else, like `wl-copy` would.
+- Nothing is sent anywhere. The app has no network code. It does not log or store what you type, except the
+  last conversion (kept for 10 minutes, in your settings folder) so the hotkey can undo it.
+- Problems are written to a log file in the settings folder (`%APPDATA%\ArabicLayoutFixer`,
+  `~/Library/Application Support/ArabicLayoutFixer` or `~/.config/arabic-layout-fixer`). On Linux each fix
+  logs a timeline from the hotkey press (process start) to the clipboard restore: lengths, timings and which
+  window asked for the text (an X11 window id), never the text itself.
+
+## Change the hotkey
+Tray icon → **Settings...**, tick the modifier keys (Ctrl, Alt, Win/Cmd; Shift alone is not allowed),
+pick a key, press **Save**. It takes effect immediately.
+
+The fix starts when you **let go** of the hotkey, not when you press it. The app then sends its own keys
+(copy, paste) with none of your hotkey's keys still held down, which is what makes it work reliably in browsers,
+Electron apps and chat boxes. If you keep holding the keys, it simply waits.
+
+A **function key on its own** (F1-F12) also works as a hotkey, for example **F9**. It has no modifier that can be
+held down at all. Apps still see that key too, so pick one you don't use.
+On Linux with Wayland (GNOME) you set the key in *Settings → Keyboard → Custom Shortcuts* instead.
+
+<img src="https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/assets/settings.png" width="328" alt="Settings window">
+
+## Run from source
+```
+pip install .
+arabic-layout-fixer           # tray app (or: python -m layoutfix)
+python -m layoutfix --once    # fix the current selection once (for custom shortcuts)
+python -m unittest discover -s tests
+```
+
+## Limitations
+- Assumes the standard Arabic 101 layout.
+- The key that types `لا` is read as `b`; a real `g` then `h` is ambiguous.
+- Plain-symbol results such as `][/` cannot be converted back, since nothing marks them as Arabic.
+- If nothing is highlighted on Linux, an older highlight may still be the "current selection".
+- Rich formatting (bold, links) is not kept in the converted text, and may be lost from the clipboard
+  on Windows/macOS when it held formatted text.
+- Not code-signed or notarized yet.

arabic_layout_fixer-0.5.1/arabic_layout_fixer.egg-info/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: arabic-layout-fixer
+Version: 0.5.1
+Summary: Fix text typed on the wrong keyboard layout (Arabic <-> English) with one hotkey.
+Author: Abdulrahman Elassal
+License: MIT
+Project-URL: Homepage, https://github.com/Aelassal/arabic_english_layout_fixer
+Project-URL: Source, https://github.com/Aelassal/arabic_english_layout_fixer
+Project-URL: Issues, https://github.com/Aelassal/arabic_english_layout_fixer/issues
+Project-URL: Releases, https://github.com/Aelassal/arabic_english_layout_fixer/releases
+Keywords: arabic,keyboard-layout,wrong-layout,hotkey,tray,productivity,clipboard
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications
+Classifier: Environment :: MacOS X
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Arabic
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pynput>=1.7.7
+Requires-Dist: pyperclip>=1.8.2
+Requires-Dist: pystray>=0.19.5
+Requires-Dist: Pillow>=10
+Dynamic: license-file
+
+# Arabic Layout Fixer
+
+Typed in Arabic by mistake (or English with the Arabic layout on)? Select the text, press
+**Ctrl + Alt + A** (changeable in Settings), and it is replaced with what you meant to type.
+Works in both directions and picks the direction automatically. Free and open source.
+
+![Demo: Arabic typed by mistake is fixed with one hotkey](https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/assets/demo.gif)
+
+`اثممخ` → `hello` &nbsp;·&nbsp; `hello` → `اثممخ`
+
+Press the hotkey again on the converted text (within 10 minutes) to **undo** it.
+
+## Install
+
+**One line** (installs for your user only, no admin rights, and checks the download against the published
+SHA256 checksum before installing):
+
+| System | Paste this |
+|---|---|
+| Windows (PowerShell) | `irm https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/install.ps1 \| iex` |
+| macOS (Terminal) | `curl -fsSL https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/install.sh \| sh` |
+| Linux (terminal) | `curl -fsSL https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/install.sh \| sh` |
+
+The scripts are short, so you can read [install.sh](https://github.com/Aelassal/arabic_english_layout_fixer/blob/main/install.sh) and [install.ps1](https://github.com/Aelassal/arabic_english_layout_fixer/blob/main/install.ps1) first.
+To remove the app, run the same line with `--uninstall` (macOS/Linux: `... \| sh -s -- --uninstall`) or, on
+Windows, `$env:LAYOUTFIX_UNINSTALL=1` before it.
+
+**Or with Python** (a tiny download from PyPI, the same on all three systems; also avoids the
+"unknown publisher" prompt, because nothing unsigned is run):
+```
+pipx install arabic-layout-fixer      # or: pip install arabic-layout-fixer
+arabic-layout-fixer-tray              # starts the tray app (no console window on Windows)
+```
+On Linux the Settings window needs Tk: `sudo apt install python3-tk` (Debian/Ubuntu) or `sudo dnf install python3-tkinter`.
+
+**Or download by hand** from **Releases**. Each release also lists SHA256 checksums (`SHA256SUMS.txt`).
+
+- **Windows:** run `ArabicLayoutFixer-Windows.exe` (one file, about 11 MB; `ArabicLayoutFixer-Windows.zip` is the same app as a folder, which starts faster). SmartScreen may warn "unknown publisher" because the
+  app is not code-signed: click *More info → Run anyway*.
+- **macOS:** open the `.dmg` (Apple Silicon or Intel), drag the app to *Applications* and open it. The first
+  time macOS blocks it: open *System Settings → Privacy & Security* and click **Open Anyway**. Then allow it under
+  *Privacy & Security → Accessibility* and *Input Monitoring*. Because the app is not notarized, macOS may ask
+  again after an update. Default hotkey on Mac: **Ctrl + Shift + A**.
+- **Linux (X11):** run `ArabicLayoutFixer-Linux` (one file, about 12 MB; `ArabicLayoutFixer-Linux.tar.gz` is the same app as a folder, which starts faster). Nothing else is needed (`xclip` is only used as a fallback).
+- **Linux (Wayland, e.g. GNOME):** the desktop blocks global hotkeys, so use a system shortcut instead. Install
+  `ydotool` (the `ydotoold` service must be running), then add a custom shortcut
+  (GNOME: Settings → Keyboard → Custom Shortcuts) that runs `ArabicLayoutFixer-Linux --once`.
+  (The one-line installer adds the GNOME shortcut Ctrl+Alt+A for you.)
+  The clipboard is handled through XWayland (on by default in GNOME; `DISPLAY` must be set for the shortcut),
+  so no helper programs run and no window ever opens. If XWayland is disabled, `wl-clipboard` is used as a
+  fallback; note that on GNOME each `wl-copy`/`wl-paste` call opens a tiny window to get focus, which makes
+  the dock flicker.
+
+A green swap-arrows icon appears in the tray / menu bar. Click it for **Settings...** and **Start with computer**.
+On GNOME the tray icon needs the AppIndicator extension; the hotkey works without it.
+
+## How it behaves
+- It converts the **highlighted** text and pastes the result over it. On Windows and macOS it copies with
+  Ctrl/Cmd+C (Ctrl+Insert on Windows) and pastes with Ctrl/Cmd+V (Shift+Insert on Windows).
+  Linux reads the highlighted text directly and pastes with Shift+Insert.
+- **Your clipboard is put back** afterwards. If the clipboard holds an image or files, Linux restores them;
+  on Windows and macOS the app refuses to run and tells you, so nothing is lost.
+- In a terminal the fixed text is pasted at the cursor (a terminal cannot replace highlighted output).
+- On Linux the paste key goes out about 0.25 s after the hotkey press (so the hotkey is released first) and the
+  clipboard is put back as soon as the app has read the text. If no app has read the text after 0.6 s (the paste
+  key was swallowed, e.g. because a hotkey key was still held), the text is offered again and the paste key is
+  sent once more; it is never sent again once the app has read the text, so nothing is pasted twice. A small
+  background process keeps serving the restored clipboard until you copy something else, like `wl-copy` would.
+- Nothing is sent anywhere. The app has no network code. It does not log or store what you type, except the
+  last conversion (kept for 10 minutes, in your settings folder) so the hotkey can undo it.
+- Problems are written to a log file in the settings folder (`%APPDATA%\ArabicLayoutFixer`,
+  `~/Library/Application Support/ArabicLayoutFixer` or `~/.config/arabic-layout-fixer`). On Linux each fix
+  logs a timeline from the hotkey press (process start) to the clipboard restore: lengths, timings and which
+  window asked for the text (an X11 window id), never the text itself.
+
+## Change the hotkey
+Tray icon → **Settings...**, tick the modifier keys (Ctrl, Alt, Win/Cmd; Shift alone is not allowed),
+pick a key, press **Save**. It takes effect immediately.
+
+The fix starts when you **let go** of the hotkey, not when you press it. The app then sends its own keys
+(copy, paste) with none of your hotkey's keys still held down, which is what makes it work reliably in browsers,
+Electron apps and chat boxes. If you keep holding the keys, it simply waits.
+
+A **function key on its own** (F1-F12) also works as a hotkey, for example **F9**. It has no modifier that can be
+held down at all. Apps still see that key too, so pick one you don't use.
+On Linux with Wayland (GNOME) you set the key in *Settings → Keyboard → Custom Shortcuts* instead.
+
+<img src="https://raw.githubusercontent.com/Aelassal/arabic_english_layout_fixer/main/assets/settings.png" width="328" alt="Settings window">
+
+## Run from source
+```
+pip install .
+arabic-layout-fixer           # tray app (or: python -m layoutfix)
+python -m layoutfix --once    # fix the current selection once (for custom shortcuts)
+python -m unittest discover -s tests
+```
+
+## Limitations
+- Assumes the standard Arabic 101 layout.
+- The key that types `لا` is read as `b`; a real `g` then `h` is ambiguous.
+- Plain-symbol results such as `][/` cannot be converted back, since nothing marks them as Arabic.
+- If nothing is highlighted on Linux, an older highlight may still be the "current selection".
+- Rich formatting (bold, links) is not kept in the converted text, and may be lost from the clipboard
+  on Windows/macOS when it held formatted text.
+- Not code-signed or notarized yet.

arabic_layout_fixer-0.5.1/arabic_layout_fixer.egg-info/SOURCES.txt

@@ -0,0 +1,34 @@
+LICENSE
+README.md
+pyproject.toml
+arabic_layout_fixer.egg-info/PKG-INFO
+arabic_layout_fixer.egg-info/SOURCES.txt
+arabic_layout_fixer.egg-info/dependency_links.txt
+arabic_layout_fixer.egg-info/entry_points.txt
+arabic_layout_fixer.egg-info/requires.txt
+arabic_layout_fixer.egg-info/top_level.txt
+layoutfix/__init__.py
+layoutfix/__main__.py
+layoutfix/app.py
+layoutfix/autostart.py
+layoutfix/clipboard.py
+layoutfix/config.py
+layoutfix/core.py
+layoutfix/history.py
+layoutfix/hotkey.py
+layoutfix/icon.py
+layoutfix/instance.py
+layoutfix/log.py
+layoutfix/safety.py
+layoutfix/settings.py
+layoutfix/system.py
+layoutfix/x11sel.py
+tests/test_clipboard_native.py
+tests/test_config.py
+tests/test_core.py
+tests/test_hotkey.py
+tests/test_safety_autostart_misc.py
+tests/test_selftest.py
+tests/test_system_desktop.py
+tests/test_system_flow.py
+tests/test_x11sel.py

arabic_layout_fixer-0.5.1/arabic_layout_fixer.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

arabic_layout_fixer-0.5.1/arabic_layout_fixer.egg-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+arabic-layout-fixer = layoutfix.app:main
+
+[gui_scripts]
+arabic-layout-fixer-tray = layoutfix.app:main

arabic_layout_fixer-0.5.1/arabic_layout_fixer.egg-info/requires.txt

@@ -0,0 +1,4 @@
+pynput>=1.7.7
+pyperclip>=1.8.2
+pystray>=0.19.5
+Pillow>=10

arabic_layout_fixer-0.5.1/arabic_layout_fixer.egg-info/top_level.txt

@@ -0,0 +1 @@
+layoutfix

arabic_layout_fixer-0.5.1/layoutfix/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.5.1"

arabic_layout_fixer-0.5.1/layoutfix/__main__.py

@@ -0,0 +1,3 @@
+from .app import main
+
+main()

arabic_layout_fixer-0.5.1/layoutfix/app.py

@@ -0,0 +1,156 @@
+"""Tray icon + global hotkey."""
+import os
+import shutil
+import subprocess
+import sys
+import threading
+import time
+
+from . import autostart, config, history, instance, log, system
+from .hotkey import HotkeyListener
+
+
+def run_fix():
+    try:
+        system.fix_selection(history.convert)
+    except Exception:
+        log.get().exception("fix failed")
+        log.notify("Something went wrong. Nothing was changed. Details are in the log file.")
+
+
+def _in_thread(fn):
+    return lambda *a: threading.Thread(target=fn, daemon=True).start()
+
+
+class Hotkey:
+    """Owns the hotkey listener and swaps it when the setting changes."""
+
+    def __init__(self):
+        self.listener = None
+
+    def apply(self, hotkey):
+        if self.listener:
+            self.listener.stop()
+            self.listener = None
+        if system.WAYLAND:
+            return
+        try:
+            probe = system._held_modifiers if system.WIN or system.MAC else None    # real key state, to drop stale ones
+            self.listener = HotkeyListener(hotkey, _in_thread(run_fix), probe)
+            self.listener.start()
+        except Exception:
+            log.get().exception("could not register %r", hotkey)
+            if hotkey != config.default_hotkey():
+                self.apply(config.default_hotkey())
+
+
+def open_settings():
+    cmd = [sys.executable] if getattr(sys, "frozen", False) else [sys.executable, "-m", "layoutfix"]
+    subprocess.Popen(cmd + ["--settings"])
+
+
+def _import_pystray():
+    """pystray picks a Linux backend at import time and can crash when the tray library is missing."""
+    try:
+        import pystray
+        return pystray
+    except Exception:
+        if sys.platform.startswith("linux"):
+            os.environ["PYSTRAY_BACKEND"] = "xorg"
+            try:
+                import pystray
+                return pystray
+            except Exception:
+                pass
+    log.get().exception("no tray icon available")
+    return None
+
+
+def _selftest() -> int:
+    """Import everything the app needs and run a tiny conversion. Used by CI on the *built* app,
+    because a packaged app can crash at start-up on a missing module even when the tests pass."""
+    import importlib
+    from . import core
+    modules = ["layoutfix.autostart", "layoutfix.clipboard", "layoutfix.hotkey", "layoutfix.icon",
+               "layoutfix.settings", "layoutfix.system", "layoutfix.x11sel", "PIL.Image", "pyperclip"]
+    if not sys.platform.startswith("linux") or os.environ.get("DISPLAY"):
+        modules += ["pynput.keyboard", "pystray"]        # these need a display on Linux
+    failed = []
+    for name in modules:
+        try:
+            importlib.import_module(name)
+        except Exception as exc:
+            failed.append(f"{name}: {exc!r}")
+    if core.fix("اثممخ") != "hello":
+        failed.append("core.fix gave a wrong result")
+    if sys.platform.startswith("win") or sys.platform == "darwin":
+        from . import system
+        if system._held_modifiers() is None:           # the real Windows/macOS key-state call must work
+            failed.append("cannot read the modifier key state")
+    from .icon import make_icon
+    if make_icon(64).size != (64, 64):
+        failed.append("icon has the wrong size")
+    for line in failed:
+        log.get().error("selftest FAILED %s", line)
+    log.get().info("selftest %s (%d modules checked)", "FAILED" if failed else "ok", len(modules))
+    return 1 if failed else 0
+
+
+def main():
+    log.setup()
+    if "--selftest" in sys.argv:
+        sys.exit(_selftest())
+    if "--once" in sys.argv:                    # for Wayland / custom shortcuts
+        if shutil.which("notify-send"):
+            log.set_notifier(lambda m: subprocess.run(["notify-send", "Arabic Layout Fixer", m], timeout=5))
+        run_fix()
+        return
+    if "--settings" in sys.argv:
+        from . import settings
+        settings.main()
+        return
+
+    app_lock = instance.try_lock("app")
+    if app_lock is None:
+        log.get().info("Arabic Layout Fixer is already running.")
+        return
+
+    hotkey = Hotkey()
+    hotkey.apply(config.load_hotkey())
+    if system.WAYLAND:
+        log.get().warning("Wayland blocks global hotkeys: bind a system shortcut to `ArabicLayoutFixer --once`.")
+
+    pystray = _import_pystray()
+    if pystray is None:                         # no tray: keep the hotkey working in the background
+        threading.Event().wait()
+        return
+
+    def toggle_autostart(icon, item):
+        try:
+            autostart.set_enabled(not autostart.is_enabled())
+        except (ValueError, OSError) as exc:
+            log.notify(str(exc))
+
+    menu = pystray.Menu(
+        pystray.MenuItem(lambda item: f"Select text, then press {config.pretty(config.load_hotkey())}",
+                         None, enabled=False),
+        pystray.MenuItem("Settings...", lambda icon, item: open_settings()),
+        pystray.MenuItem("Start with computer", toggle_autostart, checked=lambda item: autostart.is_enabled()),
+        pystray.MenuItem("Quit", lambda icon, item: icon.stop()),
+    )
+    from .icon import make_icon                 # imports Pillow: only the tray needs it
+    icon = pystray.Icon("layoutfix", make_icon(64), "Arabic Layout Fixer", menu)
+    log.set_notifier(lambda message: icon.notify(message, "Arabic Layout Fixer"))
+
+    def watch_config():                         # pick up changes made in the settings window
+        seen = config.last_changed()
+        while True:
+            time.sleep(1)
+            now = config.last_changed()
+            if now != seen:
+                seen = now
+                hotkey.apply(config.load_hotkey())
+                icon.update_menu()
+
+    threading.Thread(target=watch_config, daemon=True).start()
+    icon.run()