Publishr

Allows updating status on several social networks, sending email etc.

Supported actions:

Facebook
1. wall (text, link)
Livejournal
1. journal (text, link, image, tags)
2. community (text, link, image, tags)
Twitter (status + link, image)
VK
1. page wall (text, link, image)
2. group wall (text, link, image)
  1. from user
  2. from group
Email
1. SMTP
Jabber/XMPP
1. blog (text, link, tags)
IRC
1. channel
Skype (via Skype4Py)
1. chat room

Installation

Download cpanm:

curl -LO http://xrl.us/cpanm

Install modules using cpanfile in current directory by --installdeps option of cpanm:

perl cpanm --installdeps .

Preparing message

Mesage is a text file:

Status: New article is out
Link: http://mywebsite.com
Image: /path/to/image
Tags: perl

Just a long text
with
multilines...

Depending on the channel various information is used. For example for twitter the status, link and image are used and for facebook everything combined. And so on.

Configuring access

Access is configured via a JSON file:

# Comments are supported

{
# First we define access for different channels (types). After giving them names
# we can reference them in scenarios
   "access" : [
      {
         "name" : "twitter",
         "options" : {
            "access_token" : "",
            "access_token_secret" : "",
            "consumer_key" : "",
            "consumer_secret" : ""
         },
         "type" : "twitter"
      },
      {
         "name" : "facebook",
         "options" : {
            "access_token" : "",
            "app_id" : "",
            "secret" : ""
         },
         "type" : "facebook"
      },
      {
         "name" : "vk",
         "options" : {
            "access_token" : ""
         },
         "type" : "vk"
      },
      {
         "name" : "livejournal",
         "options" : {
            "password" : "",
            "username" : ""
         },
         "type" : "livejournal"
      },
      {
         "name" : "juick",
         "options" : {
            "password" : "",
            "jid" : ""
         },
         "type" : "juick"
      },
      {
          "name":"gmail",
          "type":"email",
          "options": {
              "transport": {
                  "host"     : "smtp.gmail.com",
                  "port"     : 587,
                  "username" : "...@gmail.com",
                  "password" : ""
              }
          }
      },

   ],

# Example scenarios
   "scenarios" : [
      {
         "access" : "twitter",
         "name" : "twitter"
      },
      {
         "access" : "juick",
         "name" : "juick"
      },
      {
         "access" : "livejournal",
         "name" : "livejournal"
      },
      {
         "access" : "livejournal",
         "name" : "livejournal community",
         "options" : {
            "usejournal" : ""
         }
      },
      {
         "name" : "vk wall",
         "access" : "vk",
         "options" : {
            "user_id" : ""
         }
      },
      {
         "name" : "vk group",
         "access" : "vk",
         "options" : {
            "group_id" : ""
         }
      },
      {
         "name" : "facebook group",
         "access" : "facebook",
         "options" : {
            "group_id" : ""
         }
      },
      {
          "name":"newsletter",
          "access":"gmail",
          "options": {
              "headers":[
                  "From", "...@gmail.com",
                  "To", "..@..."
              ]
          }
      },
      {
          "name":"irc channel",
          "options":{
              "hostname":"irc.perl.org",
              "channel":"#ru.pm"
          }
      },
      {
          "name":"skype",
          "options":{
              "env":{
                  "PYTHONPATH":"/path/to/skype4py/"
              },
              "cmd":"./util/skype-chat.py 'Chat room' '%status% %link%'"
          }
      }
   ]
}

Publishing

By default the config file is name publishr.json and is searched within a current working directory. To overwrite path to config file use --config option.

perl script/publishr message.txt
perl script/publishr --config another-config.json message.txt

Dry run

You can check what's going to happen using --dry-run option:

perl script/publishr --dry-run message.txt

Publishing only specific scenario

If you want to publish only to a specific scenario, just use --scenario option:

perl script/publishr --scenario 'vk wall' message.txt

Publishing only to specific channel

If you want to publish only to a specific social network, just use --channel option:

perl script/publishr --channel twitter message.txt

Getting access tokens

Twitter

Has to be done once.

Register your application via https://apps.twitter.com/.
Get your consumer and access tokens from https://apps.twitter.com/app/[APP_ID]/keys. Here you may have to confirm your phone number, only then Twitter will allow you to update statuses within an application.
Save consumer_key, consumer_secret, access_token, access_token_secret.

Facebook

Has to be done every two months.

Create your application via https://developers.facebook.com/apps.
Visit API Explorer https://developers.facebook.com/tools/explorer/.
Generate Access Token previously selecting your app.
Create a long-term token visiting https://graph.facebook.com/oauth/access_token?client_id=[APP_ID]&client_secret=[APP_SECRET]&grant_type=fb_exchange_token&fb_exchange_token=[ACCESS_TOKEN]
Save app_id, secret, access_token and group_id.

VK