pext / pext_module_emoji

Allows Pext to function as an emoji selector

Pext

Contents

• Introduction
• How it works
• Installation
• Usage
• Hotkeys
• Community
• License

Introduction

Pext stands for Python-based extendable tool. It is built using Python 3 and Qt5 QML and has its behaviour decided by modules. Pext provides a simple window with a search bar, allowing modules to define what data is shown and how it is manipulated.

For example, say you want to use Pext as a password manager. You load in the pass module, and it will show you a list of your passwords which you can filter with the search bar. When you select a password in the list, it will copy the password to your clipboard and Pext will hide itself, waiting for you to ask for it again.

Depending on the module you choose, what entries are shown and what happens when you select an entry changes. So choose the module appropriate for what you want to do, and Pext makes it easy.

Several modules are available for effortless install right within Pext.

How it works

Pext is designed to quickly pop up and get out of your way as soon as you're done with something. It is recommended to bind Pext to some global hotkey, or possibly run multiple instances of it with different profiles under multiple hotkeys. Example Pext workflows look as follows:

Simply put:

• Open (Pext)
• Search (for something)
• Select (with Enter)
• Hide (automatically)

Installation

Check the install instructions at Read the Docs.

Usage

To actually use Pext, you will first have to install one or more modules. Check out the Pext organisation on GitHub or use Module -> Install module -> From online module list in the application for a list of modules.

After installating at least one module, you can load it from the Module -> Load module menu. After that, experiment! Each module is different.

For command line options, use --help.

Hotkeys

Entry management

• Escape: Go one level up
• Shift+Escape: Go up to top level and trigger minimize
• Tab: Tab-complete the current input
• Enter / Left mouse button: Select entry or run command
• Shift+Enter: Select entry or run command but explicitly disable minimizing
• Ctrl+Enter: Run command with arguments
• Ctrl+. / Right mouse button on any item: Open context menu
• Ctrl+J / Down arrow: Go one entry down
• Ctrl+H / Up arrow: Go one entry up
• Ctrl+F / Page down: Go one page down
• Ctrl+B / Page up: Go one page up

Tab management

• Ctrl+T: Open new tab
• Ctrl+W: Close current tab
• Ctrl+Tab: Switch to next tab
• Ctrl+Shift+Tab: Switch to previous tab
• Alt+<number>: Switch to tab <number>
• F5: Reload tab, including code changes to the module

Session management

• Ctrl+Q: Quit

Community

If you need support or just want to chat with our community, we have the following options:

• Matrix: #pext:matrix.org (webchat)
• Telegram: @PextTool

Both channels are linked to each other, so there is no need to worry about missing out.

License

Pext is licensed under the GNU GPLv3+, with exception of artwork and documentation, which are licensed under the Creative Commons Attribution Share-Alike 4.0 license.

Under artwork and documentation fall:

• All files in the following directories:
  • assets/
  • docs/
  • pext/images/
  • .github/
• All Markdown files in the root directory.

When attributing the logo (which was donated by vaeringjar), it should be attributed as Lilly the leoger by White Paper Fox. Alternatively, it may be referred to as the Pext logo. Please link to Pext with https://github.com/Pext/Pext or https://pext.io/ and to White Paper Fox with http://www.whitepaperfox.com/ where possible.

pext_module_emoji's Issues

Tries to send invalid characters

Pext 0.31, Output Style set to Type Automatically. Happens when selecting pretty much any emoji.

WARN: Module Emoji caused exception (1, '')
Traceback (most recent call last):
  File "/home/sylvia/.local/lib/python3.7/site-packages/pynput/keyboard/_base.py", line 459, in type
    self.release(key)
  File "/home/sylvia/.local/lib/python3.7/site-packages/pynput/keyboard/_base.py", line 412, in release
    self._handle(resolved, False)
  File "/home/sylvia/.local/lib/python3.7/site-packages/pynput/keyboard/_xorg.py", line 197, in _handle
    raise self.InvalidKeyException(key)
pynput.keyboard._base.Controller.InvalidKeyException: ''

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "pext/__main__.py", line 873, in run
    self._process_module_action(index, module, focused_module)
  File "pext/__main__.py", line 753, in _process_module_action
    module.vm.close_request(False, False)
  File "pext/ui/qt5.py", line 1416, in close
    keyboard_device.type(output)
  File "/home/sylvia/.local/lib/python3.7/site-packages/pynput/keyboard/_base.py", line 462, in type
    raise self.InvalidCharacterException(i, character)
pynput.keyboard._base.Controller.InvalidCharacterException: (1, '')

Preview of Emoji Next to Highlighted Emoji

Already spoke with @TheLastProject for this feature, but I think it would look nice to have this feature.
Maybe under the emoji it can have tags like for the category belongs in like for the Pisces emoji under that preview screen it can have the tag "Astrology Signs".

Attached is an example of what I mean and it would definitely look really nice for emoji.

Module Should Display Message When No Emoji is Found

This is just an enhancement I think would help the emoji module. I understand the current state is to leave it blank but maybe in the middle of the window it can say No Results or somewhere relevant in the window so the user knows the search query they entered didn't give any results.

Dependabot couldn't find a requirements.txt for this project

Dependabot couldn't find a requirements.txt for this project.

Dependabot requires a requirements.txt to evaluate your project's current Python dependencies. It had expected to find one at the path: /requirements.txt.

If this isn't a Python project, or if it is a library, you may wish to disable updates for it from within Dependabot.

You can mention @dependabot in the comments below to contact the Dependabot team.

Bundle emoji font

From @roseusgarcia on July 1, 2018 19:33

Describe the bug
When looking for the female facepalm emoji, it gets replaced with the man version and the female symbol

To Reproduce
Steps to reproduce the behavior:

1. Go to the Emoji Module
2. Search facepalm
3. Scroll down to women facepalm
4. And you should see the wrong emoji displayed

Expected behavior
Well obviously the female version of facepalm

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

• OS: macOS Mojave
• Pext Version 0.16

Copied from original issue: Pext/Pext#121

Emoji Synonyms In Emoji Module

From @roseusgarcia on June 20, 2018 21:37

Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
So imagine your using the emoji module and you want to use a emoji that shows emotion of happiness. Wouldn't it be a great idea to type "happy" and all the smiley emojis come up or for sad maybe comes all the sad ones? Or even when you type LGBT the pride flag shows up instead of typing rainbow flag. There are endless amounts of examples.

Describe the solution you'd like
A clear and concise description of what you want to happen.
By simply typing happy or sad in the search should pop up the appropriate emojis

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.
Many software keyboards do this, I believe they used machine learning to determine the right emoji but I think it would make a great addition to the Pext emoji module. It would be much easier to find the right emoji.

Attached is good example where it can bring up the emojis

Copied from original issue: Pext/Pext#115