gaschz/passff-host
1
0
Fork 0
mirror of https://codeberg.org/gaschz/passff-host.git synced 2025-06-06 18:08:46 +02:00
Code Issues Packages Projects Releases Wiki Activity

Doc: Add Troubleshooting section

Browse Source 
It provides guidelines to fix the following issues:
  - Script execution failed
    * Remove old installations
    * Reinstall
    * Check the host-app is installed correctly
  - PassFF is not working and takes 99% CPU
    * Check the PATH variable
This commit is contained in:
5bentz 2018-06-03 09:39:14 +02:00
parent 77402286ba
commit 5911e4b425
1 changed files with 35 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
README.md
View File

@ -94,6 +94,41 @@ If this doesn't work, you can link the files yourself. First, change the `path`
- Per-user: `~/Library/Application Support/Vivaldi/NativeMessagingHosts/passff.json`
- System-wide: `/Library/Application Support/Vivaldi/NativeMessagingHosts/passff.json`
### Troubleshooting
#### Script execution failed
#### Connection to the host app failed or returned an unexpected result
> Connection to the host app failed or returned an unexpected result!
> Make sure you have the latest version of the PassFF host app installed by following the installation instructions on GitHub.
> Script execution failed.
You get one of these error messages? Follow the instructions below!
###### Remove old installations
*Inappropriate installations can override another one that could work. So, it is simpler to remove everything and restart from scratch.*
* Delete any file `passff.json` in the folders `native-messaging-hosts` and `NativeMessagingHosts`
* For the complete paths of these folders for your OS and browser, see the section above.
* Verify all `passff.json` are deleted by doing a search.
* Use your best file searching tool. For example: `find / -type f -name 'passff.json'`
###### Reinstall the host application
See the section above.
###### Check that the host application is correctly installed
* Make sure the file `passff.py` is executable
* `ls -l /path/to/passff.py`
* Open `passff.json` and verify `path` is set to the absolute path of the host executable `passff.py`: for example `"path": "/path/to/passff.py"`
#### PassFF's host application is not working and takes 99% CPU
###### Set a correct PATH in the `passff.py` script
When the PATH variable is not set correctly, `pass` will complain about not finding `getopt` and then loop forever. You can reproduce this behavior on the command line:
```
PATH="$(which bash | xargs dirname)" $(which pass)
```
### Preferences
By modifying the `preferences section` in `passff.py` you will be able to set
- the path to the `pass` script,