~onemoresuza/aba

An address book for aerc
096aeea0 — Gustavo Coutinho de Souza 1 year, 1 day ago
chore: fix REUSE badge
bf0e89b1 — Gustavo Coutinho de Souza 1 year, 28 days ago
chore: update README
fd3e7499 — Gustavo Coutinho de Souza 1 year, 1 month ago
chore: update README

clone

read-only
https://git.sr.ht/~onemoresuza/aba
read/write
git@git.sr.ht:~onemoresuza/aba

You can also use your local clone with git send-email.

#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 nixpkgs from 23.11 onwards.

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.

  • 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? ;)