Pext/Pext

Name: Pext

Owner: Pext

Description: Python-based extendable tool

Created: 2016-01-06 18:16:31.0

Updated: 2018-05-22 08:15:58.0

Pushed: 2018-05-18 18:33:54.0

Homepage: https://pext.hackerchick.me/

Size: 7040

Language: Python

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Pext

Lilly the leoger

Build Status ReadTheDocs Translation status Code Health

Contents
Community

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

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

We can also be reached on Twitter: @PextTool

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.

Pext running the radiobrowser module with info panel Pext running the openweathermap module with context menu Pext running the emoji module

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:

Pext workflow graph

Simply put:

Installation

Note: If you run into any issues, please check out the troubleshooting section near the end of this document before reporting a bug.

GNU/Linux
Arch

Pext is available as pext and pext-git. These packages are maintained by Ivan Semkin.

Other distros

We recommend the AppImages under GitHub releases, but you can also install from PyPI.

For the stable version (PyPI):

 install pext --user

For the git version (PyPI):

 install git+https://github.com/Pext/Pext.git --user

On some systems, you may need to use pip instead of pip3.

Alternatively, you can install Pext from source

macOS

A macOS .dmg file is available in the releases section on GitHub. This is still experimental, please report any issues.

Alternatively, see Installing Pext from source

Windows (experimental)

See Installing Pext from source

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
Tab management
Session management
Troubleshooting
GNU/Linux
Installing module dependencies fails

Your distribution may ship with an outdated version of pip. Run pip install --upgrade pip (possibly as root) in a terminal.

Pext's window is completely white

The proprietary NVIDIA driver is known to cause this issue on at least Ubuntu. You can work around this by running sudo apt-get install python3-opengl.

Pext user report: https://github.com/Pext/Pext/issues/11 Ubuntu bug: https://bugs.launchpad.net/ubuntu/+source/python-qt4/+bug/941826

Windows
The python or pip commands do not work/The PATH variable is wrong

In the installer, make sure that 'Include Python in PATH' or similar is checked. Then after the installation, start a new command prompt and type python -V or pip3 to check if it was properly installed. If the version number and the help message are returned respectively, you are good to go further. If not, in case you already had cmd.exe open, restart it or execute refreshenv to reload environment variables. If it still does not work yet, check if the PATH was set in the GUI or manually with cmd.exe.

GUI:

cmd.exe:

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:

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.hackerchick.me/ and to White Paper Fox with http://www.whitepaperfox.com/ where possible.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.