Listener for new public Periscope streams
Project description
# The Periscope Firehose!
Provides a class, `PeriscopeFirehose`, that allows you to listen for new Periscope broadcasts published on Twitter simply by overriding the method `on_broadcast`.
### Installation
`$ pip install periscope-firehose`
### Usage
```python
from periscope_firehose import PeriscopeFirehose
class MyFirehose(PeriscopeFirehose):
def on_broadcast(self, broadcast):
print "New Periscope Broadcast published!"
print "- id:", broadcast.id
print "- twitter handle:", broadcast.twitter_screen_name
print "- status:", broadcast.status
firehose = MyFirehose(TWITTER_CONSUMER_KEY, TWITTER_CONSUMER_SECRET, TWITTER_OAUTH_TOKEN, TWITTER_OAUTH_SECRET)
firehose.listen()
```
Get your Twitter consumer key, consumer secret, oauth token, and oauth secret from the [Twitter Application Management page](https://apps.twitter.com/).
Provides a class, `PeriscopeFirehose`, that allows you to listen for new Periscope broadcasts published on Twitter simply by overriding the method `on_broadcast`.
### Installation
`$ pip install periscope-firehose`
### Usage
```python
from periscope_firehose import PeriscopeFirehose
class MyFirehose(PeriscopeFirehose):
def on_broadcast(self, broadcast):
print "New Periscope Broadcast published!"
print "- id:", broadcast.id
print "- twitter handle:", broadcast.twitter_screen_name
print "- status:", broadcast.status
firehose = MyFirehose(TWITTER_CONSUMER_KEY, TWITTER_CONSUMER_SECRET, TWITTER_OAUTH_TOKEN, TWITTER_OAUTH_SECRET)
firehose.listen()
```
Get your Twitter consumer key, consumer secret, oauth token, and oauth secret from the [Twitter Application Management page](https://apps.twitter.com/).
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.