Repository is archived
No release in over 3 years
Low commit activity in last 3 years
Send your Mailchain messages to your email inbox with the IMAP connector for the Mailchain API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.0
~> 0.13
~> 12.0
~> 3.0

Runtime

~> 0.18, >= 0.18.0
~> 2.7, >= 2.7.1
~> 0.21, >= 0.21.0
 Project Readme

MailchainConnectorImap

The Mailchain Connector for IMAP makes it possible to receive Mailchain messages in your email inbox (i.e. your webmail, desktop or phone mail application).

It connects to the Mailchain API, converts messages to emails, then uploads them to your chosen IMAP mailbox.

NOTE: Further documentation can be found here: https://docs.mailchain.xyz/mailchain-connectors/mailchain-connector-imap

Prerequisites

You need to have installed:

  1. Ruby
  2. The Mailchain API client (https://docs.mailchain.xyz/installation)

Installation

Install by running:

  gem install mailchain_connector_imap

Usage

Getting Started & Configuration

When running mailchain_connector_imap for the first time, or to change the configuration, run:

  mailchain_connector_imap --configure

This will walk you through the configuration options.

NOTE: See Mailchain Docs for further information.

Running the Mailchain Connector for IMAP

To run the connector, once you have run the configuration:

  mailchain_connector_imap

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install.

To clean up and re-install the gem locally, run bundle exec rake clean then bundle exec rake install.

To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/mailchain/mailchain_connector_imap. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

Code of Conduct

Everyone interacting in the MailchainConnectorImap project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.