Pikeru: The File Picker with Good Thumbnails

Pikeru is a filepicker for linux that has working thumbnails and works on any desktop environment or window manager. Kind of like kdialog but better and with some added features.

Special features other filepickers don't have

Right click an image to view it. Scroll the image to view the next and previous images.
Select multiple directories with ctrl, shift, middle-click, or right-click. Click Open to view the contents of all selected directories at the same time.
Putting postprocess.sh in this directory enables post-processing, such as automatically converting images before uploading them. Use the example script with cp postprocess.example.sh postprocess.sh.
Cmd menu shows commands specified in ~/.config/pikeru.conf. Click one to run it on the selected files.

Installation and Usage

First install the dependencies at the bottom of the readme

Install the filepicker

Run ./pikeru. That will create the venv and config file the first time and launch the filepicker.
If using a high-dpi display, edit dpi_scale in ~/.config/pikeru.conf.

Make applications use it

Run ./install.sh to install the xdg portal for pikeru.
install.sh creates a symlink to this repo so if you want it to work for other users, put this repo in /opt first. Other users can run pikeru -x to set their configuration to use it.
To make firefox use the portal, set environment variable GTK_USE_PORTAL=1, and in about:config, set widget.use-xdg-desktop-portal.file-picker to 1.
The xdg portal should work for both Firefox and Chromium based browsers.
If your chromium-based browser is not using xdg portal, you can still use pikeru by setting environment variable XDG_CURRENT_DESKTOP=KDE and symlinking the kdialog script in your path. That will trick the browser into thinking it's using the KDE dialog, assuming the real kdialog is not placed before this one in your path.

Install Dependencies

Ubuntu:

sudo apt install build-essential libsystemd-dev meson ninja-build scdoc python3-tk python3-venv libinih-dev cmake pkg-config

Arch:

sudo pacman -S base-devel meson ninja scdoc libsystemd tk libinih xdg-desktop-portal

License

Pikeru is Public Domain.

ah06/pikeru