lfp

commit b9eae69963f6748a30a8c172102d76b9a8420164

Author: Connor Etherington <[email protected]>

Date:   Mon Oct 2 08:55:39 2023 +0200

    Auto-Commit Update - 20231002

---

 BUILD/.pkg.pkg.tar.xz                              | Bin 0 -> 78520 bytes

 BUILD/.pkg/Makefile                                |  92 ++++

 BUILD/.pkg/README.md                               | 157 ++++++

 BUILD/.pkg/lfp.install                             |   9 +

 .../lfpreviewer/X.cpython-310-x86_64-linux-gnu.so  | Bin 0 -> 105296 bytes

 .../lfpreviewer/X.cpython-311-x86_64-linux-gnu.so  | Bin 0 -> 34696 bytes

 BUILD/.pkg/lfpreviewer/lfpreviewer/X/X.c           |  36 ++

 BUILD/.pkg/lfpreviewer/lfpreviewer/X/X.h           |   7 +

 BUILD/.pkg/lfpreviewer/lfpreviewer/X/Xshm.c        | 296 +++++++++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/X/Xshm.h        |   7 +

 BUILD/.pkg/lfpreviewer/lfpreviewer/X/display.c     | 276 ++++++++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/X/display.h     |  29 ++

 BUILD/.pkg/lfpreviewer/lfpreviewer/X/math.h        |   7 +

 BUILD/.pkg/lfpreviewer/lfpreviewer/X/python.h      |  11 +

 BUILD/.pkg/lfpreviewer/lfpreviewer/X/util.h        |  28 +

 BUILD/.pkg/lfpreviewer/lfpreviewer/X/window.c      | 316 +++++++++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/X/window.h      |   7 +

 BUILD/.pkg/lfpreviewer/lfpreviewer/__init__.py     |   7 +

 BUILD/.pkg/lfpreviewer/lfpreviewer/__main__.py     |  59 +++

 BUILD/.pkg/lfpreviewer/lfpreviewer/action.py       | 294 +++++++++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/batch.py        | 267 ++++++++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/conversion.py   |  14 +

 BUILD/.pkg/lfpreviewer/lfpreviewer/files.py        |  47 ++

 BUILD/.pkg/lfpreviewer/lfpreviewer/geometry.py     |  20 +

 BUILD/.pkg/lfpreviewer/lfpreviewer/layer.py        | 253 +++++++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/lib/__init__.py |   0

 BUILD/.pkg/lfpreviewer/lfpreviewer/lib/lib.sh      |  69 +++

 .../lfpreviewer/lfpreviewer/lib/v0/__init__.py     | 323 ++++++++++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/library.py      |   8 +

 BUILD/.pkg/lfpreviewer/lfpreviewer/loading.py      | 494 ++++++++++++++++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/parser.py       | 145 ++++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/pattern.py      |  12 +

 BUILD/.pkg/lfpreviewer/lfpreviewer/process.py      | 134 +++++

 .../.pkg/lfpreviewer/lfpreviewer/query_windows.py  |  99 ++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/scaling.py      | 264 ++++++++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/terminal.py     | 109 ++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/thread.py       |  48 ++

 BUILD/.pkg/lfpreviewer/lfpreviewer/tmux_util.py    | 103 ++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/ui.py           | 177 +++++++

 BUILD/.pkg/lfpreviewer/lfpreviewer/version.py      |   5 +

 BUILD/.pkg/lfpreviewer/lfpreviewer/xutil.py        | 144 +++++

 BUILD/.pkg/lfpreviewer/setup.py                    |  28 +

 BUILD/.pkg/usr/bin/lfp                             |   4 +

 BUILD/.pkg/usr/share/doc/lfp/README.md             | 157 ++++++

 BUILD/.pkg/usr/share/lfp/cleaner                   |   8 +

 BUILD/.pkg/usr/share/lfp/lfp                       |  14 +

 BUILD/.pkg/usr/share/lfp/lfp-icons                 | 117 +++++

 BUILD/.pkg/usr/share/lfp/lfpcd                     |   7 +

 BUILD/.pkg/usr/share/lfp/lfprc                     | 579 +++++++++++++++++++++

 BUILD/.pkg/usr/share/lfp/ocr/ocr.js                |  56 ++

 BUILD/.pkg/usr/share/lfp/ocr/package-lock.json     |  27 +

 BUILD/.pkg/usr/share/lfp/ocr/package.json          |  19 +

 BUILD/.pkg/usr/share/lfp/ocr/tesseract/LICENSE     |  21 +

 .../.pkg/usr/share/lfp/ocr/tesseract/package.json  |  37 ++

 BUILD/.pkg/usr/share/lfp/ocr/tesseract/readme.md   |  96 ++++

 .../usr/share/lfp/ocr/tesseract/src/index.d.ts     | 195 +++++++

 .../.pkg/usr/share/lfp/ocr/tesseract/src/index.js  |  58 +++

 BUILD/.pkg/usr/share/lfp/ocr/yarn.lock             |   8 +

 BUILD/.pkg/usr/share/lfp/scope                     |  42 ++

 BUILD/.pkg/usr/share/licenses/lfp/LICENSE          |  27 +

 BUILD/.pkg/usr/share/man/man1/lfp.1.gz             | Bin 0 -> 1916 bytes

 BUILD/PKGBUILD                                     |  54 ++

 BUILD/lfp.install                                  |   9 +

 BUILD/lfp/HEAD                                     |   1 +

 BUILD/lfp/config                                   |   8 +

 BUILD/lfp/description                              |   1 +

 BUILD/lfp/hooks/applypatch-msg.sample              |  15 +

 BUILD/lfp/hooks/commit-msg.sample                  |  24 +

 BUILD/lfp/hooks/fsmonitor-watchman.sample          | 174 +++++++

 BUILD/lfp/hooks/post-update.sample                 |   8 +

 BUILD/lfp/hooks/pre-applypatch.sample              |  14 +

 BUILD/lfp/hooks/pre-commit.sample                  |  49 ++

 BUILD/lfp/hooks/pre-merge-commit.sample            |  13 +

 BUILD/lfp/hooks/pre-push.sample                    |  53 ++

 BUILD/lfp/hooks/pre-rebase.sample                  | 169 ++++++

 BUILD/lfp/hooks/pre-receive.sample                 |  24 +

 BUILD/lfp/hooks/prepare-commit-msg.sample          |  42 ++

 BUILD/lfp/hooks/push-to-checkout.sample            |  78 +++

 BUILD/lfp/hooks/sendemail-validate.sample          |  77 +++

 BUILD/lfp/hooks/update.sample                      | 128 +++++

 BUILD/lfp/info/exclude                             |   6 +

 ...ck-8e07188bfd62ea160e5d9f224baaab63a0e44c15.idx | Bin 0 -> 88628 bytes

 ...k-8e07188bfd62ea160e5d9f224baaab63a0e44c15.pack | Bin 0 -> 56751126 bytes

 ...ck-8e07188bfd62ea160e5d9f224baaab63a0e44c15.rev | Bin 0 -> 12560 bytes

 BUILD/lfp/packed-refs                              |   2 +

 BUILD/pkg/lfp/usr/bin/lfp                          |   4 +

 BUILD/pkg/lfp/usr/bin/lfpreviewer                  |  33 ++

 .../lfpreviewer-0.1.0-py3.10.egg-info/PKG-INFO     |  12 +

 .../lfpreviewer-0.1.0-py3.10.egg-info/SOURCES.txt  |  35 ++

 .../dependency_links.txt                           |   1 +

 .../entry_points.txt                               |   2 +

 .../lfpreviewer-0.1.0-py3.10.egg-info/requires.txt |   3 +

 .../top_level.txt                                  |   1 +

 .../lfpreviewer/X.cpython-310-x86_64-linux-gnu.so  | Bin 0 -> 111600 bytes

 .../lib/python3.10/site-packages/lfpreviewer/X/X.c |  36 ++

 .../python3.10/site-packages/lfpreviewer/X/Xshm.c  | 296 +++++++++++

 .../site-packages/lfpreviewer/X/display.c          | 276 ++++++++++

 .../site-packages/lfpreviewer/X/window.c           | 316 +++++++++++

 .../site-packages/lfpreviewer/__init__.py          |   7 +

 .../site-packages/lfpreviewer/__main__.py          |  59 +++

 .../__pycache__/__init__.cpython-310.opt-1.pyc     | Bin 0 -> 508 bytes

 .../__pycache__/__init__.cpython-310.pyc           | Bin 0 -> 508 bytes

 .../__pycache__/__main__.cpython-310.opt-1.pyc     | Bin 0 -> 1973 bytes

 .../__pycache__/__main__.cpython-310.pyc           | Bin 0 -> 1973 bytes

 .../__pycache__/action.cpython-310.opt-1.pyc       | Bin 0 -> 9651 bytes

 .../lfpreviewer/__pycache__/action.cpython-310.pyc | Bin 0 -> 9651 bytes

 .../__pycache__/batch.cpython-310.opt-1.pyc        | Bin 0 -> 10837 bytes

 .../lfpreviewer/__pycache__/batch.cpython-310.pyc  | Bin 0 -> 10837 bytes

 .../__pycache__/conversion.cpython-310.opt-1.pyc   | Bin 0 -> 530 bytes

 .../__pycache__/conversion.cpython-310.pyc         | Bin 0 -> 530 bytes

 .../__pycache__/files.cpython-310.opt-1.pyc        | Bin 0 -> 1786 bytes

 .../lfpreviewer/__pycache__/files.cpython-310.pyc  | Bin 0 -> 1786 bytes

 .../__pycache__/geometry.cpython-310.opt-1.pyc     | Bin 0 -> 1121 bytes

 .../__pycache__/geometry.cpython-310.pyc           | Bin 0 -> 1121 bytes

 .../__pycache__/layer.cpython-310.opt-1.pyc        | Bin 0 -> 8537 bytes

 .../lfpreviewer/__pycache__/layer.cpython-310.pyc  | Bin 0 -> 8537 bytes

 .../__pycache__/library.cpython-310.opt-1.pyc      | Bin 0 -> 430 bytes

 .../__pycache__/library.cpython-310.pyc            | Bin 0 -> 430 bytes

 .../__pycache__/loading.cpython-310.opt-1.pyc      | Bin 0 -> 17686 bytes

 .../__pycache__/loading.cpython-310.pyc            | Bin 0 -> 17686 bytes

 .../__pycache__/parser.cpython-310.opt-1.pyc       | Bin 0 -> 5227 bytes

 .../lfpreviewer/__pycache__/parser.cpython-310.pyc | Bin 0 -> 5227 bytes

 .../__pycache__/pattern.cpython-310.opt-1.pyc      | Bin 0 -> 795 bytes

 .../__pycache__/pattern.cpython-310.pyc            | Bin 0 -> 795 bytes

 .../__pycache__/process.cpython-310.opt-1.pyc      | Bin 0 -> 3521 bytes

 .../__pycache__/process.cpython-310.pyc            | Bin 0 -> 3521 bytes

 .../query_windows.cpython-310.opt-1.pyc            | Bin 0 -> 2661 bytes

 .../__pycache__/query_windows.cpython-310.pyc      | Bin 0 -> 2661 bytes

 .../__pycache__/scaling.cpython-310.opt-1.pyc      | Bin 0 -> 10006 bytes

 .../__pycache__/scaling.cpython-310.pyc            | Bin 0 -> 10006 bytes

 .../__pycache__/terminal.cpython-310.opt-1.pyc     | Bin 0 -> 2958 bytes

 .../__pycache__/terminal.cpython-310.pyc           | Bin 0 -> 2958 bytes

 .../__pycache__/thread.cpython-310.opt-1.pyc       | Bin 0 -> 1842 bytes

 .../lfpreviewer/__pycache__/thread.cpython-310.pyc | Bin 0 -> 1842 bytes

 .../__pycache__/tmux_util.cpython-310.opt-1.pyc    | Bin 0 -> 3183 bytes

 .../__pycache__/tmux_util.cpython-310.pyc          | Bin 0 -> 3183 bytes

 .../__pycache__/ui.cpython-310.opt-1.pyc           | Bin 0 -> 6572 bytes

 .../lfpreviewer/__pycache__/ui.cpython-310.pyc     | Bin 0 -> 6572 bytes

 .../__pycache__/version.cpython-310.opt-1.pyc      | Bin 0 -> 303 bytes

 .../__pycache__/version.cpython-310.pyc            | Bin 0 -> 303 bytes

 .../__pycache__/xutil.cpython-310.opt-1.pyc        | Bin 0 -> 5092 bytes

 .../lfpreviewer/__pycache__/xutil.cpython-310.pyc  | Bin 0 -> 5092 bytes

 .../python3.10/site-packages/lfpreviewer/action.py | 294 +++++++++++

 .../python3.10/site-packages/lfpreviewer/batch.py  | 267 ++++++++++

 .../site-packages/lfpreviewer/conversion.py        |  14 +

 .../python3.10/site-packages/lfpreviewer/files.py  |  47 ++

 .../site-packages/lfpreviewer/geometry.py          |  20 +

 .../python3.10/site-packages/lfpreviewer/layer.py  | 253 +++++++++

 .../site-packages/lfpreviewer/lib/__init__.py      |   0

 .../lib/__pycache__/__init__.cpython-310.opt-1.pyc | Bin 0 -> 154 bytes

 .../lib/__pycache__/__init__.cpython-310.pyc       | Bin 0 -> 154 bytes

 .../site-packages/lfpreviewer/lib/lib.sh           |  69 +++

 .../site-packages/lfpreviewer/lib/v0/__init__.py   | 323 ++++++++++++

 .../v0/__pycache__/__init__.cpython-310.opt-1.pyc  | Bin 0 -> 11202 bytes

 .../lib/v0/__pycache__/__init__.cpython-310.pyc    | Bin 0 -> 11202 bytes

 .../site-packages/lfpreviewer/library.py           |   8 +

 .../site-packages/lfpreviewer/loading.py           | 494 ++++++++++++++++++

 .../python3.10/site-packages/lfpreviewer/parser.py | 145 ++++++

 .../site-packages/lfpreviewer/pattern.py           |  12 +

 .../site-packages/lfpreviewer/process.py           | 134 +++++

 .../site-packages/lfpreviewer/query_windows.py     |  99 ++++

 .../site-packages/lfpreviewer/scaling.py           | 264 ++++++++++

 .../site-packages/lfpreviewer/terminal.py          | 109 ++++

 .../python3.10/site-packages/lfpreviewer/thread.py |  48 ++

 .../site-packages/lfpreviewer/tmux_util.py         | 103 ++++

 .../lib/python3.10/site-packages/lfpreviewer/ui.py | 177 +++++++

 .../site-packages/lfpreviewer/version.py           |   5 +

 .../python3.10/site-packages/lfpreviewer/xutil.py  | 144 +++++

 BUILD/pkg/lfp/usr/share/doc/lfp/README.md          | 157 ++++++

 BUILD/pkg/lfp/usr/share/lfp/cleaner                |   8 +

 BUILD/pkg/lfp/usr/share/lfp/lfp                    |  14 +

 BUILD/pkg/lfp/usr/share/lfp/lfp-icons              | 117 +++++

 BUILD/pkg/lfp/usr/share/lfp/lfpcd                  |   7 +

 BUILD/pkg/lfp/usr/share/lfp/lfprc                  | 579 +++++++++++++++++++++

 BUILD/pkg/lfp/usr/share/lfp/ocr/ocr.js             |  56 ++

 BUILD/pkg/lfp/usr/share/lfp/ocr/package.json       |  19 +

 BUILD/pkg/lfp/usr/share/lfp/scope                  |  42 ++

 BUILD/pkg/lfp/usr/share/licenses/lfp/LICENSE       |  27 +

 BUILD/pkg/lfp/usr/share/man/man1/lfp.1.gz          | Bin 0 -> 1916 bytes

 BUILD/src/lfp                                      |   1 +

 BUILD/tmpPKGB                                      |  45 ++

 BUILD/zst.sums                                     |   8 +

 182 files changed, 12012 insertions(+)

