pik

Crates.iopik
lib.rspik
version0.10.0
sourcesrc
created_at2024-08-10 13:27:49.273122
updated_at2024-11-09 13:35:12.096556
descriptionpik - process interactive kill
homepage
repositoryhttps://github.com/jacek-kurlit/pik
max_upload_size
id1332398
size1,482,475
RustyJack (jacek-kurlit)

documentation

README

Pik Pik

Build status GitHub Release

Process Interactive Kill is a command line tool that helps to find and kill process. It works like pkill command but search is interactive.

This tool is still under development

Table of Contents

Features

Pik allows to fuzzy search processes by:

  • Name - No prefix is required, just type process name, for example 'firefox' Example search by name
  • Cmd Path - Prefix search with '/', for example '/firefox' Example search by path
  • Arguments - Prefix search with '-' for example '-foo'. Please note that if you want to use this feature in cli you must add --, for example pik -- -foo Example search by argument
  • Ports - Prefix search with ':' for example ':8080' Example search by port
  • Everywhere - Prefix search with '~' for example '~firefox' Example search everywhere

After selecting process you can kill it with Ctrl + X

Installation

Archives of precompiled binaries for pik are available for Linux and macOS.

On Arch Linux

pacman -S pik

On Fedora

sudo dnf copr enable rusty-jack/pik
sudo dnf install pik

On Tumbleweed

sudo zypper install pik

With dra

dra download --install jacek-kurlit/pik

If you're a Rust programmer, pik can be installed with cargo.

cargo install pik

Alternatively, one can use cargo binstall to install a pik binary directly from GitHub:

cargo binstall pik

Configuration

Application configuration

You may set your preferences in pik.toml file located in ~/.config/pik directory. All options are optional, if skipped default values will be used. Example configuration with default settings can be found at example config

Key maps

Key(s) Action
Esc | Ctrl + C Quit
Ctrl + X Kill process
Ctrl + R Refresh processes list
Ctrl + F Details forward
Ctrl + B Details backward
Tab | Shift + Tab Select next/previous
Arrow Down | Arrow Up Select next/previous
Ctrl + J | Ctrl + K Select next/previous
Ctrl + Arrow Down | Ctrl + Arrow Up Select last/first

Caveats

  • Process name on linux system it is not always exe name also it is limited to 15 chars
  • In linux process may appear on list but you are not allowed to get information about ports it uses. In such situations you need to run pik with root privileges
  • Currently fuzzy search for args is not supported due to weird behavior - some processes pass all arguments as single causing them to always appear on list. Due to this fact args search is done by contains method

Development

Supported Systems

In theory pik is using coross compliant lib that allows to run it on all major platforms. In pratice I'm using linux and development is performed based on this OS. Pik will probably work on MacOs and Windows but that must be tested by community since I don't own computers with these OS'es. If you are able to test it on windows or macos please create issue to let me know.

Setup

Building

git clone https://github.com/jacek-kurlit/pik
cd pik
cargo build --release
./target/release/pik --version
Commit count: 179

cargo fmt