Paper Inbox
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
🚀 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)
| File | Size | Uploaded | |
|---|---|---|---|
| paper_inbox-2025.12.12.tar.gz | 442.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|