diff --git a/BUILD/.pkg.pkg.tar.xz b/BUILD/.pkg.pkg.tar.xz

new file mode 100644

index 0000000..c9fdb8d

Binary files /dev/null and b/BUILD/.pkg.pkg.tar.xz differ

diff --git a/BUILD/.pkg/Makefile b/BUILD/.pkg/Makefile

new file mode 100644

index 0000000..ac1b8bb

--- /dev/null

+++ b/BUILD/.pkg/Makefile

@@ -0,0 +1,92 @@

+

+PKG = lfp

+PREVIEWER = lfpreviewer

+

+INFO = $(shell uname -a)

+OST = $(shell lsb_release -d | sed 's|Description:\s*||')

+OS = $(shell lsb_release -d | sed 's|Description:\s*||'|cut -d\  -f1)

+

+ifeq ($(OS),Ubuntu)

+	PACKAGE_MANAGER = apt

+	INSTALL = sudo ${PACKAGE_MANAGER}-get install

+	QUERY = sudo dpkg -S >/dev/null 2>&1

+	PKGS = python3-pip python3-setuptools libxres1

+endif

+

+ifeq ($(OS),Debian)

+	PACKAGE_MANAGER = apt

+	INSTALL = sudo ${PACKAGE_MANAGER}-get install

