https://github.com/graysoncadams/imap-watcher
https://github.com/graysoncadams/imap-watcher
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/graysoncadams/imap-watcher
- Owner: GraysonCAdams
- Created: 2025-10-02T19:29:48.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2025-10-04T06:23:49.000Z (9 months ago)
- Last Synced: 2025-10-04T07:19:53.258Z (9 months ago)
- Language: JavaScript
- Size: 28.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# IMAP Watcher → CardDAV Sync
Watches IMAP folders for new messages. When a new message is added to `INBOX` or `Screened Out` the sender is added/updated in a CardDAV address book and contact groups are adjusted:
- If message lands in `INBOX`: ensure contact exists, remove `Screened Out` group, add `Screened` group
- If message lands in `Screened Out`: ensure contact exists, remove `Screened` group, add `Screened Out` group
Setup:
1. Copy `.env.example` to `.env` and fill in values.
2. npm install
3. npm start
Notes:
- This project uses the `imap` package to watch folders. Some IMAP servers support IDLE; others require polling.
- CardDAV operations are performed via WebDAV requests using `node-fetch`.