{"id":13425350,"url":"https://github.com/papis/papis","last_synced_at":"2026-02-08T20:27:41.693Z","repository":{"id":17777571,"uuid":"82691622","full_name":"papis/papis","owner":"papis","description":"Powerful and highly extensible command-line based document and bibliography manager.","archived":false,"fork":false,"pushed_at":"2025-05-09T11:42:06.000Z","size":8596,"stargazers_count":1502,"open_issues_count":100,"forks_count":105,"subscribers_count":23,"default_branch":"main","last_synced_at":"2025-05-09T12:35:36.597Z","etag":null,"topics":["arxiv","biblatex","bibtex","citation","cli","command-line","command-line-tool","crossref","doi","jabref","libgen","library","mendeley","papers","papis","publications","scholar","sci-hub","tex","zotero"],"latest_commit_sha":null,"homepage":"http://papis.readthedocs.io/en/latest/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/papis.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-02-21T14:52:50.000Z","updated_at":"2025-05-09T11:42:11.000Z","dependencies_parsed_at":"2023-12-19T04:22:44.046Z","dependency_job_id":"4acdc143-5430-4ef0-9079-13683ea873c6","html_url":"https://github.com/papis/papis","commit_stats":{"total_commits":3054,"total_committers":63,"mean_commits":"48.476190476190474","dds":0.2999345121152587,"last_synced_commit":"95e0b5456afef60ee4f54c4aaec624244093c1e0"},"previous_names":[],"tags_count":45,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/papis%2Fpapis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/papis%2Fpapis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/papis%2Fpapis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/papis%2Fpapis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/papis","download_url":"https://codeload.github.com/papis/papis/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254036843,"owners_count":22003654,"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","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","biblatex","bibtex","citation","cli","command-line","command-line-tool","crossref","doi","jabref","libgen","library","mendeley","papers","papis","publications","scholar","sci-hub","tex","zotero"],"created_at":"2024-07-31T00:01:10.642Z","updated_at":"2026-02-08T20:27:41.686Z","avatar_url":"https://github.com/papis.png","language":"HTML","readme":".. raw:: html\n\n   \u003cdiv align=\"center\"\u003e\n\n   \u003cimg src=\"resources/logo.svg\" width=300\u003e\n\n   \u003ch1\u003ePapis\u003c/h1\u003e\n\n   \u003ca href=\"https://github.com/papis/papis/actions?query=branch%3Amain+workflow%3ACI\"\u003e\n       \u003cimg src=\"https://github.com/papis/papis/workflows/CI/badge.svg\" alt=\"GitHub Badge\"\u003e\u003c/a\u003e\n   \u003ca href=\"https://papis.readthedocs.io/en/latest/?badge=latest\"\u003e\n       \u003cimg src=\"https://readthedocs.org/projects/papis/badge/?version=latest\" alt=\"Readthedocs\"\u003e\u003c/a\u003e\n   \u003ca href=\"https://github.com/papis/papis/actions?query=branch%3Amain+workflow%3ACodeQL\"\u003e\n       \u003cimg src=\"https://github.com/papis/papis/workflows/CodeQL/badge.svg\" alt=\"CodeQL\"\u003e\u003c/a\u003e\n   \u003ca href=\"https://pypi.org/project/papis/\"\u003e\n       \u003cimg src=\"https://badge.fury.io/py/papis.svg\" alt=\"PyPI\"\u003e\u003c/a\u003e\n   \u003ca href=\"https://zenodo.org/badge/latestdoi/82691622\"\u003e\n       \u003cimg src=\"https://zenodo.org/badge/82691622.svg\" alt=\"Zenodo\"\u003e\u003c/a\u003e\n\n   \u003cbr\u003e\u003cbr\u003e\n\n   Papis is a powerful and highly extensible CLI document and bibliography manager.\n\n   \u003cbr\u003e\u003cbr\u003e\n\n   \u003c/div\u003e\n\n|first_glance|\n\nWith Papis, you can search your library for books and papers, add documents and\nnotes, import and export to and from other formats, and much much more. Papis\nuses a human-readable and easily hackable ``.yaml`` file to store each entry's\nbibliographical data. It strives to be easy to use while providing a wide range\nof features. And for those who still want more, Papis makes it easy to write\nscripts that extend its features even further.\n\nFeatures\n--------\n\n- **Add documents** and automatically fetch their metadata.\n- **Search** by author, title, tags, and so on.\n- **Synchronize** your library with whatever software you're already using.\n- **Share** your documents with colleagues without having to force some proprietary\n  service onto them.\n- **Import** your data from other bibliography managers.\n- **Export** to BibTeX and other formats.\n- **Integrate with your editor** with plugins for (Neo)vim and Emacs.\n- **TUIs** make it easy to get a quick overview of your library.\n- **Use the web app** when the CLI doesn't quite cut it (for example on your tablet).\n- **Hacking** Papis is easy! Use the API to easily create your own custom Python\n  scripts.\n\nQuick tour\n----------\n\nInstall Papis with pip (or `one of the alternatives\n\u003chttps://papis.readthedocs.io/en/latest/install.html\u003e`__):\n\n.. code:: bash\n\n    pip install papis\n\nLet's download a couple of documents:\n\n.. code:: bash\n\n    wget https://www.gnu.org/s/libc/manual/pdf/libc.pdf\n    wget https://www.ams.org/notices/201304/rnoti-p434.pdf\n\nWe can now add these to the (default) library. This will automatically query for\nthe metadata associated with the ``doi``.\n\n.. code:: bash\n\n    papis add --from doi 10.1090/noti963 rnoti-p434.pdf\n\n|add|\n\nYou can also use ``--set`` to add information:\n\n.. code:: bash\n\n    papis add libc.pdf --set author \"Sandra Loosemore\" \\\n                       --set title \"GNU C reference manual\" \\\n                       --set year 2018 \\\n                       --set tags programming \\\n                       --confirm\n\nNow open an attached file or edit an entry:\n\n.. code:: bash\n\n    papis open\n    papis edit\n\n\n|edit|\n\nThe Papis picker (set using the ``picktool`` configuration option) has\nhelpful shortcuts to call other functionality as well (press ``F1`` for\na complete list). It can be used to open (``Ctrl-o``), browse (``Ctrl-b``)\nor edit (``Ctrl-e``) selected documents (marked with ``Ctrl-t``).\n\nImport your bibliography into Papis from BibTeX:\n\n.. code:: bash\n\n    papis bibtex read mylib.bib import --all\n\nOr export it to BibTeX:\n\n.. code:: bash\n\n    papis export --all --format bibtex \u003e mylib.bib\n\n|bibtex_export|\n\nPapis also includes a web app that you can start with:\n\n.. code:: bash\n\n    papis serve\n\nYou can then open the indicated address (``http://localhost:8888``) in your\nbrowser.\n\n|web_app|\n\nAll ``papis`` commands come with help messages:\n\n.. code:: bash\n\n    papis -h      # General help\n    papis add -h  # Help with a specific command\n\nInstallation \u0026 setup\n--------------------\n\nInformation about installation and setup can be found in the\n`docs \u003chttps://papis.readthedocs.io/en/latest/\u003e`__, for example in the these sections:\n\n- `Installation \u003chttps://papis.readthedocs.io/en/latest/install.html\u003e`__\n- `Configuration \u003chttps://papis.readthedocs.io/en/latest/configuration.html\u003e`__\n- `Import \u003chttps://papis.readthedocs.io/en/latest/importing.html\u003e`__\n- `Editor integration \u003chttps://papis.readthedocs.io/en/latest/editors.html\u003e`__\n\nQuestions?\n----------\n\nThe `docs \u003chttps://papis.readthedocs.io/en/latest/\u003e`__ cover Papis' features and\ndiscuss possible work flows. If you still have questions, head to our\n`GitHub discussions \u003chttps://github.com/papis/papis/discussions\u003e`__ — we're\nmore than happy to help. If you've found a bug, please\n`open an issue \u003chttps://github.com/papis/papis/issues\u003e`__ and help make Papis\neven better!\n\nIf you're not finding a command or configuration value that shows up in the\ndocumentation in your local installation, you may just be looking at the wrong\ndocs. You can find the documentation for the latest *released* version\n`here \u003chttps://papis.readthedocs.io/en/stable/\u003e`__ and the documentation for\nthe *in-development* version `here \u003chttps://papis.readthedocs.io/en/latest/\u003e`__.\n\nReviews and blog posts\n----------------------\n\n- `Blog post\n  \u003chttps://alejandrogallo.github.io/blog/posts/getting-paper-references-with-papis/\u003e`__\n  about getting a paper's references with ``papis explore``.\n- `Blog post\n  \u003chttps://web.archive.org/web/20250428103318/https://nicolasshu.com/zotero_and_papis.html\u003e`__\n  about using Papis with Zotero and Syncthing.\n- GNU/Linux Switzerland `wrote about Papis\n  \u003chttps://gnulinux.ch/papis-dokumentenverwaltung-fuer-die-kommandozeile\u003e`__\n  *(in German)*.\n- The folks at OSTechNix wrote a review of `Papis\n  \u003chttps://www.ostechnix.com/papis-command-line-based-document-bibliography-manager\u003e`__.\n- A `review of Papis \u003chttps://ubunlog.com/papis-administrador-documentos/\u003e`__\n  by Ubunlog *(in Spanish)*.\n\nContributing\n------------\n\nContributions are very welcome! Take a look at\n`CONTRIBUTING.md \u003chttps://github.com/papis/papis/blob/main/CONTRIBUTING.md\u003e`__ for\ngeneral rules and `HACKING.md \u003chttps://github.com/papis/papis/blob/main/HACKING.md\u003e`__\nfor additional code-related information. We encourage you to also check out,\ncontribute to, or even help maintain the other projects in the Papis ecosystem\nmentioned below 😉.\n\nThe Papis ecosystem\n-------------------\n\nPapis has grown over the years and there are now a number of projects that\nextend Papis' features or integrate it with other software.\n\n.. list-table::\n   :widths: 33 67\n   :header-rows: 1\n\n   * - Project\n     - Maintained by\n\n   * - `papis (core) \u003chttps://github.com/papis/papis-rofi/\u003e`__\n     - `Alejandro Gallo \u003chttps://alejandrogallo.github.io/\u003e`__,\n       `Julian Hauser \u003chttps://github.com/jghauser\u003e`__,\n       `Alex Fikl \u003chttps://github.com/alexfikl\u003e`__\n\n   * - `papis-rofi \u003chttps://github.com/papis/papis-rofi/\u003e`__\n     - `Etn40ff \u003chttps://github.com/Etn40ff\u003e`__\n\n   * - `papis-dmenu \u003chttps://github.com/papis/papis-dmenu\u003e`__\n     - you?\n\n   * - `papis-vim \u003chttps://github.com/papis/papis-vim\u003e`__\n     - you?\n\n   * - `papis.nvim \u003chttps://github.com/jghauser/papis.nvim\u003e`__\n     - `Julian Hauser \u003chttps://github.com/jghauser\u003e`__\n\n   * - `papis-emacs \u003chttps://github.com/papis/papis.el\u003e`__\n     - `Alejandro Gallo \u003chttps://alejandrogallo.github.io/\u003e`__,\n       `Jean-Alexandre Barszcz \u003chttps://jabarsz.cz/en/home\u003e`__\n\n   * - `papis-zotero \u003chttps://github.com/papis/papis-zotero\u003e`__\n     - `Alex Fikl \u003chttps://github.com/alexfikl\u003e`__\n\n   * - `papis-libgen \u003chttps://github.com/papis/papis-zotero\u003e`__\n     - you?\n\n   * - `papis-firefox \u003chttps://github.com/papis/papis-firefox\u003e`__\n     - `wavefrontshaping \u003chttps://github.com/wavefrontshaping\u003e`__\n   * - `papis-ask \u003chttps://github.com/jghauser/papis-ask\u003e`__ (AI for Papis)\n     - `Julian Hauser \u003chttps://github.com/jghauser\u003e`__\n\nRelated software\n----------------\n\nPapis isn't the only fish in the pond. You might also be interested in:\n\n- `bibman \u003chttps://codeberg.org/KMIJPH/bibman\u003e`__ (open source)\n- `bibiman \u003chttps://codeberg.org/lukeflo/bibiman\u003e`__ (open source)\n- `cobib \u003chttps://github.com/mrossinek/cobib\u003e`__ (open source)\n- `jabref \u003chttps://www.jabref.org/\u003e`__ (open source)\n- `Mendeley \u003chttps://www.mendeley.com/\u003e`__ (proprietary)\n- `pubs \u003chttps://github.com/pubs/pubs/\u003e`__ (open source)\n- `Xapers \u003chttps://finestructure.net/xapers/\u003e`__ (open source)\n- `Zotero \u003chttps://www.zotero.org/\u003e`__ (open source)\n\n\nThanks\n------\n\nWe thank `Irteza Rehman \u003chttps://www.irtezarehman.com/\u003e`__ for generously creating\nour beautiful logo.\n\n.. |ghbadge| image:: https://github.com/papis/papis/workflows/CI/badge.svg\n   :target: https://github.com/papis/papis/actions?query=branch%3Amain+workflow%3ACI\n.. |RTD| image:: https://readthedocs.org/projects/papis/badge/?version=latest\n   :target: http://papis.readthedocs.io/en/latest/?badge=latest\n.. |CodeQL| image:: https://github.com/papis/papis/workflows/CodeQL/badge.svg\n   :target: https://github.com/papis/papis/actions?query=branch%3Amain+workflow%3ACodeQL\n.. |Pypi| image:: https://badge.fury.io/py/papis.svg\n   :target: https://pypi.org/project/papis/\n.. |zenodo_badge| image:: https://zenodo.org/badge/82691622.svg\n   :target: https://zenodo.org/badge/latestdoi/82691622\n\n.. |first_glance| image:: https://papis.github.io/images/first_glance.gif\n.. |edit| image:: https://papis.github.io/images/edit.gif\n.. |bibtex_export| image:: https://papis.github.io/images/bibtex_export.gif\n.. |add| image:: https://papis.github.io/images/add.gif\n.. |web_app| image:: https://papis.github.io/images/web_app.jpg\n","funding_links":[],"categories":["HTML","HarmonyOS","Utilities","cli","📝 Knowledge \u0026 Note (笔记与知识管理)","Tools","Bibliography tools"],"sub_categories":["Windows Manager","Academia","Writing","Online editors"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpapis%2Fpapis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpapis%2Fpapis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpapis%2Fpapis/lists"}