+	QUERY = sudo dpkg -S >/dev/null 2>&1

+	PKGS = python3-pip python3-setuptools libxres1

+endif

+

+ifeq ($(OS),Arch)

+	PACKAGE_MANAGER = pacman

+	INSTALL = sudo ${PACKAGE_MANAGER} -Syy

+	QUERY = sudo ${PACKAGE_MANAGER} -Qq >/dev/null 2>&1

+	PKGS = python-pip python-setuptools libxres

+endif

+

+ifeq ($(PACKAGE_MANAGER),)

+$(error >   Unsupported OS: ${OST})

+endif

+

+all: info

+

+lfpreviewer:

+	@echo -e "\n\e[1;33m[+]\e[0m Installing ${PREVIEWER}...\n"

+	@rm -rf ${PREVIEWER}/build ${PREVIEWER}/${PREVIEWER}.egg-info ${PREVIEWER}/dist

+	@${QUERY} ${PKGS} || ${INSTALL} ${PKGS}

+	@python3 -m pip install --upgrade pip

+	@python3 -m pip install --upgrade setuptools

+	@cd ${PREVIEWER} && python3 ./setup.py install && cd .. || true

+	@which lfpreviewer >/dev/null 2>&1 || echo -e "\n\e[1;31m[-]\e[0m Please ensure you have sufficient premission to install ${PREVIEWER}."

