Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/joehand/hypertweet
concept tweet -> hypercore thingy
https://github.com/joehand/hypertweet
dat hypercore
Last synced: 17 days ago
JSON representation
concept tweet -> hypercore thingy
- Host: GitHub
- URL: https://github.com/joehand/hypertweet
- Owner: joehand
- License: mit
- Created: 2017-04-21T02:38:48.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2017-04-22T02:20:27.000Z (over 7 years ago)
- Last Synced: 2024-10-17T00:47:35.675Z (23 days ago)
- Topics: dat, hypercore
- Language: JavaScript
- Homepage: https://hypertweet.glitch.me/
- Size: 605 KB
- Stars: 71
- Watchers: 4
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-peer-to-peer - hypertweet - > hypercore thingy (Modules)
- awesome-dat - hypertweet - stream your twitter feed to a hypercore feed (Dat Applications / Community Applications)
- awesome-peer-to-peer - hypertweet - > hypercore thingy (Modules)
README
# hypertweet
Proof of concept Twitter + [Dat](https://datproject.org) feed stream thingy.
Streams your twitter feed to a [hypercore](https://github.com/mafintosh/hypercore) feed. Pretty print your feed or stream it anywhere with [hyperpipe](https://github.com/mafintosh/hyperpipe).
## Install
```sh
npm install -g hypertweet
hypertweet --help # see help!
```
### Set twitter tokens
[Get Twitter developer key](https://apps.twitter.com/) and either set them as environment variables or copy `.sample.env` to `.env` file.
```
process.env.TWITTER_CONSUMER_KEY,
process.env.TWITTER_CONSUMER_SECRET
process.env.TWITTER_ACCESS_TOKEN_KEY,
process.env.TWITTER_ACCESS_TOKEN_SECRET
```
## Usage
Use `hypertweet --help` to see all the options.
### Collect Feed Data
Streams your feed into a hypercore feed:
```sh
❯ hypertweet --dir=/joe/my-twitter-data/
sharing 0c3ec59a8111fde379e7ef82e6610ec02daf6bd3b704f41554cd5fe76afd5cc4
2017-04-21T02:20:24.205Z tweet by: 'some twitter user'
2017-04-21T02:20:25.000Z tweet by: 'more chirps'
2017-04-21T02:20:30.043Z tweet by: 'asdf'
```
### Print anywhere
Pretty print it in another terminal (or another computer anywhere):
```sh
❯ hypertweet 0c3ec59a8111fde379e7ef82e6610ec02daf6bd3b704f41554cd5fe76afd5cc4
# pretty tweets here
```
### Or pipe
Pipe anywhere to anything.
```sh
npm install -g hyperpipe
hyperpipe /db 0c3ec59a8111fde379e7ef82e6610ec02daf6bd3b704f41554cd5fe76afd5cc4 > data.json
```
## API
### `hypertweet(dir|storage, [opts], callback(err, feed))`
Create a stream from the twitter API and share via hypercore `feed`. Automatically joins network via `discovery-swarm`.
* `dir|storage`: directory or random access module, e.g `random-access-memory`.
* `opts.streamUrl`: the [twitter streaming api](https://dev.twitter.com/streaming/overview) endpoint you want. defaults to user.
* `opts.streamOpts`: stream opts
## License
[MIT](LICENSE.md)