https://github.com/rollecode/tweets
🐦 tweets - Yet another Twitter archive viewer
https://github.com/rollecode/tweets
social-media tweet-archive twitter twitter-archive
Last synced: 27 days ago
JSON representation
🐦 tweets - Yet another Twitter archive viewer
- Host: GitHub
- URL: https://github.com/rollecode/tweets
- Owner: rollecode
- Created: 2025-09-21T20:50:32.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-09-22T14:00:44.000Z (8 months ago)
- Last Synced: 2026-05-02T13:33:34.568Z (28 days ago)
- Topics: social-media, tweet-archive, twitter, twitter-archive
- Language: HTML
- Homepage: https://mementomori.social/@rolle
- Size: 180 KB
- Stars: 6
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# 🐦 tweets - Yet another Twitter archive viewer
[](#)
[](#)
[](#)
A modern, responsive interface for viewing your Twitter archive data locally. This tool transforms your downloaded Twitter data into an elegant, Twitter-like interface that you can browse offline - with **minimal** effort!
**The goal: Single index.html file with JS, CSS and HTML - No compiling, no frameworks, no dependencies.**
## [Demo: tweets.rolle.wtf](https://tweets.rolle.wtf)
## Features
- **Modern Twitter-like (2022) interface**, dim theme by default
- **Responsive design** that works on desktop and mobile
- **Advanced filtering and search** with smart defaults
- **Video autoplay** on scroll
- **Infinite scroll** for seamless browsing
- **Hashtag and mention linking** with search integration
- **Date range filtering** and sorting options
- **Individual tweet permalinks** with back navigation
## Quick start
1. **Download your Twitter archive** from Twitter's settings
2. **Extract the archive** to a folder on your computer
3. **Download `index.html`** from this repository
4. **Place `index.html`** in the root of your extracted Twitter archive folder (same level as the `data` folder)
5. **Open `index.html`** in your web browser
## Folder structure
Your Twitter archive should look like this:
```
twitter-archive/
├── index.html <- Add this to the root of your archive
├── data/
│ ├── account.js
│ ├── tweets.js
│ ├── tweets_media/
│ └── profile_media/
└── assets/
└── ...
```
## Publishing your archive publicly
**⚠️ This tool is intended for PUBLIC Twitter accounts only. If your account was private/locked, do not use this tool for public sharing.**
### Automated public archive creation
Use the included script to safely create a public version:
```bash
# In your Twitter archive folder
./create-public-archive.sh
```
This script will:
- Copy only public data (tweets, profile info, followers/following)
- Remove your email address automatically
- Create a `public-twitter-archive/` folder ready for sharing
### What gets included safely
✅ **Always included:**
- Your public tweets (`tweets.js`)
- Profile information (bio, avatar, banner) - minus email
- Media from your tweets (images, videos)
- Follower/following lists (public data)
- Liked tweets (public data)
❌ **Never included:**
- Email address (automatically removed)
- Direct messages (the only truly private data)
- Any tracking or personalization data
### Publishing your archive
After running the script:
1. **Test locally**: Open `public-twitter-archive/index.html` in your browser
2. **Review content**: Make sure you're comfortable with all visible tweets
3. **Upload to web hosting**:
- GitHub Pages
- Netlify
- Your own web server
- Any static hosting service
## Disclaimer
This tool is not affiliated with Twitter/X. It's designed to work with Twitter archive data as provided by Twitter's official export feature.