source: README @ 8496cc2

release-1.7release-1.8release-1.9
Last change on this file since 8496cc2 was 8496cc2, checked in by Nelson Elhage <nelhage@mit.edu>, 13 years ago
Document identi.ca support.
  • Property mode set to 100644
File size: 1.3 KB
Line 
1The Twitter module implements Twitter support for BarnOwl. It also
2supports automatic mirroring of some subset of Zephyrs you send to
3Twitter.
4
5To configure it, first
6
7* Add your twitter credentials to ~/.owl/twitter as a JSON hash, e.g.
8{"user":"nelhage", "password":"sekrit" }
9* Load the module (cp Twitter.par into ~/.owl/modules and :reload-module Twitter)
10* Set the twitter:class, twitter:instance, and twitter:opcode
11  variables to the destination you want messages to be mirrored
12  from. By default, they are -c $YOUR_USERNAME -i status -O twitter
13  Setting twitter:opcode to "" will cause "normal" (i.e. no opcode)
14  messages to that class/instance to be mirrored. A value of '*'
15  works as a "match-anything" wildcard for any of the fields.
16
17Twitter.par will also receive twitters and inject them into barnowl as
18messages of type 'twitter'. It polls for normal messages once a
19minute, and direct messages every other minute. To disable polling,
20you can unset the 'twitter:poll' variable in BarnOwl.
21
22Twitter.par now supports other Twitter-compatible microblogging
23services, like identi.ca. To enable this, set the 'service' parameter
24in your config hash to the API URL of your service. You will likely
25also need to set 'apihost' and 'apirealm'. See Net::Twitter or your
26blogging service's documentation for more information.
Note: See TracBrowser for help on using the repository browser.