/streaming-pics

A simpler media timeline for Twitter.

Primary LanguageJavaScriptGNU General Public License v2.0GPL-2.0

Streaming Pics

build status Dependency Status devDependency Status

A simpler media timeline for Twitter.

Features

  • Display media from authenticated user's timeline (realtime).
  • Display media from posted or liked tweets by a Twitter user.
  • Display media from tweets in a public Twitter list.
  • Display media from others' retweeted or quoted tweets.
  • Display photos from tweets which contain an Instagram photo link.
  • Like & Unlike a tweet.
  • Support images, GIFs and videos uploaded from Twitter official clients.

Browser Compatabilities

I won't support any fallback browsers such as IE 8 or even IE 6. Streaming Pics should be able to run smoothly on the latest version of Chrome, Safari, Firefox and IE Edge. Feel free to submit an issue if there's any problem.

Requirements

Config

You can copy .env.example to .env, change the preset value, or set the following required environment variables by yourself.

# Check out https://apps.twitter.com/

TWITTER_CONSUMER_KEY
TWITTER_CONSUMER_SECRET
TWITTER_CALLBACK_URL

# Valid Redis connection string from https://github.com/luin/ioredis

SESSION_REDIS_CONNECT

# Session secret

SESSION_SECRET

# Google Analytics config

GOOGLE_ANALYTICS_TRACKING_ID

Up & Running

npm install

# Development

npm run dev

# Production

npm build && npm start

Contributing

Contributors are always welcome!

If you have some awesome idea about the feature, please submit an issue first.

If you want to fix something, please make sure the code would pass npm run lint checks and the basic test specs before sending the PR.

License

GPL V2 (GPL-2.0)

Acknowledgements