https://github.com/abhyudayasharma/mailprinter
Print a file on your printer from anywhere in the world by sending an email!
https://github.com/abhyudayasharma/mailprinter
cups email linux macos print raspberry-pi
Last synced: 8 days ago
JSON representation
Print a file on your printer from anywhere in the world by sending an email!
- Host: GitHub
- URL: https://github.com/abhyudayasharma/mailprinter
- Owner: AbhyudayaSharma
- License: mit
- Created: 2018-12-18T06:57:54.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-03-13T12:10:22.000Z (over 6 years ago)
- Last Synced: 2025-04-02T11:11:16.382Z (3 months ago)
- Topics: cups, email, linux, macos, print, raspberry-pi
- Language: Python
- Homepage:
- Size: 6.84 KB
- Stars: 10
- Watchers: 2
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MailPrinter
A Python 3 app to automatically print email attachments sent to your printer.
Requires a printer configured with CUPS (Common Unix Printing System).
Works on any Unix-like system including macOS and Linux, even the Raspberry Pi.
It is recommended to use an account separate from your own email account.
## Setup
- Configure your printer using your operating system settings.
- Clone the repository and `cd` to the cloned folder.
- Run `[sudo] ./setup.py install`.
- Make the configurations for your email and printer in config.json.
- Set the email and password for the account to be used:
```bash
export MAIL_PRINTER_USERNAME="[email protected]"
export MAIL_PRINTER_PASSWORD="password"
```
- Run `python mailprinter` to start printing your email attachments from anywhere in the world.
### Configuration options
All configurations are made in config.json:
```JSON
{
"IMAP_port": 993,
"IMAP_server": "imap.gmail.com",
"SSL_required": true,
"printer_name": "My_Printer",
"send_receive_interval": 60
}
```
- `IMAP_port:` The port used for IMAP by your email provider. Generally port `993`.
- `IMAP_server`: The IP/domain of the IMAP server.
- `SSL_required`: A boolean signifying whether the server requires SSL
- `printer_name`: The name of the printer as used by CUPS. Run the program to see the list
of all configured printers visible to the program. Copy the name of the printer to use
and paste it in this field.
- `send_recieve_interval`: The time interval (in seconds) between re-checking emails.
NOTE: Only PDF attachments are printed right now.