Skip to main content

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

Project description

Build_Status ghbadge Coveralls RTD Code_Quality PyPI-Versions MYPY-CHECKED PyPI-Downloads Contributors zenodo_badge OpenHub

Pypi Packaging_status

zulip libera

Description

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

quickstartsvg

Learn more:

  • Take a look at the documentation!

  • Blog post about getting paper’s references with papis explore here.

  • GNU/Linux Switzerland wrote about papis here.

  • The folks at OSTechNix have dedicated us a review, you may also check it out here.

  • A review in Spanish is also available at ubunlog.

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.

  • Import from Zotero and other managers using papis-zotero.

  • Create custom scripts to help you achieve great tasks easily (doc).

  • 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 --format bibtex > mylib.bib

superquickstartsvg2

find help messages in all commands:

papis -h
papis add -h

If you so prefer, you can also browse your papers using the web application

papis serve

webapp-einstein

AND MUCH, MUCH MORE!

Contact

Feel free to use issues, github discussions, our IRC libera channel or our zulip channel.

Authors

See the AUTHORS list for a list of authored commits.

Papis projects maintainers

If you find papis useful and want to maintain one of papis plugins, feel free to contact us. Right now some of papis projects and maintainers are the following

project

maintainer(s)

papis (core)

alejandrogallo teto

papis-rofi

Etn40ff

papis-dmenu

YOU?

papis-vim

YOU?

papis-emacs

alejandrogallo

papis-zotero

YOU?

papis-libgen

YOU?

papis-firefox

wavefrontshaping

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.12.tar.gz (186.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page