+

+lfp:

+	@echo -e "\n\e[1;33m[+]\e[0m Installing ${PKG}...\n"

+	@sudo install -Dm755 usr/bin/* -t "${PKGDIR}/usr/bin" || true

+	@sudo install -Dm755 usr/share/${PKG}/{${PKG},${PKG}cd,cleaner,scope} -t "${PKGDIR}/usr/share/${PKG}" || true

+	@sudo install -Dm644 usr/share/${PKG}/{${PKG}-icons,${PKG}rc} -t "${PKGDIR}/usr/share/${PKG}" || true

+	@sudo install -Dm644 usr/share/licenses/${PKG}/LICENSE "${PKGDIR}/usr/share/licenses/${PKG}/LICENSE" || true

+	@sudo install -Dm644 usr/share/doc/${PKG}/README.md "${PKGDIR}/usr/share/doc/${PKG}/README.md" || true

+	@sudo install -Dm644 usr/share/man/man1/${PKG}.1.gz "${PKGDIR}/usr/share/man/man1/${PKG}.1.gz" || true

+	@[ ! -d /usr/share/lfp ] && echo -e "\n\e[1;31m[-]\e[0m Please ensure you have sufficient premission to install ${PKG}." || true

+

+install: lfpreviewer lfp cd-on-exit

+

+clean:

+	@echo -e "\n\e[1;33m[+]\e[0m Cleaning up..."

+	@sudo rm -rf ${PKGDIR}/lib/python3.*/site-packages/${PREVIEWER}*

+	@sudo rm -rf ${PKGDIR}/usr/bin/${PREVIEWER}

+	@sudo rm -rf ${PKGDIR}/usr/share/${PKG}

+	@sudo rm -rf ${PKGDIR}/usr/bin/${PKG}

+	@sudo rm -rf ${PKGDIR}/usr/bin/${PKG}cd

+	@sudo rm -rf ${PKGDIR}/usr/bin/cleaner

+	@sudo rm -rf ${PKGDIR}/usr/bin/scope

+	@sudo rm -rf ${PKGDIR}/usr/share/licenses/${PKG}

+	@sudo rm -rf ${PKGDIR}/usr/share/doc/${PKG}

+	@sudo rm -rf ${PKGDIR}/usr/share/man/man1/${PKG}.1.gz

+

+info:

+	@echo -e "\n\e[1;33m[*]\e[0m ${INFO}"

+

+help:

+	@echo -e "\n	Usage: make [all|install|uninstall|clean|distclean|preview|help]\n"

+	@echo "	     all: build $(PKG)"

+	@echo "	     install: install $(PKG)"

+	@echo "	     uninstall: uninstall $(PKG)"

+	@echo "	     clean: clean $(PKG)"

+	@echo "	     distclean: clean $(PKG) and remove $(PKG) directory"

+	@echo "	     preview: preview $(PKG)"

+	@echo "	     help: show this help"

+

+cd-on-exit:

+	@[ -d /usr/share/lfp ] && echo -e "\n\n\033[1;32m[+]\e[0;1m For on-exit directory changing, add the following line to your bash/zshrc\e[0m :\e[36m\n\n   source '/usr/share/lfp/lfpcd'\n\e[0m" || echo -e "\n\033[1;31m[!]\e[0;1m Installation Failed!"

+

+uninstall: clean

+	@echo -e "\n\e[1;32m[+]\e[0m ${PKG} successfully uninstalled"

+

+remove: uninstall

+

+.PHONY: info all lfpreviewer lfp install clean help cd-on-exit uninstall remove

+

diff --git a/BUILD/.pkg/README.md b/BUILD/.pkg/README.md

new file mode 100644

index 0000000..f3d345a

--- /dev/null

+++ b/BUILD/.pkg/README.md

@@ -0,0 +1,157 @@

+

+# An lf wrapper, with built-in previews and on-exit directory changing.

+

+### `lfp` is a simple wrapper for the `lf` file manager, with built-in file, image, and video previews, as well as on-exit directory changing.

+### The program makes use of `ueberzug` to preview images, documents, and video thumbnails. Preview behavior can be altered by editing the *scope* file.

+

+**Version: 4.1.0**

+

+***

+

+## Usage:

+

+Run `lfp`. Optionally, a startup directory can be specified by a second argument. By default, `lfp` will launch in your current working directory.

+Icons for relative file types can be changed by editing the lfp-icons file in *'/usr/share/lfp/lfp-icons'*.

+

+**CD on exit:**

+

+For on-exit directory changing, add the following line to your bash/zshrc:

+

+    source '/usr/share/lfp/lfpcd'

+

+

+**LFP OCR:**

+

+LFP OCR is a simple OCR script that uses tesseract to extract text from images. It can be used as a standalone script, or as a lfp action.

+All detected text is copied to your clipboard.

+

+

+

+

+## Installation

+

+### Arch Linux

+

+lfp is available in the AUR as `lfp` or `lfp-git`

+

+

+### Manual Installation

+

+    tmp=$(mktemp -d);

+    git clone https://gitlab.com/a4to/lfp.git ${tmp} &&

+    cd ${tmp} && sudo make clean install && cd - &&

+    rm -rf ${tmp} >/dev/null 2>&1 || true

+

+

+**To uninstall lfp:**

+

+    sudo make uninstall

+

+

+

+## Prerequisites:

+

+* `lf`: the file manager

+* `zsh`: for scripting

+* `ueberzug`: for image previews

+* `ghostscript`: for PDF previews

+* `graphicsmagick`: for SVG and GIF previews

+* `ffmpeg`: for video file thumbnail previews

+* `dialog`: required by many functions outside the scope of image and video previews

+* `dunst`: to receive notifications upon task completion and so forth

