Skip to main content

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

Project description

Papis |Build_Status| |Coveralls| |RTD| |Pypi| |Code_Quality| |zenodo_badge|
=====

|Packaging_status|

Description
-----------

Papis is a powerful and highly extensible command-line based document
and bibliography manager.

|quickstartsvg|

Learn more:

- Take a look at the `documentation <http://papis.readthedocs.io/en/latest/>`__!
- The folks at `OSTechNix <https://www.ostechnix.com/>`__ have dedicated us a
review, you may also check it out `here
<https://www.ostechnix.com/papis-command-line-based-document-bibliography-manager/>`__.
- A review in Spanish is also available at `ubunlog
<https://ubunlog.com/papis-administrador-documentos/>`__.

Main features
-------------

- Synchronizing of documents: put your documents in some folder and
synchronize it using the tools you love: git, dropbox, rsync,
OwnCloud, Google Drive ... whatever.
- Share libraries with colleagues without forcing them to open an
account, nowhere, never.
- Download directly paper information from *DOI* number via *Crossref*.
- (optional) **scihub** support, use the example papis script
``examples/scripts/papis-scihub`` to download papers from scihub and
add them to your library with all the relevant information, in a
matter of seconds, also you can check the documentation
`here <http://papis.readthedocs.io/en/latest/scihub.html>`__.
- Import from Zotero and other managers using the script in
``examples/scripts/papis-zotero``
(`doc <http://papis.readthedocs.io/en/latest/importing.html>`__).
- Create custom scripts to help you achieve great tasks easily
(`doc <http://papis.readthedocs.io/en/latest/scripting.html>`__).
- Export documents into many formats (bibtex, yaml..)
- Command-line granularity, all the power of a library at the tip of
your fingers.

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

Contributions are very welcome! Take a look at the files
``CONTRIBUTING.md`` for general rules, ``ROADMAP.md`` for possible
contribution topics and ``HACKING.md`` for additional code-related
information.

Super quick start
-----------------

Install papis with pip3

::

sudo pip3 install papis

Let us download a couple of documents

::

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

Now add them to the (defaultly created) library, you can set
any keyword you like already when adding documents, for instance
you can set the year `--set year 2018` or tags for organizing
`--set tags programming`,

::

papis add libc.pdf --set author "Sandra Loosemore" --set title "GNU C reference manual" --set year 2018 --set tags programming --confirm
# Get paper information automatically via de DOI
papis add --from-doi 10.1090/noti963 --set tags programming rnoti-p434.pdf

Now open one for example, or edit them

::

papis open
papis edit

|superquickstartsvg1| Or edit them and export them to bibtex

::

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

|superquickstartsvg2|

find help messages in all commands:

::

papis -h
papis add -h

|asciicast_help| AND MUCH, MUCH MORE!

Authors
-------

See the ``AUTHORS`` list for a list of authored commits.

.. |zenodo_badge| image:: https://zenodo.org/badge/82691622.svg
:target: https://zenodo.org/badge/latestdoi/82691622
.. |superquickstartsvg1| image:: https://papis.github.io/images/superquickstart1.svg
.. |superquickstartsvg2| image:: https://papis.github.io/images/superquickstart2.svg
.. |quickstartsvg| image:: https://papis.github.io/images/quick.svg
.. |Pypi| image:: https://badge.fury.io/py/papis.svg
:target: https://badge.fury.io/py/papis
.. |RTD| image:: https://readthedocs.org/projects/papis/badge/?version=latest
:target: http://papis.readthedocs.io/en/latest/?badge=latest
.. |Coveralls| image:: https://coveralls.io/repos/github/papis/papis/badge.svg?branch=master
:target: https://coveralls.io/github/papis/papis?branch=master
.. |Build_Status| image:: https://travis-ci.org/papis/papis.svg?branch=master
:target: https://travis-ci.org/papis/papis
.. |Packaging_status| image:: https://repology.org/badge/vertical-allrepos/papis.svg
:target: https://repology.org/metapackage/papis
.. |asciicast_help| image:: https://asciinema.org/a/3otatlbqXIsI102uAywMhT4fP.png
:target: https://asciinema.org/a/3otatlbqXIsI102uAywMhT4fP
.. |Code_Quality| image:: https://img.shields.io/lgtm/grade/python/g/papis/papis.svg?logo=lgtm&logoWidth=18
:target: https://lgtm.com/projects/g/papis/papis/context:python

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

papis-0.7.4.tar.gz (123.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page