{"id":19246250,"url":"https://github.com/mrossinek/cobib","last_synced_at":"2025-08-21T05:34:32.645Z","repository":{"id":41133040,"uuid":"179937251","full_name":"mrossinek/cobib","owner":"mrossinek","description":"Console Bibliography","archived":false,"fork":false,"pushed_at":"2025-08-16T08:13:11.000Z","size":2801,"stargazers_count":65,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-08-16T10:09:54.992Z","etag":null,"topics":["arxiv","bibliography","bibtex","citation-manager","cli","command-line","console-based","doi","reference-manager","terminal-based"],"latest_commit_sha":null,"homepage":"https://gitlab.com/cobib/cobib","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrossinek.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-04-07T08:26:40.000Z","updated_at":"2025-08-16T08:13:15.000Z","dependencies_parsed_at":"2024-01-18T20:46:10.724Z","dependency_job_id":"1a66467f-deb5-4c2c-bbf6-3303dea84cd5","html_url":"https://github.com/mrossinek/cobib","commit_stats":null,"previous_names":[],"tags_count":62,"template":false,"template_full_name":null,"purl":"pkg:github/mrossinek/cobib","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrossinek%2Fcobib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrossinek%2Fcobib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrossinek%2Fcobib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrossinek%2Fcobib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrossinek","download_url":"https://codeload.github.com/mrossinek/cobib/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrossinek%2Fcobib/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271430895,"owners_count":24758419,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arxiv","bibliography","bibtex","citation-manager","cli","command-line","console-based","doi","reference-manager","terminal-based"],"created_at":"2024-11-09T17:31:10.843Z","updated_at":"2025-08-21T05:34:32.630Z","avatar_url":"https://github.com/mrossinek.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![coBib](https://gitlab.com/cobib/cobib/-/raw/master/docs/logo/cobib_logo.svg)](https://cobib.gitlab.io/cobib/cobib.html)\n\n# coBib\n\n[![pipeline](https://gitlab.com/cobib/cobib/badges/master/pipeline.svg)](https://gitlab.com/cobib/cobib/-/pipelines)\n[![coverage](https://gitlab.com/cobib/cobib/badges/master/coverage.svg)](https://gitlab.com/cobib/cobib/-/graphs/master/charts)\n[![PyPI](https://img.shields.io/pypi/v/cobib)](https://pypi.org/project/cobib/)\n\ncoBib is a simple, console-based bibliography management tool.\nIt is the result of the need for an easy-to-use alternative to full-blown reference managers like Mendeley or Zotero.\nAs such it follows some basic design goals:\n\n* **plain-text database**: which means you get full access and control over the database.\n* **git-integration**: as a benefit of the above, you can keep track of your database through version control.\n* **centralized database, location-independent library**: this means, that coBib *only* manages the\n  database file in a centralized fashion but allows you to spread the actual contents of your\n  library across the entire file system (this is the major different to\n  [papis](https://papis.readthedocs.io/en/latest/library_structure.html)).\n* **command-line and TUI support**: all features are available through the command-line as well as a\n  [textual](https://textual.textualize.io/)-based TUI\n\nHere is an example screenshot of the TUI when listing the entries in your database:\n\n![coBib TUI List](https://gitlab.com/cobib/cobib/-/raw/master/docs/screenshots/cobib_tui_list.svg)\n\nAnd here is an example screenshot for listing search results:\n\n![coBib TUI Search](https://gitlab.com/cobib/cobib/-/raw/master/docs/screenshots/cobib_tui_search.svg)\n\n\n## Installation\n\nFor all common purposes you can install coBib via `pip`:\n\n```\npip install cobib\n```\n\nIf you would also like to install the man-page, you need to download the source\ncode and do the following:\n\n```\ngit clone https://gitlab.com/cobib/cobib\ncd cobib\nmake install_man_pages\n```\n\n### Arch Linux\n\ncoBib is packaged in the AUR.\n* [cobib](https://aur.archlinux.org/packages/cobib/)\n* [cobib-git](https://aur.archlinux.org/packages/cobib-git/)\n\n### Windows\n\ncoBib _might_ work on Windows as is, but it is not being tested so no guarantees are given.\nIf you are using Windows 10 or later and are running into issues, you should be able to install and\nuse coBib's full functionality within the Linux subsystem.\n\n\n## Configuration\n\nYou can overwrite the default configuration by placing a `config.py` file in `~/.config/cobib/`.\nThe easiest way to get started with this file is by copying [`example.py`](https://gitlab.com/cobib/cobib/-/blob/master/src/cobib/config/example.py)\nor by using:\n\n```\ncobib _example_config \u003e ~/.config/cobib/config.py\n```\n\nYou can then modify it to your liking.\n\nYou may also specify a different config file at runtime by using the `-c` or `--config` command line argument or by specifying a custom path in the `COBIB_CONFIG` environment variable.\nYou can also disable loading of _any_ configuration file by setting this environment variable to one of the following values: `\"\", 0, \"f\", \"false\", \"nil\", \"none\"`.\n\nFinally, be sure to take a look at the man page (`man 5 cobib-config`) and/or the online documentation for more information.\n\n\n## Plugins\n\ncoBib supports the implementation of plugins!\nYou can find an example plugin in [this folder](./plugin) or read the docs of\n`cobib_dummy` (when viewing the hosted documentation online).\n\n\n## Documentation\n\ncoBib's documentation is hosted [here](https://cobib.gitlab.io/cobib/cobib.html).\nThat page also contains a **getting started** guide!\n\nIf you would like to generate a local version during development, you need to clone the source code, and install [`pdoc`](https://github.com/mitmproxy/pdoc) in order to generate it:\n\n```\ngit clone https://gitlab.com/cobib/cobib.git\ncd cobib\npip install pdoc\npdoc -d google -e cobib=https://gitlab.com/cobib/cobib/-/blob/master/src/cobib/ -t docs/jinja -o build/html src/cobib plugin/src/cobib_dummy tests\n```\n\nYou can then browse the documentation from `build/html/cobib.html`.\n\n\n## History\n\nI have started this project when I was looking into alternatives to popular reference managers such as Mendeley,\nwhich has more features than I use on a regular basis and does not allow me to work from the command line which is where I spend most of the time that I spend on the computer.\n\nHence, I have decided to make it my own task of implementing a simple, yet fast, reference manager.\ncoBib is written in Python and uses a YAML file to store its bibliography in a plain text format.\n\n### Alternatives\n\nBesides coBib there are many other tools for managing your bibliography.\nBelow is a selection (alphabetical) of open source tools that I am aware of:\n\n- [bibiman](https://codeberg.org/lukeflo/bibiman): CLI, TUI\n- [bibman](https://codeberg.org/KMIJPH/bibman): CLI, TUI\n- [jabref](https://github.com/JabRef/jabref): GUI\n- [papis](https://github.com/papis/papis): CLI, TUI, local web app\n- [pubs](https://github.com/pubs/pubs): CLI\n- [xapers](https://finestructure.net/xapers): CLI, TUI\n- [zotero](https://github.com/zotero/zotero): GUI, remote web app\n\n### Changelog\n\nYou can find the detailed changes throughout coBib's history in [the Changelog](https://gitlab.com/cobib/cobib/-/blob/master/CHANGELOG.md).\n\n\n## License\n\ncoBib is licensed under the [MIT License](https://gitlab.com/cobib/cobib/-/blob/master/LICENSE.txt).\n\n[^1]: References like this one get interpreted by the documentation generator. If you are reading this as the README page, you may find the [online documentation](https://cobib.gitlab.io/cobib/cobib.html) more enjoyable.\n\n[//]: # ( vim: set ft=markdown tw=0: )\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrossinek%2Fcobib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrossinek%2Fcobib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrossinek%2Fcobib/lists"}