kiss-find

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

Building

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

Adding a repository

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.

Removing a repository

If you would not like your repository indexed, it should be added to the filter file.

Credits

Created by @admicos, rewritten by @jedahan, simplified by aabacchus.