1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
NAME
Twitter.par - Twitter support for BarnOwl
DESCRIPTION
The Twitter module implements Twitter support for BarnOwl. It also
supports automatic mirroring of some subset of Zephyrs you send to
Twitter.
SYNOPSIS
(1) Configure your Twitter credentials in ~/.owl/twitter in the
following format:
----------8<----------cut here----------8<----------
{
"user":"nelhage",
"password":"sekrit"
}
----------8<----------end cut ----------8<----------
(2) Run ":reload-module Twitter" inside BarnOwl
(3) Start receiving tweets in BarnOwl!
You can send tweets with the ":twitter" command.
MIRRORING ZEPHYRS TO TWITTER
If you set the twitter:class, twitter:instance, and twitter:opcode
BarnOwl variables, BarnOwl will resend zephyrs matching those fields
as tweets coming from you.
By default, these default to -c $YOUR_USERNAME -i status -O twitter.
Setting twitter:opcode to "" will cause "normal" (i.e. no opcode)
messages to that class/instance to be mirrored. A value of '*' works
as a "match-anything" wildcard for any of the fields.
POLLING
Twitter.par polls for normal messages once a minute, and direct
messages every other minute. To disable polling, you can unset the
'twitter:poll' variable in BarnOwl.
IDENTI.CA SUPPORT
Twitter.par supports other Twitter-compatible microblogging services,
like identi.ca. To enable this, set the 'service' parameter in your
config hash to the API URL of your service. You may also need to set
'apihost' and 'apirealm'. See Net::Twitter or your blogging service's
documentation for more information.
MULTIPLE ACCOUNTS
Twitter.par also supports using multiple Twitter and
Twitter-compatible microblogging accounts from the same instance.
To enable this, add additional hashes to your ~/.owl/twitter file as
a JSON list, e.g.
----------8<----------cut here----------8<----------
[
{
"account_nickname": "twitter",
"user": "nelhage",
"password": "sekrit",
"default": true,
"publish_tweets": true
},
{
"account_nickname": "identica",
"service": "http://identi.ca/api",
"user": "nelhage",
"password": "sekriter",
"publish_tweets": true
}
{
"account_nickname": "sipb",
"user": "sipb",
"password":"m0ars3krit",
"poll_for_tweets": false,
"poll_for_dms": false,
}
]
----------8<----------end cut ----------8<----------
Outgoing tweets sent via ":twitter" without an explicit sender, or
mirrored from zephyr, go to every account with "publish_tweets" set.
Outgoing direct messages and @-replies without an explicit sender come
from whichever account has "default" set. If no account has "default",
the first account is assumed to have "default" set. It is an error to
have more than one account with "default" set to true.
There are several account-specific parameters that control the
behavior of Twitter.par when using multiple accounts:
* account_nickname (string, required if multiple accounts are in use)
Specify a short name by which you can refer to the account, eg.
"identica" (eg. :twitter-direct nelhage identica would send a
direct message to @nelhage on identi.ca from your account
nicknamed "identica").
* default (boolean, default false)
If true, @-replies or direct messages you send without specifying
an account will be sent using this account. If no account has
this parameter, such messages will be sent using the first account
listed.
* poll_for_tweets (boolean, default true)
If true, tweets sent by users this account follows will be
displayed in your BarnOwl message list.
* poll_for_dms (boolean, default true)
If true, direct messages sent to this account will be displayed in
your BarnOwl message list.
* publish_tweets (boolean, default false)
If true, tweets you send without specifying an account (either
with the :twitter command or mirrored from a zephyr class) will be
published to this account.
If only one account is specified, it defaults to publish_tweets =
true.
* show_mentions (boolean, default true)
If true, BarnOwl will show all tweets that mention this account's
username, regardless of whether or not this account is following
the sender. Has no effect if poll_for_tweets is false.
* oauth_key, oauth_secret (strings, default BarnOwl's consumer credentials)
These are the OAuth consumer key and secret to use to negotiate an
OAuth connection to Twitter. These credentials must be enabled for
"xAuth".
|
