https://github.com/iliyan-trifonov/twitter-topic-stream

Set a topic and watch the stream in real time
https://github.com/iliyan-trifonov/twitter-topic-stream

Last synced: about 1 month ago
JSON representation

Set a topic and watch the stream in real time

• Host: GitHub
• URL: https://github.com/iliyan-trifonov/twitter-topic-stream
• Owner: iliyan-trifonov
• License: mit
• Created: 2015-07-28T15:51:55.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2015-07-30T10:10:30.000Z (over 9 years ago)
• Last Synced: 2023-03-26T13:57:18.646Z (almost 2 years ago)
• Language: JavaScript
• Size: 172 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Twitter Topic Stream

---

You set a word or words to look for and the application will show you a real-time stream of any tweets containing the

word specified. You can use special symbols like # and @ for topics and tags.

Tech

----

This is a JavaScript application that uses [Node.js](https://nodejs.org/) as a back-end. It setups a connection to 

[Twitter](https://twitter.com/) and is able to receive search requests from multiple users.

The front-end is built with [Angular.js](https://angularjs.org/). Custom CSS for `ng-cloak` is used. `ngAnimate` with 

CSS3 animations(keyframes) is used to animate the stream and the single tweets for the user to get a better picture of 

what comes and when and for the to page to look like a real stream.

When a new tweet is found the back-end sends it to the front-end through web sockets using 

[Socket.IO](http://socket.io/).

Web Sockets and sessions are connected together so when a user comes back to the page his settings and streams are 

waiting intact. Also when the user closes the page his stream is stopped. After the user quits his stream and data are

deleted after a small interval: this is like an automatic cleanup of the server's resources. The client will be 

recreated the next time he visits the page.

You can start multiple streams by using different browsers in your computer.

If the back-end is restarted, the front-end detects that and suggests a page refresh after the server comes back online.

Install

---

Run these commands before starting the application:

    npm install

    bower install

    

Create a new app on your [Twitter dev account](https://apps.twitter.com/). Then copy the 

[config/config.json.dist](config/config.json.dist "config.json") to config/config.json and put your 

[Twitter app data](https://apps.twitter.com/) inside. You can also set the default search term and the maximum tweets 

on page.

    

Then start the Node.js application like this:

    npm start

    

After that go to `http://localhost:3000` and start your own stream.