{"id":16935419,"url":"https://github.com/knu/bcbiff","last_synced_at":"2025-04-11T18:53:56.788Z","repository":{"id":1682988,"uuid":"2410396","full_name":"knu/bcbiff","owner":"knu","description":"bcbiff(1) - Boxcar based IMAP biff","archived":false,"fork":false,"pushed_at":"2013-02-14T12:24:29.000Z","size":124,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-25T14:51:17.224Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/knu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-09-18T17:10:11.000Z","updated_at":"2014-06-06T03:00:00.000Z","dependencies_parsed_at":"2022-09-03T11:12:00.788Z","dependency_job_id":null,"html_url":"https://github.com/knu/bcbiff","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knu%2Fbcbiff","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knu%2Fbcbiff/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knu%2Fbcbiff/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knu%2Fbcbiff/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/knu","download_url":"https://codeload.github.com/knu/bcbiff/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247974600,"owners_count":21026743,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-13T20:54:29.122Z","updated_at":"2025-04-11T18:53:56.765Z","avatar_url":"https://github.com/knu.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bcbiff\n\n## NAME\n\n`bcbiff(1) - Boxcar based IMAP biff`\n\n## SYNOPSIS\n\n`bcbiff`\n\n## DESCRIPTION\n\nBcbiff checks the Inbox folder on an IMAP server for unread mails and\nsends a notification mail for each.\n\nThis tool was made to send push notification to your iPhone via Boxcar\nwhen you have received a mail in Inbox on an IMAP server, primarily\nwith Gmail in mind.  Bcbiff composes a notification mail that has\nFrom, Date and Subject header fields copied from the original, with\nother fields and the body part removed.\n\nSimple mail forwarding using a filter on Gmail has a couple of\nproblems.  First, there is no easy way to write a filter that only\nmatches mails that will be dropping in Inbox.  Second, mail bodies and\nsensitive header fields will be leaked.  Bcbiff solves both.\n\nBcbiff caches the Message-Id's of the latest 100 unread mails so that\nyou get just one notification per mail, even if you leave a mail\nunread despite a notification.\n\n## FILES\n\n* `~/.bcbiff`\n\n    User configuration file that would look like below.\n\n        ---\n        :accounts:\n        - :host: imap.gmail.com\n          :port: 993\n          :ssl: true\n          :username: \"account1\"\n          :password: \"********\"\n          :mailto: \"******.*******@push.boxcar.io\"\n        - :host: imap.gmail.com\n          :port: 993\n          :ssl: true\n          :username: \"account2@your.domain\"\n          :password: \"********\"\n          :mailto: \"******.*******@push.boxcar.io\"\n          :folders:\n          - Inbox\n          - work/important\n\n    You can list as many account entries as you want.  The server\n    needs not be of Gmail, and the mailto address needs not be of\n    Boxcar.\n\n    If you want to check folders other than the default of `Inbox`,\n    specify them in the `:folders` field, in which case you need to\n    specify `Inbox` if you want it checked.\n\n* `~/Maildir/idcache.*.yml`\n\n    Message-Id cache files, one for each notification account.\n\n## USAGE\n\nPrepare your `~/.bcbiff`, adjust constants defined in `bcbiff` for\nyour system and run bcbiff once a minute or so.\n\n## REQUIREMENTS\n\nBcbiff will run with Ruby 1.8.7+ and 1.9.2+.\n\nBcbiff calls the `sendmail` command to send a mail.  Sendmail (or any\ncompatible software such as qmail or Postfix) must be properly\nconfigured.\n\nTo use SSL connections, you must have the certificates file/directory\nconfigured.  Some of the common paths are determined by default, but\nif bcbiff(1) fails to locate the one on your system, follow the\ninstruction displayed, and let me know if it's pretty much common on\nthe platform.\n\n## INSTALLATION\n\n`gem install bcbiff`\n\n## SEE ALSO\n\n* [Boxcar](http://boxcar.io/)\n\n* [Gmail](https://mail.google.com/)\n\n## AUTHOR\n\nCopyright (c) 2011, 2012, 2013 Akinori MUSHA.\n\nLicensed under the 2-clause BSD license.  See `LICENSE.txt` for\ndetails.\n\nVisit [GitHub Repository](https://github.com/knu/bcbiff) for the\nlatest information and feedback.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fknu%2Fbcbiff","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fknu%2Fbcbiff","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fknu%2Fbcbiff/lists"}