+* `fzf`: for lfp's *fzfp* (fuzzy-finding) and *pushto* (git push) capabilities

+* `bat`: for text file previews

+* `git`: for cloning repos from within lfp

+* `lolcat`: used in lfp's *fzfp* function

+

+## Optional Dependencies:

+

+* `nodejs`: to make use of lfps built in node actions manager

+* `python3`: to make use of lfps built in python actions manager

+

+

+

+## Keybindings

+

+### Navigation:

+

+* **h**: Left

+* **j**: Down

+* **k**: Up

+* **l**: Right

+

+

+### Main Features and Functions:

+

+* **.**: Activate NodeManager

+* **,**: Activate PyManager

+* **o**: Activate LFP OCR

+* **v**: Toggle select all file(s)

+* **y**: Copy selected file(s)

+* **c**: Cut selected file(s)

+* **d**: Delete selected file(s)

+* **p**: Paste selected file(s)

+* **d**: Delete selected file(s)

+* **s**: Edit file you're currently hovering over

+* **n**: Create new directory

+* **m**: Play with mpv

+* **f**: Activate fzfp (lfp's fuzzy-finder)

+* **b**: Open file in default browser

+* **e**: Prompts you for a filename to edit/create

+* **t**: Prompts you for a filename for blank file to create

+* **x**: Execute selected file(s)

+* **z**: Open in `sxiv` (an image viewer)

+* **q**: Quit lfp

+* **\<Space\>**: Select file(s)

+* **\<Period\>**: (.) - Activates Node Actions, various npm/yarn actions / quick command execution

+

+

+### NodeManager:

+

+The NodeManager function provides various actions to manage a Node.js project, including:

+

+* **↑ Arrow**: Initialize a package.json file.

+* **↓ Arrow**: Select a javascript file to run.

+* **← Arrow**: Specify package(s) to install from npm.

+* **→ Arrow**: Start the server (yarn start).

+* **[h|d|m]**:: Start the server in development mode (yarn dev).

+* **[b|n]**: Build the project (yarn build).

+* **[i|I|,]**: Initialize a new npm project.

+* **[r]**: Remove specified packages.

+* **.**: Update the server (yarn).

+* **/**: Create a webserver on port 3000 (requires serve).

+* **q**: Exit.

+

+

+### PyManager:

+

+The PyManager function provides various actions to manage a Python project, including:

+

+* **↑ Arrow**: Create a new Conda environment at "./.🐍".

+* **↓ Arrow**: Select a python script to run.

+* **← Arrow**: Select package(s) to install from pypi.

+* **→ Arrow**: Run the main.py script if found.

+* **q**: Exit.

+

+

+### Additional Actions and Features:

+

+* **B**: Bulk rename

+* **E**: Extract archive

+* **D**: (sudo) Delete selected file(s)

+* **L**: Symlink selected file(s) to current directory

+* **H**: Create hardlink of selected file(s) to current directory

+* **R**: Create relative symlink of selected file(s) to current directory

+* **E**: Extract archive (bz2 rar gz tar tar.* tbz2 tgz zip Z 7z deb)

+* **C**: CopyPath, this feature copies the absolute path of the file youre currently hovering over to your clipboard

+* **\<Ctrl+c\>**: Quick clone a git repository without leaving lfp

+* **\<Ctrl+g\>**: Activate pushto - select a branch to push to (only works inside a git repo)

+* **\<Ctrl+b\>**: Open file in browser

+* **\<Ctrl+6\>**: Chmod 644 selected file(s)

+* **\<Ctrl+7\>**: Chmod 755 selected file(s)

+* **\<Ctrl+8\>**: Chmod 700 selected file(s)

+* **\<Enter\>**: Enter shell command

+

+

+And many more.

+

diff --git a/BUILD/.pkg/lfp.install b/BUILD/.pkg/lfp.install

new file mode 100644

index 0000000..6c915df

--- /dev/null

+++ b/BUILD/.pkg/lfp.install

@@ -0,0 +1,9 @@

+post_install() {

+  echo -e "\n \033[1;33m[+]\e[0;1;32m For on-exit directory changing, add the following line to your bash/zshrc\e[0m :\e[36m\n\n     source '/usr/share/lfp/lfpcd'\n\n\n\e[0m"

+}

+

+post_upgrade() {

+  which yarn >/dev/null 2>&1 && yarn install /usr/share/lfp/ocr ||

+    which npm >/dev/null 2>&1 && npm install /usr/share/lfp/ocr ||

+    true

+}

diff --git a/BUILD/.pkg/lfpreviewer/lfpreviewer/X.cpython-310-x86_64-linux-gnu.so b/BUILD/.pkg/lfpreviewer/lfpreviewer/X.cpython-310-x86_64-linux-gnu.so

new file mode 100755

index 0000000..982026a

Binary files /dev/null and b/BUILD/.pkg/lfpreviewer/lfpreviewer/X.cpython-310-x86_64-linux-gnu.so differ

diff --git a/BUILD/.pkg/lfpreviewer/lfpreviewer/X.cpython-311-x86_64-linux-gnu.so b/BUILD/.pkg/lfpreviewer/lfpreviewer/X.cpython-311-x86_64-linux-gnu.so

new file mode 100755

index 0000000..fcdf720

Binary files /dev/null and b/BUILD/.pkg/lfpreviewer/lfpreviewer/X.cpython-311-x86_64-linux-gnu.so differ

diff --git a/BUILD/.pkg/lfpreviewer/lfpreviewer/X/X.c b/BUILD/.pkg/lfpreviewer/lfpreviewer/X/X.c

new file mode 100644

index 0000000..ac2c09a

--- /dev/null

+++ b/BUILD/.pkg/lfpreviewer/lfpreviewer/X/X.c

@@ -0,0 +1,36 @@

+#include "python.h"

+#include "display.h"

+#include "window.h"

+#include "Xshm.h"

+

+

+static PyModuleDef module = {

+    PyModuleDef_HEAD_INIT,

+    .m_name = "lfpreviewer.X",

+    .m_doc = "Modul which implements the interaction with the Xshm extension.",

+    .m_size = -1,

+};

+

+

+PyMODINIT_FUNC

+PyInit_X(void) {

+    PyObject *module_instance;

+    if (PyType_Ready(&DisplayType) < 0 ||

+            PyType_Ready(&WindowType) < 0 ||

+            PyType_Ready(&ImageType) < 0) {

+        return NULL;

+    }

+

+    module_instance = PyModule_Create(&module);

+    if (module_instance == NULL) {

+        return NULL;

+    }

+

+    Py_INCREF(&DisplayType);

+    Py_INCREF(&WindowType);

+    Py_INCREF(&ImageType);

+    PyModule_AddObject(module_instance, "Display", (PyObject*)&DisplayType);

+    PyModule_AddObject(module_instance, "OverlayWindow", (PyObject*)&WindowType);

+    PyModule_AddObject(module_instance, "Image", (PyObject*)&ImageType);

+    return module_instance;

+}

diff --git a/BUILD/.pkg/lfpreviewer/lfpreviewer/X/X.h b/BUILD/.pkg/lfpreviewer/lfpreviewer/X/X.h

new file mode 100644

index 0000000..2523c59

--- /dev/null

+++ b/BUILD/.pkg/lfpreviewer/lfpreviewer/X/X.h

@@ -0,0 +1,7 @@

+#ifndef __X_H__

+#define __X_H__

+#include "python.h"

+

+

+PyModuleDef module;

+#endif

diff --git a/BUILD/.pkg/lfpreviewer/lfpreviewer/X/Xshm.c b/BUILD/.pkg/lfpreviewer/lfpreviewer/X/Xshm.c

new file mode 100644

index 0000000..b68919a

--- /dev/null

+++ b/BUILD/.pkg/lfpreviewer/lfpreviewer/X/Xshm.c

@@ -0,0 +1,296 @@

+#include "python.h"

+

+#include <stdbool.h>

+#include <sys/shm.h>

+#include <X11/Xlib.h>

+#include <X11/Xutil.h>

+#include <X11/extensions/XShm.h>

+

+#include "math.h"

+#include "util.h"

+#include "display.h"

+

+#define INVALID_SHM_ID -1

+#define INVALID_SHM_ADDRESS (char*)-1

+#define BYTES_PER_PIXEL 4

+

+

+typedef struct {

+    PyObject_HEAD

+    int width;

+    int height;

+    int buffer_size;

+    DisplayObject *display_pyobject;

+    XShmSegmentInfo segmentInfo;

+    XImage *image;

+} ImageObject;

+

+

+static inline Display *

+get_display(ImageObject *self) {

+    return self->display_pyobject->event_display;

+}

+

+static bool

+Image_init_shared_memory(ImageObject *self) {

+    self->segmentInfo.shmid = shmget(

+        IPC_PRIVATE,

+        self->buffer_size,

+        IPC_CREAT | 0600);

+    return self->segmentInfo.shmid != INVALID_SHM_ID;

+}

+

+static bool

+Image_map_shared_memory(ImageObject *self) {

+    // Map the shared memory segment into the address space of this process

+    self->segmentInfo.shmaddr = (char*)shmat(self->segmentInfo.shmid, 0, 0);

+

+    if (self->segmentInfo.shmaddr != INVALID_SHM_ADDRESS) {

+        self->segmentInfo.readOnly = true;

+        // Mark the shared memory segment for removal

+        // It will be removed even if this program crashes

+        shmctl(self->segmentInfo.shmid, IPC_RMID, 0);

+        return true;

+    }

+

+    return false;

+}

+

+static bool

+Image_create_shared_image(ImageObject *self) {

+    Display *display = get_display(self);

+    int screen = XDefaultScreen(display);

+    // Allocate the memory needed for the XImage structure

+    self->image = XShmCreateImage(

+        display, XDefaultVisual(display, screen),

+        DefaultDepth(display, screen), ZPixmap, 0,

+        &self->segmentInfo, 0, 0);

+

+    if (self->image) {

+        self->image->data = (char*)self->segmentInfo.shmaddr;

+        self->image->width = self->width;

+        self->image->height = self->height;

+

+        // Ask the X server to attach the shared memory segment and sync

+        XShmAttach(display, &self->segmentInfo);

+        XFlush(display);

+        return true;

+    }

+    return false;

+}

+

+static void

+Image_destroy_shared_image(ImageObject *self) {

+    if (self->image) {

+        XShmDetach(get_display(self), &self->segmentInfo);

+        XDestroyImage(self->image);

+        self->image = NULL;

+    }

+}

+

+static void

+Image_free_shared_memory(ImageObject *self) {

+    if(self->segmentInfo.shmaddr != INVALID_SHM_ADDRESS) {

+        shmdt(self->segmentInfo.shmaddr);

+        self->segmentInfo.shmaddr = INVALID_SHM_ADDRESS;

+    }

+}

+

+static void

+Image_finalise(ImageObject *self) {

+    Image_destroy_shared_image(self);

+    Image_free_shared_memory(self);

+    Py_CLEAR(self->display_pyobject);

+}

+

+static int

+Image_init(ImageObject *self, PyObject *args, PyObject *kwds) {

+    static char *kwlist[] = {"display", "width", "height", NULL};

+    PyObject *display_pyobject;

+

+    if (!PyArg_ParseTupleAndKeywords(

+            args, kwds, "O!ii", kwlist,

+            &DisplayType, &display_pyobject,

+            &self->width, &self->height)) {

+        Py_INIT_RETURN_ERROR;

+    }

+

+    if (self->display_pyobject) {

+        Image_finalise(self);

+    }

+

+    Py_INCREF(display_pyobject);

+    self->display_pyobject = (DisplayObject*)display_pyobject;

+    self->buffer_size = self->width * self->height * BYTES_PER_PIXEL;

+

+    if (!Image_init_shared_memory(self)) {

+        raiseInit(OSError, "could not init shared memory");

+    }

+

+    if (!Image_map_shared_memory(self)) {

+        raiseInit(OSError, "could not map shared memory");

+    }

+

+    if (!Image_create_shared_image(self)) {

+        Image_free_shared_memory(self);

+        raiseInit(OSError, "could not allocate the XImage structure");

+    }

+    

+    Py_INIT_RETURN_SUCCESS;

+}

+

+static void

+Image_dealloc(ImageObject *self) {

+    Image_finalise(self);

+    Py_TYPE(self)->tp_free((PyObject*)self);

+}

+

+static PyObject *

+Image_copy_to(ImageObject *self, PyObject *args, PyObject *kwds) {

+    // draws the image on the surface at x, y

+    static char *kwlist[] = {"drawable", "x", "y", "width", "height", NULL};

+    Drawable surface;

+    GC gc;

+    int x, y;

+    unsigned int width, height;

+    Display *display = get_display(self);

+

+    if (!PyArg_ParseTupleAndKeywords(

+            args, kwds, "kiiII", kwlist,

+            &surface, &x, &y, &width, &height)) {

+        Py_RETURN_ERROR;

+    }

+

+    gc = XCreateGC(display, surface, 0, NULL);

+    XShmPutImage(display, surface, gc,

+                 self->image, 0, 0,

+                 x, y, width, height, false);

+    XFreeGC(display, gc);

+

+    Py_RETURN_NONE;

+}

+

+static PyObject *

+Image_draw(ImageObject *self, PyObject *args, PyObject *kwds) {

+    // puts the pixels on the image at x, y

+    static char *kwlist[] = {"x", "y", "width", "height", "pixels", NULL};

+    int offset_x, offset_y;

+    int width, height;

+    int pixels_per_row;

+    int source_pixels_per_row;

+    int destination_pixels_per_row;

+    int destination_offset_x_bytes;

+    char *pixels;

+    Py_ssize_t pixels_size;

+

+    if (!PyArg_ParseTupleAndKeywords(

+            args, kwds, "iiiis#", kwlist,

+            &offset_x, &offset_y, &width, &height,

+            &pixels, &pixels_size)) {

+        Py_RETURN_ERROR;

+    }

+

+    Py_BEGIN_ALLOW_THREADS

+    destination_offset_x_bytes = max(0, offset_x) * BYTES_PER_PIXEL;

+    source_pixels_per_row = width * BYTES_PER_PIXEL;

+    destination_pixels_per_row = self->width * BYTES_PER_PIXEL;

+    pixels_per_row = min(width + min(offset_x, 0), self->width - max(offset_x, 0)) * BYTES_PER_PIXEL;

+

+    if (offset_x + width > 0 && offset_x < self->width) {

+        // < 0 -> start y = 0, min(surface.height, height - abs(offset))

+        // > 0 -> start y = offset, height = min(surface.height, height + offset)

+        for (int y = max(0, offset_y); y < min(self->height, height + offset_y); y++) {

+            // < 0 -> first row = abs(offset) => n row = y + abs(offset)

+            // > 0 -> first row = - offset    => n row = y - offset

+            // => n row = y - offset

+            int pixels_y = y - offset_y;

+            void *destination =

+                self->image->data + y * destination_pixels_per_row

+                + destination_offset_x_bytes;

+            void *source = pixels + pixels_y * source_pixels_per_row;

+

+            if (! ((uintptr_t)self->image->data <= (uintptr_t)destination)) {

+                raise(AssertionError,

+                      "The destination start address calculation went wrong.\n"

+                      "It points to an address which is before the start address of the buffer.\n"

+                      "%p not smaller than %p",

+                      self->image->data, destination);

+            }

+            if (! ((uintptr_t)destination + pixels_per_row

+                   <= (uintptr_t)self->image->data + self->buffer_size)) {

+                raise(AssertionError,

+                      "The destination end address calculation went wrong.\n"

+                      "It points to an address which is after the end address of the buffer.\n"

+                      "%p not smaller than %p",

+                      destination + pixels_per_row,

+                      self->image->data + self->buffer_size);

+            }

+            if (! ((uintptr_t)pixels <= (uintptr_t)source)) {

+                raise(AssertionError,

+                      "The source start address calculation went wrong.\n"

+                      "It points to an address which is before the start address of the buffer.\n"

+                      "%p not smaller than %p",

+                      pixels, source);

+            }

+            if (! ((uintptr_t)source + pixels_per_row

+                   <= (uintptr_t)pixels + pixels_size)) {

+                raise(AssertionError,

+                      "The source end address calculation went wrong.\n"

+                      "It points to an address which is after the end address of the buffer."

+                      "%p not smaller than %p",

+                      source + pixels_per_row,

+                      pixels + pixels_size);

+            }

+

+            memcpy(destination, source, pixels_per_row);

+        }

+    }

+    Py_END_ALLOW_THREADS

+

+    Py_RETURN_NONE;

+}

+

+static PyMethodDef Image_methods[] = {

+    {"copy_to", (PyCFunction)Image_copy_to,

+     METH_VARARGS | METH_KEYWORDS,

+     "Draws the image on the surface at the passed coordinate.\n"

+     "\n"

+     "Args:\n"

+     "    drawable (int): the surface to draw on\n"

+     "    x (int): the x position where this image should be placed\n"

+     "    y (int): the y position where this image should be placed\n"

+     "    width (int): the width of the area\n"

+     "                 which should be copied to the drawable\n"

+     "    height (int): the height of the area\n"

+     "                  which should be copied to the drawable"},

+    {"draw", (PyCFunction)Image_draw,

+     METH_VARARGS | METH_KEYWORDS,

+     "Places the pixels on the image at the passed coordinate.\n"

+     "\n"

+     "Args:\n"

+     "    x (int): the x position where the pixels should be placed\n"

+     "    y (int): the y position where the pixels should be placed\n"

+     "    width (int): amount of pixels per row in the passed data\n"

+     "    height (int): amount of pixels per column in the passed data\n"

+     "    pixels (bytes): the pixels to place on the image"},

+    {NULL}  /* Sentinel */

+};

