Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/venkatnvs/twittrends_selenium
TwitTrends: Real-Time Twitter Trends Web App Using Selenium, Flask
https://github.com/venkatnvs/twittrends_selenium
flask mongodb python selenium selenium-python twitter
Last synced: 20 days ago
JSON representation
TwitTrends: Real-Time Twitter Trends Web App Using Selenium, Flask
- Host: GitHub
- URL: https://github.com/venkatnvs/twittrends_selenium
- Owner: Venkatnvs
- Created: 2025-01-22T09:51:53.000Z (21 days ago)
- Default Branch: main
- Last Pushed: 2025-01-22T11:13:47.000Z (21 days ago)
- Last Synced: 2025-01-22T11:19:18.750Z (21 days ago)
- Topics: flask, mongodb, python, selenium, selenium-python, twitter
- Language: Python
- Homepage: https://www.youtube.com/watch?v=onTlC39ON0k
- Size: 5.86 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TwitTrends 🐦
A web application to fetch and display real-time X (formerly twitter) trending topics with user authentication. Built using Flask for the backend and Tailwind CSS for a sleek, modern UI.
---
## Demo Video 🎥
https://github.com/user-attachments/assets/81abef79-8e3e-4b94-a32f-af0b33bfa83f
**Youtube Link**: [https://www.youtube.com/watch?v=onTlC39ON0k](https://www.youtube.com/watch?v=onTlC39ON0k)
---
## Features 🚀
- User authentication with Twitter username and password.
- Fetch and display the top 5 trending topics on X.
- Dynamic UI with a responsive design using Tailwind CSS.
- Real-time IP address display for query tracking.
---
## Tech Stack 💻
- **Frontend**: HTML, Tailwind CSS, JavaScript (ES6)
- **Backend**: Flask, Python, Selenium
---
## Installation 🔧
### Prerequisites
- Python 3.8+
### Steps
1. Clone the repository:
```bash
git clone https://github.com/Venkatnvs/TwitTrends_Selenium.git
cd TwitTrends_Selenium
```
2. Run the Server:
```bash
python app.py
```
3. Open your browser and navigate to `http://127.0.0.1:5000`.
---
## API Workflow 🌐
1. **Frontend**:
- Accepts a Twitter username and password via a form.
- Sends this data as a POST request to the backend (`/run-script`).
- Displays the fetched trends dynamically in a styled format.
2. **Backend**:
- Receives the user credentials and validates them.
- Fetches top 5 trending topics.
- Returns a JSON response containing trends, query datetime, and IP address.
3. **Output**:
- Only displays non-null trends dynamically.
---
## Example Response 📝
```json
{
"datetime": "2025-01-22 12:45:30",
"trends": [
"Trend 1",
"Trend 2",
"Trend 3",
"Trend 4",
"Trend 5"
],
"ip_address": "192.168.1.1"
}
```
---
## How to Use 🖱️
1. Enter your X username and password in the provided fields.
2. Click the **Fetch Trends** button.
3. Wait for the trends to load (loading animation displayed).
4. View the trends along with the IP address and timestamp.
---
## Contact 📧
For any questions or feedback, reach out to:
- **Email**: [email protected]
- **GitHub**: [Venkatnvs](https://github.com/Venkatnvs)