Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/papis/papis

Powerful and highly extensible command-line based document and bibliography manager.
https://github.com/papis/papis

arxiv biblatex bibtex citation cli command-line command-line-tool crossref doi jabref libgen library mendeley papers papis publications scholar sci-hub tex zotero

Last synced: 24 days ago
JSON representation

Powerful and highly extensible command-line based document and bibliography manager.

Host: GitHub
URL: https://github.com/papis/papis
Owner: papis
License: gpl-3.0
Created: 2017-02-21T14:52:50.000Z (over 7 years ago)
Default Branch: main
Last Pushed: 2024-04-25T13:57:58.000Z (6 months ago)
Last Synced: 2024-04-25T15:05:56.347Z (6 months ago)
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
Language: HTML
Homepage: http://papis.readthedocs.io/en/latest/
Size: 7.68 MB
Stars: 1,329
Watchers: 25
Forks: 94
Open Issues: 73
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Roadmap: ROADMAP.md
- Authors: AUTHORS

Awesome Lists containing this project

awesome-thesis - Papis - A Python based command line manager (Tools / Writing)
stars - papis/papis - line based document and bibliography manager. (HarmonyOS / Windows Manager)
awesome-cli-apps - papis - Extensible document and bibliography manager. (Productivity / HTTP Client)
awesome-LaTeX - Papis - Extremely customizable, (Bibliography tools / Online editors)
fucking-awesome-cli-apps - papis - Extensible document and bibliography manager. (Productivity / HTTP Client)
awesome-starred - papis/papis - Powerful and highly extensible command-line based document and bibliography manager. (library)

README

.. raw:: html

Papis

Papis is a powerful and highly extensible CLI document and bibliography manager.

|first_glance|

With Papis, you can search your library for books and papers, add documents and
notes, import and export to and from other formats, and much much more. Papis
uses a human-readable and easily hackable ``.yaml`` file to store each entry's
bibliographical data. It strives to be easy to use while providing a wide range
of features. And for those who still want more, Papis makes it easy to write
scripts that extend its features even further.

Features
--------

- **Add documents** and automatically fetch their metadata.
- **Search** by author, title, tags, and so on.
- **Synchronize** your library with whatever software you're already using.
- **Share** your documents with colleagues without having to force some proprietary
service onto them.
- **Import** your data from other bibliography managers.
- **Export** to BibTeX and other formats.
- **Integrate with your editor** with plugins for (Neo)vim and Emacs.
- **TUIs** make it easy to get a quick overview of your library.
- **Use the web app** when the CLI doesn't quite cut it (for example on your tablet).
- **Hacking** Papis is easy! Use the API to easily create your own custom python scripts.

Quick tour
----------

Install Papis with pip (or `one of the alternatives `__):

.. code:: bash

pip install papis

Let's download a couple of documents:

.. code:: bash

wget https://www.gnu.org/s/libc/manual/pdf/libc.pdf
wget https://www.ams.org/notices/201304/rnoti-p434.pdf

We can now add these to the (default) library. This will automatically query for
the metadata associated with the ``doi``.

.. code:: bash

papis add --from doi 10.1090/noti963 rnoti-p434.pdf

|add|

You can also use ``--set`` to add information:

.. code:: bash

papis add libc.pdf --set author "Sandra Loosemore" \
--set title "GNU C reference manual" \
--set year 2018 \
--set tags programming \
--confirm

Now open an attached file or edit an entry:

.. code:: bash

papis open
papis edit

|edit|

Or export them to bibtex:

.. code:: bash

papis export --all --format bibtex > mylib.bib

|bibtex_export|

Papis also includes a web app that you can start with:

.. code:: bash

papis serve

You can then open the indicated address (``http://localhost:8888``) in your
browser.

|web_app|

All ``papis`` commands come with help messages:

.. code:: bash

papis -h # General help
papis add -h # Help with a specific command

Installation & setup
--------------------

Information about installation and setup can be found in the
`docs `__, for example in the these sections:

- `Installation `__
- `Configuration `__
- `Import `__
- `Editor integration `__

Questions?
----------

The `docs `__ cover Papis' features and
discuss possible work flows. If you still have questions, head to our
`GitHub discussions `__ — we're
more than happy to help. If you've found a bug, please
`open an issue `__ and help make Papis
even better!

If you're not finding a command or configuration value that shows up in the
documentation in your local installation, you may just be looking at the wrong
docs. You can find the documentation for the latest *released* version
`here `__ and the documentation for
the *in-development* version `here `__.

Reviews and blog posts
----------------------

- `Blog post `__
about getting a paper's references with ``papis explore``.
- `Blog post `__ about using Papis
with Zotero and Syncthing.
- GNU/Linux Switzerland `wrote about Papis `__
*(in German)*.
- The folks at OSTechNix wrote a review of `Papis
`__.
- A `review of Papis `__
by Ubunlog *(in Spanish)*.

Contributing
------------

Contributions are very welcome! Take a look at
`CONTRIBUTING.md `__ for
general rules and `HACKING.md `__
for additional code-related information. We encourage you to also check out,
contribute to, or even help maintain the other projects in the Papis ecosystem
mentioned below :wink:.

The Papis ecosystem
-------------------

Papis has grown over the years and there are now a number of projects that
extend Papis' features or integrate it with other software.

.. list-table::
:widths: 33 67
:header-rows: 1

* - Project
- Maintained by

* - `papis (core) `__
- `Alejandro Gallo `__, `Julian Hauser `__, `Alex Fikl `__

* - `papis-rofi `__
- `Etn40ff `__

* - `papis-dmenu `__
- you?

* - `papis-vim `__
- you?

* - `papis.nvim `__
- `Julian Hauser `__

* - `papis-emacs `__
- `Alejandro Gallo `__

* - `papis-zotero `__
- `Alex Fikl `__

* - `papis-libgen `__
- you?

* - `papis-firefox `__
- `wavefrontshaping `__
* - `papis-qa `__ (AI for Papis)
- `Isak Samsten `__

Related software
----------------

Papis isn't the only fish in the pond. You might also be interested in:

- `bibman `__ (open source)
- `cobib `__ (open source)
- `jabref `__ (open source)
- `Mendeley `__ (proprietary)
- `pubs `__ (open source)
- `Xapers `__ (open source)
- `Zotero `__ (open source)

Thanks
------

We thank `Irteza Rehman `__ for generously creating
our beautiful logo.