+

+PyTypeObject ImageType = {

+    PyVarObject_HEAD_INIT(NULL, 0)

+    .tp_name = "lfpreviewer.X.Image",

+    .tp_doc = 

+        "An shared memory X11 Image\n"

+        "\n"

+        "Args:\n"

+        "    display (lfpreviewer.X.Display): the X11 display\n"

+        "    width (int): the width of this image\n"

+        "    height (int): the height of this image",

+    .tp_basicsize = sizeof(ImageObject),

+    .tp_itemsize = 0,

+    .tp_flags = Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE,

+    .tp_new = PyType_GenericNew,

+    .tp_init = (initproc)Image_init,

+    .tp_dealloc = (destructor) Image_dealloc,

+    .tp_methods = Image_methods,

+};

diff --git a/BUILD/.pkg/lfpreviewer/lfpreviewer/X/Xshm.h b/BUILD/.pkg/lfpreviewer/lfpreviewer/X/Xshm.h

new file mode 100644

index 0000000..ab61b4d

--- /dev/null

+++ b/BUILD/.pkg/lfpreviewer/lfpreviewer/X/Xshm.h

@@ -0,0 +1,7 @@

+#ifndef __XSHM_H__

+#define __XSHM_H__

+#include "python.h"

+

+

+extern PyTypeObject ImageType;

