remembering

pt | fr | eo

Add memory to dmenu, fzf and similar tools.

It can wrap such tools to accumulate preferences over time, and re-arrange the input according to common picks.

Usage

Replace:

$ ls | fzf

with:

$ ls | remembering -p fzf-sample -c fzf

and see your previous choices from fzf start to appear at the beginning of the list.

Similar to yeganesh, but with no build-time or run-time dependencies, and not coupled with dmenu.

Installation

$ make
$ make check
# make install

You can pass PREFIX or DESTDIR to make:

$ make
$ make check
$ make install PREFIX=$HOME/.local

There are no dependencies or requirements, only standard tools such as POSIX sed, POSIX make, etc.

Documentation

Manuals

The documentation is available via installed manpages or online: - [remembering.1] (pt, fr, eo); - [remembering.5] (pt, fr, eo).

Directory structure

The directory structure of the repository is: - aux/: personal scripts and helpers I've vendored in to ensure the repository is self contained, feel free to ignore it; - doc/: manpages, with their translated versions; - po/: gettext .po files for the translated languages and hunspell dictionaries for spell checking; - src/: main source code for the project; - tests/: integration tests for the project.

Contributing

Extra tools used for development are: - Valgrind for memory testing; - ShellCheck for validating scripts; - po4a, mdpo and gettext for i18n and l10n support; - makefile2graph and graphviz for generating makefile.svg; - pandoc for generating the documentation HTML and website.

For running the extra development-only checks, run:

$ make dev-check

and for generating the documentation HTML and website, run:

$ make public

Send contributions to the mailing list via git send-email.

Links

• homepage
• source code
• bug tracking
• mailing list
• CI logs
• CHANGELOG

Releases

• v0.3.0 remembering-v0.3.0.tar.gz (sig) - 2022-11-25
• v0.2.1 remembering-v0.2.1.tar.gz (sig) - 2021-02-23
• v0.2.0 remembering-v0.2.0.tar.gz (sig) - 2021-02-21
• v0.1.2 remembering-v0.1.2.tar.gz (sig) - 2021-01-26
• v0.1.1 remembering-v0.1.1.tar.gz (sig) - 2021-01-26
• v0.1.0 remembering-v0.1.0.tar.gz (sig) - 2021-01-26

License

The code is licensed under GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later).