Skip to content

wavefrontshaping/papis

 
 

Papis

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

Pypi Packaging_status

zulip

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

AND MUCH, MUCH MORE!

Authors

See the AUTHORS list for a list of authored commits.

Here is a list of similar software:

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-zotero YOU?
papis-libgen YOU?
papis-firefox wavefrontshaping

About

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

Resources

License

GPL-3.0, Unknown licenses found

Licenses found

GPL-3.0
LICENSE
Unknown
LICENSE.txt

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HTML 84.0%
  • Python 15.5%
  • Other 0.5%