+#endif

diff --git a/BUILD/.pkg/lfpreviewer/lfpreviewer/X/display.c b/BUILD/.pkg/lfpreviewer/lfpreviewer/X/display.c

new file mode 100644

index 0000000..c9e4eee

--- /dev/null

+++ b/BUILD/.pkg/lfpreviewer/lfpreviewer/X/display.c

@@ -0,0 +1,276 @@

+#include "python.h"

+

+#include <X11/Xlib.h>

+#include <X11/extensions/XRes.h>

+#include <X11/extensions/XShm.h>

+

+#include "util.h"

+#include "display.h"

+

+

+#define INVALID_PID (pid_t)-1

+

+

+#define REOPEN_DISPLAY(display) \

+    if (display != NULL) { \

+        XCloseDisplay(display); \

+    } \

+    display = XOpenDisplay(NULL);

+

+#define CLOSE_DISPLAY(display) \

+    if (display != NULL) { \

+        XCloseDisplay(display); \

+        display = NULL; \

+    }

+

+

+static int

+Display_init(DisplayObject *self, PyObject *args, PyObject *kwds) {

+    // Two connections are opened as

+    // a death lock can occur

+    // if you listen for events

+    // (this will happen in parallel in asyncio worker threads)

+    // and request information (e.g. XGetGeometry)

+    // simultaneously.

+    REOPEN_DISPLAY(self->event_display);

+    REOPEN_DISPLAY(self->info_display);

+

+    if (self->event_display == NULL ||

+            self->info_display == NULL) {

+        raiseInit(OSError, "could not open a connection to the X server");

+    }

+

+    int _;

+    if (!XResQueryExtension(self->info_display, &_, &_)) {

+        raiseInit(OSError, "the extension XRes is required");

+    }

+

+    if (!XShmQueryExtension(self->event_display)) {

+        raiseInit(OSError, "the extension Xext is required");

+    }

+

+    int screen = XDefaultScreen(self->info_display);

+    self->screen_width = XDisplayWidth(self->info_display, screen);

+    self->screen_height = XDisplayHeight(self->info_display, screen);

+    self->bitmap_pad = XBitmapPad(self->info_display);

+    self->bitmap_unit = XBitmapUnit(self->info_display);

+

+    self->wm_class = XInternAtom(self->info_display, "WM_CLASS", False);

+    self->wm_name = XInternAtom(self->info_display, "WM_NAME", False);

+    self->wm_locale_name = XInternAtom(self->info_display, "WM_LOCALE_NAME", False);

+    self->wm_normal_hints = XInternAtom(self->info_display, "WM_NORMAL_HINTS", False);

+

+    Py_INIT_RETURN_SUCCESS;

+}

