README.org

Fowlstream

A command line utility for streaming tweets using rules. Based on Twitter’s Filter Stream API.

Installing

Fowlstream was written for Python 3.8. Other versions may work but no guarantees.

pip install 'aiohttp[speedups]'

Credentials

You’ll need a Twitter Developer account.

• Sign up for Twitter if you don’t already have an account: https://twitter.com/
• Apply to be a Twitter developer: https://developer.twitter.com/
• Once approved create an app: https://developer.twitter.com/en/apps (You’ll use the Consumer API Keys, not the “Access token & access token secret”)
• Enable the Filter Stream API in Labs and associate your app: https://developer.twitter.com/en/account/labs

Usage

export TWITTER_ACCESS_TOKEN=<token>
export TWITTER_ACCESS_SECRET=<secret>

./fowlstream.py list-rules  # should return nothing
./fowlstream.py set-rule dogs "(dog OR puppy) has:image -is:retweet -is:quote"
./fowlstream.py list-rules  # should see your new rule

To watch the stream:

./fowlstream.py watch

Or if you’d like to save the data later for processing in some other way

./fowlstream.py stream >> rainy_day_pictures.json

Be sure to check out the built-in documentation

./fowlstream.py --help