ybotspawn / keep-ulauncher Goto Github PK

Google Keep plugin for ULauncher

License: GNU General Public License v3.0

Python 100.00%

ulauncher google keep gkeepapi helper notes

keep-ulauncher's Introduction

About

This is a Google Keep launcher extension for the ULauncher desktop assistant platform. This project is currently a work in progress.

Pre Installation

Prior to installation, you should install the gkeepapi, by Kiwiz. Kudos to this author for their hard work on the gkeepapi project (https://github.com/kiwiz/gkeepapi). This can be installed via your Linux flavor package manager or Python Pip.

Installation

This software can be installed into ULauncher by opening the ULauncher preferences and installing this plugin via the extension tab:

Next, click "Add Extension" in the lower left and enter the "https://github.com/ybotspawn/Keep-ULauncher" into the URL prompt:

Post Installation

Once installed the software will likely require some further configuration to be used. The default keyword is gk, this and the remaining options can be changed in the extension configuration menu. Changing the keyword is optional. The next option, that is required is the Google user name. This is your google account email, including the @domain if you are a Google Apps for Work user.

The second option is the Google API Key. This can be your password, but your password will likely not work, especially if you have two factor authentication enabled. To overcome this issue, you should follow the instructions here: https://support.google.com/accounts/answer/185833 and provide your API Key. This key should be held locally and protected.

Usage

Usage is simple, simply open ULauncher and type gk followed by your Google Note information. A basic BNF style syntax document is available here:

If you're unsure the basic syntax is as follows:

TRUE - Denotes that the note should be pinned
COLOR - Indicates the color the note should be, the defualt is White. The available options are BLUE, RED, GREEN, BROWN, DARKBLUE, GRAY, ORANGE, PINK, PURPLE, TEAL, YELLOW.
TEXT - Indicates the following text will be placed into the body of your note
TITLE - Indicates the following text will be placed as the title of your note

Example:

keep-ulauncher's People

Contributors

Stargazers

Watchers

Stacktrace:

Traceback (most recent call last):
  File "/usr/lib/python3/dist-packages/ulauncher/ui/windows/PreferencesUlauncherDialog.py", line 198, in on_scheme_callback
    resp = rt.dispatch(self, scheme_request.get_uri())
  File "/usr/lib/python3/dist-packages/ulauncher/utils/Router.py", line 49, in dispatch
    return callback(context, url_params)
  File "/usr/lib/python3/dist-packages/ulauncher/ui/windows/PreferencesUlauncherDialog.py", line 433, in prefs_extension_update_prefs
    controller = ExtensionServer.get_instance().get_controller(ext_id)
  File "/usr/lib/python3/dist-packages/ulauncher/api/server/ExtensionServer.py", line 76, in get_controller
    return self.controllers[extension_id]
KeyError: 'com.github.ybotspawn.keep-ulauncher'

2023-11-10 21:01:37,138 | ERROR | ulauncher.api.server.ExtensionRunner: _run_process() | Extension "com.github.ybotspawn.keep-ulauncher" exited instantly with code 1
2023-11-10 21:01:37,138 | ERROR | ulauncher.api.server.ExtensionRunner: _run_process() | Extension "com.github.ybotspawn.keep-ulauncher" failed with an error: Exception: Version mismatch: this is the 'cffi' package version 1.15.1, located in '/home/igoru/.local/lib/python3.8/site-packages/cffi/api.py'. When we import the top-level '_cffi_backend' extension module, we get version 1.14.0, located in '/usr/lib/python3/dist-packages/_cffi_backend.cpython-38-x86_64-linux-gnu.so'. The two versions should be equal; check your installation.

 ~> pip install cffi
Requirement already satisfied: cffi in ./.local/lib/python3.8/site-packages (1.15.1)
Requirement already satisfied: pycparser in ./.local/lib/python3.8/site-packages (from cffi) (2.21)
 ~> sudo pip install cffi
[sudo] password for igoru:      
Requirement already satisfied: cffi in /usr/local/lib/python3.8/dist-packages (1.15.1)
Requirement already satisfied: pycparser in /usr/local/lib/python3.8/dist-packages (from cffi) (2.21)
 ~> sudo pip install _cffi_backend
ERROR: Invalid requirement: '_cffi_backend'

Traceback (most recent call last):
  File "/home/tony/.local/share/ulauncher/extensions/com.github.ybotspawn.keep-ulauncher/main.py", line 4, in <module>
    import gkeepapi
ModuleNotFoundError: No module named 'gkeepapi'

I'm not sure how to fix this. I've installed gkeepapi with both pip and pip3.

$ pip show gkeepapi
Name: gkeepapi
Version: 0.11.8
Summary: An unofficial Google Keep API client
Home-page: https://github.com/kiwiz/gkeepapi
Author: Kai
Author-email: [email protected]
License: MIT
Location: /home/tony/.local/lib/python2.7/site-packages
Requires: enum34, six, future, gpsoauth

$ pip3 show gkeepapi
Name: gkeepapi
Version: 0.11.8
Summary: An unofficial Google Keep API client
Home-page: https://github.com/kiwiz/gkeepapi
Author: Kai
Author-email: [email protected]
License: MIT
Location: /home/linuxbrew/.linuxbrew/lib/python3.7/site-packages
Requires: future, six, gpsoauth
Required-by:

I'm not a Python expert, but this suggests to me that gkeepapi should be importable.

$ python
Python 2.7.15+ (default, Oct  7 2019, 17:39:04) 
[GCC 7.4.0] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import gkeepapi
>>> gkeepapi
<module 'gkeepapi' from '/home/tony/.local/lib/python2.7/site-packages/gkeepapi/__init__.pyc'>

$ python3
Python 3.7.5 (default, Nov  1 2019, 19:15:52) 
[GCC 5.4.0 20160609] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import gkeepapi
>>> gkeepapi
<module 'gkeepapi' from '/home/linuxbrew/.linuxbrew/Cellar/python/3.7.5/lib/python3.7/site-packages/gkeepapi/__init__.py'>

Any help for how to fix the ModuleNotFoundError is greatly appreciated!