+

+static void

+Display_dealloc(DisplayObject *self) {

+    CLOSE_DISPLAY(self->event_display);

+    CLOSE_DISPLAY(self->info_display);

+    Py_TYPE(self)->tp_free((PyObject*)self);

+}

+

+

+static int

+has_property(DisplayObject *self, Window window, Atom property) {

+    Atom actual_type_return;

+    int actual_format_return;

+    unsigned long bytes_after_return;

+    unsigned char* prop_to_return = NULL;

+    unsigned long nitems_return;

+

+    int status = XGetWindowProperty(

+        self->info_display, window, property, 0,

+        0L, False,

+        AnyPropertyType,

+        &actual_type_return,

+        &actual_format_return,

+        &nitems_return, &bytes_after_return, &prop_to_return);

+    if (status == Success && prop_to_return) {

+        XFree(prop_to_return);

+    }

+    return status == Success && !(actual_type_return == None && actual_format_return == 0);

+}

+

+

+static PyObject *

+Display_get_child_window_ids(DisplayObject *self, PyObject *args, PyObject *kwds) {

+    static char *kwlist[] = {"parent_id", NULL};

+    Window parent = XDefaultRootWindow(self->info_display);

+    Window _, *children;

+    unsigned int children_count;

+

+    if (!PyArg_ParseTupleAndKeywords(

+            args, kwds, "|k", kwlist,

+            &parent)) {

+        Py_RETURN_ERROR;

+    }

+

+    if (!XQueryTree(

+            self->info_display, parent,

+            &_, &_, &children, &children_count)) {

+        raise(OSError, "failed to query child windows of %lu", parent);

+    }

+

+    PyObject *child_ids = PyList_New(0);

+    if (children) {

+        for (unsigned int i = 0; i < children_count; i++) {

+            // assume that windows without essential properties

+            // like the window title aren't shown to the user

+            int is_helper_window = (

+                !has_property(self, children[i], self->wm_class) &&

+                !has_property(self, children[i], self->wm_name) &&

+                !has_property(self, children[i], self->wm_locale_name) &&

+                !has_property(self, children[i], self->wm_normal_hints));

+            if (is_helper_window) {

+                continue;

+            }

+            PyObject *py_window_id = Py_BuildValue("k", children[i]);

+            PyList_Append(child_ids, py_window_id);

+            Py_XDECREF(py_window_id);

+        }

+        XFree(children);

+    }

+

+    return child_ids;

+}

+

+static PyObject *

+Display_get_window_pid(DisplayObject *self, PyObject *args, PyObject *kwds) {

+    static char *kwlist[] = {"window_id", NULL};

+    Window window;

+    long num_ids;

+    int num_specs = 1;

+    XResClientIdValue *client_ids;

+    XResClientIdSpec client_specs[1];