Skip to main content

CLI organize PDFs by attaching bibtex metadata

Project description


Maper (may-per, like paper with an 'm', as in meta-paper) is a minimal, easy to use, command line tool to download/manage scientific papers in pdf-format by attaching a bibtex-file and updating its metadata using pikepdf.


Install from PyPI:

$ pip install maper

Additionally, pandoc needs to be installed and available.


Use either python -m maper <command> or if PATH is set correctly, maper <command>.

Currently available commands are:

  • create
  • show
  • bibtex


Create a PDF file with an attached bibtex file and metadata title and authors set:

$ maper create <bibtex> <pdf> [-o <output>]

where <bibtex> and <pdf> may be either local files or URLs, and output is a filename, or a directory. If <output> is not a directory, the resulting pdf will be stored in that file. If <output> is an existing directory, the file will be stored in <output>/<FirstAuthorFamilyName><Year><FirstTitleWord>.pdf. If <output> is omitted, the current directory is assumed.


Show a summary of the attached bibtex of one or multiple pdfs:

maper show [<pdf> ...]


Show the bibtex of one or combined of multiple pdfs (e.g. to create a full bibtex file)

$ maper bibtex [<pdf> ...]


The following creates the pdf Weizenbaum1966ELIZA.pdf, shows a summary, and the full attached bibtex filed:

$ maper create '' ''
$ maper show Weizenbaum1966ELIZA.pdf
$ maper bibtex Weizenbaum1966ELIZA.pdf

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

maper-0.1.0.tar.gz (4.3 kB view hashes)

Uploaded source

Built Distribution

maper-0.1.0-py3-none-any.whl (5.9 kB view hashes)

Uploaded py3

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