https://github.com/chrys87/simple-orca-plugin-system
a simple but powerful pluginsystem for the orca screenreader
https://github.com/chrys87/simple-orca-plugin-system
a11y accessibility orca plugin-loader plugin-manager python-3
Last synced: 6 months ago
JSON representation
a simple but powerful pluginsystem for the orca screenreader
- Host: GitHub
- URL: https://github.com/chrys87/simple-orca-plugin-system
- Owner: chrys87
- License: lgpl-3.0
- Created: 2016-01-05T19:11:03.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-03-14T11:30:11.000Z (7 months ago)
- Last Synced: 2025-03-24T04:35:15.673Z (7 months ago)
- Topics: a11y, accessibility, orca, plugin-loader, plugin-manager, python-3
- Language: Python
- Homepage: http://stormdragon.tk/simple-orca-plugin-system/
- Size: 247 KB
- Stars: 10
- Watchers: 5
- Forks: 3
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
SOPS — Simple Orca Plugin System
===================================
SOPS provides a simple way to write custom plugins for screen reader Orca. It
requires Orca to be installed.
Manual Installation
-------------------
- If you want to install this software system-wide, copy this directory to
/usr/share/SOPS:
sudo cp -dpr . /usr/share/SOPS
You are free to choose a different location, as soon as the directory is not
moved after installation.
- As user, run:
sh /usr/share/SOPS/install-for-current-user.sh
This installs the plugin locally and registers a few default plugins with
Orca.
Note: replace `/usr/share/SOPS` through the path you chose during the
previous step.
install via package manager
---------------------------
- On Debian and derivatives, it is enough to issue
`sudo apt install orca-sops`.
- For Arch Linux, the package simpleorcapluginsystem-git from the AUR can be
installed.
After the installation, run:
sh /usr/share/SOPS/install-for-current-user.sh # copy all the needed stuff to orca
Documentation And Usage
-----------------------
The documentation can be found in the doc folder or in the Arch wiki at
https://wiki.archlinux.org/index.php/Simple_Orca_Plugin_System
Uninstallation
--------------
- if installed by your package manager, use this one
- otherwise remove /usr/share/SOPS
sudo rm -r /usr/share/SOPS # remove the mainfolder
- remove user-local installation:
rm -r ~/.config/SOPS # remove the userplugins and the configuration
- remove the following section from file `~/.local/share/orca/orca-customizations.py` :
```python
# Start SimpleOrcaPluginLoader DO NOT TOUCH!
import os
import importlib.util
spec = importlib.util.spec_from_file_location('SimplePluginLoader', os.path.expanduser('~')+'/.config/SOPS/SimplePluginLoader.py')
SimplePluginLoaderModule = importlib.util.module_from_spec(spec)
spec.loader.exec_module(SimplePluginLoaderModule)
# End SimpleOrcaPluginLoader DO NOT TOUCH!
```