5 unstable releases

0.8.0 Nov 27, 2023
0.7.2 Nov 6, 2023
0.7.1 Nov 3, 2023
0.7.0 Oct 25, 2023
0.6.2 Oct 25, 2023

#300 in Command line utilities

23 downloads per month

ISC license

25KB
262 lines

aba

built with nix

REUSE status Static Badge

Dynamic TOML Badge builds.sr.ht status

Crates.io Crates.io dependency status

Address Book for Aerc

Contributing

This project has a mailing list and a tracker, which is for confirmed bugs and feature requests.

Changelog

The changelog may be found here.

Installing

Packaging status

Nix

aba is packaged on the unstable channel.

nix-env -iA nixos.aba # or nixpkgs.aba if on a non NixOS system

crates.io

aba is published on crates.io.

cargo install aba

Pre-built Binary

Beginning on 0.4.0, aba provides a pre-built binary for x86_64-linux and a checksum for it. They can be download here.

Manual Install from Manual Build

Follow the build instructions, then run:

sudo just install

To not install at the default location, /usr/local, just set the PREFIX variable:

just PREFIX="${HOME}/.local" install # now there's no need for root

Building

Nix

Run:

nix build .

Manual Build

Install the following dependencies:

  1. just;
  2. scdoc; and
  3. Rust.

Then run:

just

Packaging

Binary-based Distros

Pre-built binaries are available at every new tag.

Source-based Distros

To build aba from source be sure to have the following dependencies available:

  1. just
  2. Rust

Manpages

To compile the manpages, scdoc is needed. A just recipe is available for both compiling (doc) and Installing and compiling (install-doc).

aerc integration

Address Completion

Add the following to your aerc.conf:

address-book-cmd=aba ls "%s"

Parsing Addresses from an Email

Add the following to your binds.conf:

[view]
aa = :pipe -m aba parse --all<Enter>

The option --all may be changed depending on what one wants, that is, to --from, --cc or --to.

Related Projects

  • aercbook, by renerocksai: a more minimalistic address book for aerc written in Zig whose functionality aba is blatantly based upon.

  • aerc, by sircmpwn, maintained by rjarry: aba is an address book for it, isn't? ;)

Dependencies

~9–21MB
~295K SLoC