3 releases (breaking)

0.3.0 May 21, 2024
0.2.1 Nov 8, 2023
0.0.1 Nov 8, 2023

#1721 in Command line utilities

28 downloads per month

GPL-3.0 license

85KB
2K SLoC

  • trivia on the command line

What is pooi?

(pooi is a fork of oi that is written by PureArtistry David Sherriff I've forked it because it is unmaintained and replaced all the contact details to mine in all the places to ensure active development continues. ) pooi project is a an attempt to keep the cli user more attatched to cli environment even when there is a need to perform an arbitary web search. The goal is to make pooi feature rich enough so that the user can perform as many web search functions and get the reslts in the commandline itself instead of opening up a fully featured web browser.

use pooi --help for full usage information

Installation

On Arch Linux

Pooi is available in the AUR you can use an AUR Helper such as paru or yay'

paru -S pooi

or

yay -S pooi

All the other Linux distros/ macOS can install cargo

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh (or use your distro's package manager)

and then run

cargo install pooi

this is only required for building the binary, if you have no more use for cargo you can remove it afterwards

build instructions:

clone repo

cd into repo root

Linux

an install script has been provided, just run ./install.sh

macOS

run cargo build --release

then sudo cp ./target/release/pooi /usr/local/bin

a zsh completion script is located at the following path ./etc/completions/_oi but I currently have no idea where to put it (sorry!)

Windows

run cargo build --release

then make a new folder in a location of your choosing

copy .\target\release\pooi.exe [letter]:\path\to\your\folder

following this guide you can add your new folder to you environment PATH

a PowerShell completion script is located at the following path .\etc\completions\_pooi.ps1 but I currently have no idea where to put it (sorry!)

Pre-Compiled version for Linux is available in the Release section. You may download that and run it using ./pooi or move it to your $PATH

Usage

TODO:

  • shell completion scripts
  • add a proper release with binaries
  • license?
  • improve docs
  • user customisable colours (using an environment variable)
  • general code improvements (and probable bug fixes)

TO-DO List @tellmeY18

  • package it for cargo
  • package for debian
  • add to AUR
  • package for Arch mebbe ?

Dependencies

~15–26MB
~468K SLoC