A tool for indexing and searching kiss packages from repositories across the internet.
Example usage:
$ kiss find amf
amfora 1.7.2 2 https://github.com/jedahan/kiss-repo amfora a fancy terminal browser for the gemini protocol
amfora 1.8.0 1 https://github.com/aabacchus/kiss-repo amfora a fancy terminal browser for the gemini protocol
bamf 0.5.4 1 https://github.com/eudaldgr/elementaKISS extra/bamf
tinyramfs git 1 https://github.com/mmatongo/dm kernel/tinyramfs
Updating the database using the script:
$ kiss find -u
You don't have to build the database yourself; it is generated and uploaded to https://aabacchus.github.io/kiss-find/db.csv by a GitHub Action. The standalone script is packaged in the community repository and uses that database. You can build it yourself if you want to, though.
To build the database, run
make
This uses git to clone the repositories, and optionally discovers github repos using the gh
tool with jq
.
To install just the script, run
make install-cli
optionally choosing a particular PREFIX
or DESTDIR
. You can then download the generated database by running
kiss-find -u
If your repository is on github or codeberg, just add the kiss-repo
topic and it should be automatically picked up.
If your repository is anywhere else, open a pull request or issue for it to be added to the include
file.
If you would not like your repository indexed, it should be added to the filter
file.
Created by @admicos, rewritten by @jedahan, simplified by aabacchus.