Skip to main content

Paper Inbox

Tests Status

Overwhelmed with emails and newsletters? Lift the signal from the noise by automatically printing out email paper copies from the senders you do care about.

What It Does

  • Checks your inbox for messages from specific senders (e.g. school)
  • Downloads and prints them with their attachments
  • Keeps track of printed emails to avoid duplicates.
  • Sends you a telegram msg whenever it prints a new email (optionally)

Limitations

At the moment paper-inbox only supports authentication of gmail inboxes.

Prerequisites

Please set up a google app in your google dashboard with a Gmail API, it will provide you with a secrets file that we will use during the configuration step of paper-inbox

The config will run all the checks on your system and will guide you through how to install some in case they are missing. The system dependencies the app currently relies on are:

  • libreoffice: To turn emails into printable PDFs.
  • CUPS: The printing system for Linux and macOS.

📦 Installation

pip install paper-inbox

Then run the interactive configuration with the --config flag

Config Demo

🚀 Usage

The interactive configuration should have helped you set up the app on a cron schedule, however you can also just run it manually to check everything is working:

paper-inbox

To see a print out of the current configuration

paper-inbox --show-config

To see a print out of the current cron schedule

paper-inbox --show-cron

To see a print out of used the directories and files

paper-inbox --show-dirs

To open the config dir:

paper-inbox --open-config

License

MIT License. This project is for personal use.

Metadata

Release files for paper-inbox 2025.12.12

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for paper-inbox 2025.12.12
File Size Uploaded
paper_inbox-2025.12.12.tar.gz 442.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for paper-inbox 2025.12.12
File Interpreter ABI Platform
paper_inbox-2025.12.12-py3-none-any.whl Python 3 none any Details

Total release size: 490.3 kB

Release files / paper_inbox-2025.12.12.tar.gz

Download URL paper_inbox-2025.12.12.tar.gz
Size 442.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b89f17b90723f1fd6d776766950f4b6b4cee7b60e4642d531e8051409c2249eb
BLAKE2b-256 checksum
How to use checksums
13016f3ec3a153e97747910284ef482e7aeafc4caa44742538f1edcfd03cf317
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.14

Release files / paper_inbox-2025.12.12-py3-none-any.whl

Download URL paper_inbox-2025.12.12-py3-none-any.whl
Size 48.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d5b17c14ff98b8b118c384fe3e1f7b1746b853aa460733149b06b2e4285d75db
BLAKE2b-256 checksum
How to use checksums
48efda5e56e29caa507593263ac1b7ff51581fd6eaa212cd907e8084d43efde6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.14
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page