Contents of /bti/trunk/README

bti - bash twitter/identi.ca ididocy

Allows you to pipe your bash input to twitter or identi.ca in an easy
and fast manner to annoy the whole world.

See the man page bti.1 for how to use it and more information.

Be careful if you use this, it is quite easy to end up sending sensitive
data to the world with it.

USE AT YOUR OWN RISK!

Any questions, contact Greg Kroah-Hartman <greg@kroah.com> or @gregkh
on twitter or identi.ca.

bti is developed using git and the tree can be found at:
        git://github.com/gregkh/bti.git
and browsed at:
        http://github.com/gregkh/bti/


About OAuth configuration

If you want to use an OAuth-enabled service (like twitter), you should
configure bti to use the consumer key and secret shipped with the source
code (check the oath.keys file).

For example, you should add the following two lines to your ~/.bti
configuration file:

---8<-------------------
# Consumer key
consumer_key=cZy8DdioswAfu3LJYg6E2w

# Consumer secret
consumer_secret=fnIGGU0T12mMWKjmThUdSeKN32NLWfmnwapwubVQ
---8<-------------------

The next time that you run bti, you will be told to visit an URL that
will provide you a PIN number. You should then input that number in the
bti prompt, and you will be given two new configuration values
(access_token_secret and access_token_key) that you need to add to your
bti configuration file to authenticate requests from bti.
1	bti - bash twitter/identi.ca ididocy
2
3	Allows you to pipe your bash input to twitter or identi.ca in an easy
4	and fast manner to annoy the whole world.
5
6	See the man page bti.1 for how to use it and more information.
7
8	Be careful if you use this, it is quite easy to end up sending sensitive
9	data to the world with it.
10
11	USE AT YOUR OWN RISK!
12
13	Any questions, contact Greg Kroah-Hartman <greg@kroah.com> or @gregkh
14	on twitter or identi.ca.
15
16	bti is developed using git and the tree can be found at:
17	git://github.com/gregkh/bti.git
18	and browsed at:
19	http://github.com/gregkh/bti/
20
21
22	About OAuth configuration
23
24	If you want to use an OAuth-enabled service (like twitter), you should
25	configure bti to use the consumer key and secret shipped with the source
26	code (check the oath.keys file).
27
28	For example, you should add the following two lines to your ~/.bti
29	configuration file:
30
31	---8<-------------------
32	# Consumer key
33	consumer_key=cZy8DdioswAfu3LJYg6E2w
34
35	# Consumer secret
36	consumer_secret=fnIGGU0T12mMWKjmThUdSeKN32NLWfmnwapwubVQ
37	---8<-------------------
38
39	The next time that you run bti, you will be told to visit an URL that
40	will provide you a PIN number. You should then input that number in the
41	bti prompt, and you will be given two new configuration values
42	(access_token_secret and access_token_key) that you need to add to your
43	bti configuration file to authenticate requests from bti.