WIP !
contact-manager (cm for short), is a fast, minimalist, powerfull and correct command line interface contact manager written in rust.
It also expose his own high-level library for other crates to use.
cm is used to manage contacts manually or automaticly with address books. It can be integrated with softwares who need access to contacts, using the library or with the immediate mode binary.
cm is still in devellopement, but is actually useable. You can check the ROADMAP to see the direction I intend to take for this sotfware and the TODO for more shortly features.
- fast, power and correct contact-manager
An inconveniance could be that if you try to use this programm with already existing vcards contact not following the spec, the programm could crash.
If that's the case, the programm will tell you exacltly which vcard is wrong and why.
Use the import function to be sure everything is valid.
- prevent bad input from user.
- optional pretty output
- no input after execution, so very easy to alias or integrate to scripts.
- use a default book in case no books are specified.
- args to use easly the public functions of the library.
- shell autocompletion generation
- import from file/directory
- export to file
- create/delete contact
- create/delete/rename address book.
- create/search/delete any property to vcard with any property with any logical operator
- generate index for other sotfware (such as an email client).
- filter by book
- forgiveable search
- contacts in books as links to save space and trouble.
- menu for managing contacts and books.
- presentation of a contacts.
- interface for managing contacts and books (low priority).
You can use this software in multiple ways:
- Alias to make quick commands.
- Interactive interface, with menus.
- Immediate Mode, to get all the powerfull options for one time use (if often used, consider making an alias making your life easier).
- Integrate in sotfware using the included library.
- Integrate in scripts calling the Immediate Mode binary directly.
- Generate an index for uses in other sotwares.
cm --help
To get all available commands for immediate and interactive mode.
If using the binary in a script, do not use --pretty, as it can have unstable ouput depending on the number of results.
Instead, assume the first line for find-value result is always the uid, followed by the full string of a property. If multiples contacts have been found to have properties matched, a empty line seperate thoses.
cm is using vcard_parse to make all the parsing and saving of the vcard v4 format file. It manages the contacts in adressbooks with links to never have a contact file more than once on your storage device. So you have the main folder with all your contacts and one folder per addressbook which contains a link for every contacts in this book.
cm will not let you input invalid data (will refuse for use of immediate mode or library, but guide the user in interactive mode).
All the saved contacts are in vcard format, which would enable you to use this programm whih a cardav syncroniser. (see vdirsyncer-rs for a work on that topic in rust).
RFC6350 vCard Format Specification thanks for vcard_parser.
XDG Base Directory Specification Thanks to xdg
cm aims and is fast with immediate response from a human perspective. The first reason I began to write this software was because khard was bloated, slow and buggy.
This programm does not use any encryption. It does consider that you use it on a environnement controlled by you and not accessible by untrusted parties.
This programm does not communicate whatsoever to anyone.
This programm is GPLv3.
Only looking to crates published on crates.io
None of the alternatives have a stable version.
mates-rs: is dedicated to contact and their emails for integration for mutt. It does not enable to manage other fields except the tel number. It does not validate the entries.
vcard_tui: a tui for modifing a contact, the concept could be used for this programm.