0.1.0 • Public • Published


    Get an email whenever a tweet with a certain hashtag or mention is published.



    If you want to get email updates for some hashtag or mention, simply send an email to subscribe@domain.tld with the hashtag (including #) or mention (including @) in the subject field. If the subscription was successful, you will receive a confirmation email.


    If you no longer want to receive email updates, you can unsubscribe in a similar fasion: send an email to unsubscribe@domain.tld. Supplying the hashtag or mention in the subject field is optional. If you do not supply any, all your subscriptions will be removed.


    • A mailserver (I am using postfix)
    • A Redis server
    • NodeJS
    • Twitter API credentials (to be filled in in config.js)


    This installation guide is intended for Ubuntu and postfix. If you are using another MTA, you will have to figure out how to install this yourself. Installation is not that difficult ;)

    First, lets make sure all the requirements are satisfied.

    apt-get install postfix redis-server nodejs

    Now, let's install the source files

    mkdir -p /path/to/target/location && cd /path/to/target/location
    npm install twailer

    Next, we need to configure postfix. First, we need a new transport method. In master.conf, add

    twailer   unix  -       n       n       -       -       pipe
      flags=FR user=twailer argv=/path/to/twailer/bin/twailer

    Because your node installation may be different from mine, you might need to change the shebang. You could use /usr/bin/env node but then you will need to configure postfix to pass the $PATH variable.

    We want emails sent to (un)?subscribe@domain.tld delivered on this machine, so we need to add a mailbox domain in

    virtual_mailbox_domains = domain.tld [other domains]

    We don't want to receive these mails in an inbox, we want them delivered to our new transport. In, configure the location for the transport map.

    transport_maps = hash:/etc/postfix/transport

    In /etc/postfix/transport, add the following lines:

    subscribe@domain.tld    twailer:
    unsubscribe@domain.tld  twailer:

    Finally, we need to reload postfix. Don't forget to convert the transport map to Berkeley DB with postmap.

    postmap /etc/postfix/transport
    postfix reload

    You're all set! You can now process incoming subscription mails.

    To use the application, start the twailer process.

    node twailer.js 

    Questions, Pull Requests

    Open an issue




    npm i twailer

    DownloadsWeekly Downloads






    Last publish


    • mstaessen