forkmeGo home



mail2twitter allows you to share a Twitter account with other persons without having to share the password. You can tweet and follow users by email.


You need Python 2 to execute the script. mail2twitter depends on the following packages:


Before using mail2twitter for the very first time open the file to configure the application.

mail2twitter stores information in a database file. You can specify the location with the DB_PATH setting.

To send and receive mails enter all POP3 and SMTP related details.

Now login to Twitter to create a consumer key and secret. mail2twitter needs these values to access the Twitter service endpoint. Copy both strings to the configuration file (CONSUMER_KEY and CONSUMER_SECRET).

mail2twitter can handle mails in HTML format by using the Lynx browser for rendering. Therefore set the path to your Lynx binary (LYNX_EXECUTABLE).


When you have finished the configuration you can create your first user:

$ --create-user [username] [firstname] [lastname] [email]

There are two options available to query user information:

$ --show-users
$ --show-user [username]

If you want to enable or disable an account use the –enable-user or –disable-user option. Please note that mail2twitter will only process mails from enabled users.

To post a tweet an enabled user has to send a mail with the subject "tweet" to the configured mail2twitter email address . The body of the message will be tweeted.

It's also possible to change friendship. Therefore send a mail with the subject "follow" or "unfollow" to change the relationship. The message body can be a comma-separated list of Twitter user names or a single name.

Running mail2twitter with the –fetch-mails option it receives mails via POP3 and stores the received commands in an internal queue. You can print this queue with the following command:

$ --show-queue

To process the queue use the –post option.

When mail2twitter receives mails or connects to Twitter it will generate various messages (e.g. when a received mail is invalid). It's possible to send these messages with the –send-messages option. mail2twitter uses the defined SMTP credentials to transfer mails.

You can print a list with all available commands by entering

$ --help