An IMAP listener that sends instant push notifications when a new email is received using IMAP-IDLE. This Python script was created for my private use because my university's email service does not provide push notifications. Constant fetching on mobile devices caused significant battery drain issues while still not being instantaneous.
- Push notifications (current implementation through PushOver)
- Sleep and Wind down during weekends
- Clean CLI interface and logging.
- Own custom push notification platform/ other third-party services like IFTT
- Sender/Subject line logic for priority checking
python3 -m venv pyenv
.\pyenv\Scripts\Activate.ps1 (Powershell)
source pyenv/bin/activate (Bash)
python3 -m pip install -r requirements.txt
Please fill the .env with your credentials. A template has been provided.
No Output to tty:
nohup python3 imap.py > /dev/shm/imap-idle-output.log &
Blend output to tty:
nohup python3 imap.py | tee /dev/shm/imap-idle-output.log &
Kill the background task:
ps aux | grep imap
kill PID
To read the log:
tail -f /dev/shm/imap-idle-output.log
cat /dev/shm/imap-idle-output.log
I no longer use this script, so I am making it public, use at your own discretion. No Warranty is provided.