khard


Namekhard JSON
Version 0.19.1 PyPI version JSON
download
home_page
SummaryA console address book manager
upload_time2023-11-26 17:41:08
maintainer
docs_urlNone
author
requires_python>=3.8
licenseGPL
keywords vcard console addressbook
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            khard
=====

Khard is an address book for the Unix console. It creates, reads, modifies and
removes vCard address book entries at your local machine. Khard is also
compatible to the email clients mutt and alot and the SIP client twinkle. You
can find more information about khard and the whole synchronization process
[here][blog].

Warning: If you want to create or modify contacts with khard, beware that the
vCard standard is very inconsistent and lacks interoperability. Different
actors in that sector have defined their own extensions and even produce
non-standard output. A good example is the type value, which is tied to phone
numbers, email and post addresses. Khard tries to avoid such incompatibilities
but if you sync your contacts with an Android or iOS device, expect problems.
You are on the safe side, if you only use khard to read contacts. For further
information about the vCard compatibility issues have a look into [this blog
post][sad].

Installation
------------

[![Packaging status][repos-badge]][repos]

Khard is already packaged for quite some distributions.  Chances are you can
install it with your default package manager.  Releases are also published on
[PyPi](https://pypi.org/project/khard/) and can be installed with `pip`.
Further instructions can be found in the
[documentation](https://khard.readthedocs.io/en/latest/#installation).

Usage
-----

[![Documentation Status][docs-badge]][docs]

There is an [example config file](doc/source/examples/khard.conf.example) which
you can copy to the default config file location: `~/.config/khard/khard.conf`.
`khard` has several subcommands which are all documented by their `--help`
option. [The docs][docs] also have a chapter on [command line
usage](https://khard.readthedocs.io/en/latest/commandline.html) and
[configuration](https://khard.readthedocs.io/en/latest/#configuration).

In order to build the documentation locally you need
[Sphinx](https://www.sphinx-doc.org/).  It can be build from the Makefile in
the `doc` directory.

Development
-----------

[![ci-badge]][ci]

Khard is developed [on GitHub](https://github.com/lucc/khard) where you
are welcome to post [bug reports](https://github.com/lucc/khard/issues)
and [feature requests](https://github.com/lucc/khard/pulls).  Also see the
[notes for contributors](CONTRIBUTING.rst).

Authors
-------

Khard was started by [Eric Scheibler](http://eric-scheibler.de) and is
currently maintained by @lucc.  [Several
people](https://github.com/lucc/khard/graphs/contributors) have
contributed over the years.

Related projects
----------------

If you need a console based calendar too, try out
[khal](https://github.com/pimutils/khal).

  [blog]: http://eric-scheibler.de/en/blog/2014/10/Sync-calendars-and-address-books-between-Linux-and-Android/
  [sad]: http://alessandrorossini.org/2012/11/15/the-sad-story-of-the-vcard-format-and-its-lack-of-interoperability/
  [repos]: https://repology.org/project/khard/versions
  [repos-badge]: https://repology.org/badge/tiny-repos/khard.svg
  [docs]: https://khard.readthedocs.io/en/latest/
  [docs-badge]: https://readthedocs.org/projects/khard/badge/?version=latest
  [ci]: https://github.com/lucc/khard/actions/workflows/ci.yml
  [ci-badge]: https://github.com/lucc/khard/actions/workflows/ci.yml/badge.svg

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "khard",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "vcard,console,addressbook",
    "author": "",
    "author_email": "Eric Scheibler <email@eric-scheibler.de>",
    "download_url": "https://files.pythonhosted.org/packages/0d/00/215a69d2ae96cac511a6594116958bf13e210dd24f78c48f5ffaf039edec/khard-0.19.1.tar.gz",
    "platform": null,
    "description": "khard\n=====\n\nKhard is an address book for the Unix console. It creates, reads, modifies and\nremoves vCard address book entries at your local machine. Khard is also\ncompatible to the email clients mutt and alot and the SIP client twinkle. You\ncan find more information about khard and the whole synchronization process\n[here][blog].\n\nWarning: If you want to create or modify contacts with khard, beware that the\nvCard standard is very inconsistent and lacks interoperability. Different\nactors in that sector have defined their own extensions and even produce\nnon-standard output. A good example is the type value, which is tied to phone\nnumbers, email and post addresses. Khard tries to avoid such incompatibilities\nbut if you sync your contacts with an Android or iOS device, expect problems.\nYou are on the safe side, if you only use khard to read contacts. For further\ninformation about the vCard compatibility issues have a look into [this blog\npost][sad].\n\nInstallation\n------------\n\n[![Packaging status][repos-badge]][repos]\n\nKhard is already packaged for quite some distributions.  Chances are you can\ninstall it with your default package manager.  Releases are also published on\n[PyPi](https://pypi.org/project/khard/) and can be installed with `pip`.\nFurther instructions can be found in the\n[documentation](https://khard.readthedocs.io/en/latest/#installation).\n\nUsage\n-----\n\n[![Documentation Status][docs-badge]][docs]\n\nThere is an [example config file](doc/source/examples/khard.conf.example) which\nyou can copy to the default config file location: `~/.config/khard/khard.conf`.\n`khard` has several subcommands which are all documented by their `--help`\noption. [The docs][docs] also have a chapter on [command line\nusage](https://khard.readthedocs.io/en/latest/commandline.html) and\n[configuration](https://khard.readthedocs.io/en/latest/#configuration).\n\nIn order to build the documentation locally you need\n[Sphinx](https://www.sphinx-doc.org/).  It can be build from the Makefile in\nthe `doc` directory.\n\nDevelopment\n-----------\n\n[![ci-badge]][ci]\n\nKhard is developed [on GitHub](https://github.com/lucc/khard) where you\nare welcome to post [bug reports](https://github.com/lucc/khard/issues)\nand [feature requests](https://github.com/lucc/khard/pulls).  Also see the\n[notes for contributors](CONTRIBUTING.rst).\n\nAuthors\n-------\n\nKhard was started by [Eric Scheibler](http://eric-scheibler.de) and is\ncurrently maintained by @lucc.  [Several\npeople](https://github.com/lucc/khard/graphs/contributors) have\ncontributed over the years.\n\nRelated projects\n----------------\n\nIf you need a console based calendar too, try out\n[khal](https://github.com/pimutils/khal).\n\n  [blog]: http://eric-scheibler.de/en/blog/2014/10/Sync-calendars-and-address-books-between-Linux-and-Android/\n  [sad]: http://alessandrorossini.org/2012/11/15/the-sad-story-of-the-vcard-format-and-its-lack-of-interoperability/\n  [repos]: https://repology.org/project/khard/versions\n  [repos-badge]: https://repology.org/badge/tiny-repos/khard.svg\n  [docs]: https://khard.readthedocs.io/en/latest/\n  [docs-badge]: https://readthedocs.org/projects/khard/badge/?version=latest\n  [ci]: https://github.com/lucc/khard/actions/workflows/ci.yml\n  [ci-badge]: https://github.com/lucc/khard/actions/workflows/ci.yml/badge.svg\n",
    "bugtrack_url": null,
    "license": "GPL",
    "summary": "A console address book manager",
    "version": "0.19.1",
    "project_urls": {
        "changelog": "https://github.com/lucc/khard/blob/develop/CHANGES",
        "documentation": "https://khard.readthedocs.io/en/latest/",
        "homepage": "https://github.com/lucc/khard",
        "repository": "https://github.com/lucc/khard.git"
    },
    "split_keywords": [
        "vcard",
        "console",
        "addressbook"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ea39a5f3f498b79af5f7b0f13ac01d58f53759c7d5d36410966628d44ca32fed",
                "md5": "9ee95f16634106f392fa27fcc5d168ac",
                "sha256": "376b9f2dc4642d309b3aabd8ce1a1a586106bc3d5dfc5de336a927ccf46971b3"
            },
            "downloads": -1,
            "filename": "khard-0.19.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9ee95f16634106f392fa27fcc5d168ac",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 66542,
            "upload_time": "2023-11-26T17:40:42",
            "upload_time_iso_8601": "2023-11-26T17:40:42.378556Z",
            "url": "https://files.pythonhosted.org/packages/ea/39/a5f3f498b79af5f7b0f13ac01d58f53759c7d5d36410966628d44ca32fed/khard-0.19.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0d00215a69d2ae96cac511a6594116958bf13e210dd24f78c48f5ffaf039edec",
                "md5": "2659cd0e0038ab1d81c50ea51b3d4951",
                "sha256": "59f30a0da3c3da3eb04f4dbe18ee4763913b685d99ec8418fd574a88c491c490"
            },
            "downloads": -1,
            "filename": "khard-0.19.1.tar.gz",
            "has_sig": false,
            "md5_digest": "2659cd0e0038ab1d81c50ea51b3d4951",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 605230,
            "upload_time": "2023-11-26T17:41:08",
            "upload_time_iso_8601": "2023-11-26T17:41:08.718156Z",
            "url": "https://files.pythonhosted.org/packages/0d/00/215a69d2ae96cac511a6594116958bf13e210dd24f78c48f5ffaf039edec/khard-0.19.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-11-26 17:41:08",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "lucc",
    "github_project": "khard",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "khard"
}
        
Elapsed time: 0.14327s