Homemade Pinterest

A self-hosted, Pinterest-like web app for viewing Twitter/X media locally. The app obtains your liked tweets, and allows you to browse them in a grid-view.

Media files are automatically downloaded and cached locally, with optional WebP conversion to save space.

Features

• Pinterest-style grid layout for much easier browsing of your Twitter/X Likes.
• Automatic media download: Saves tweet images and user avatars for offline access.
• WebP conversion: Optionally convert images to WebP format to reduce storage usage.
• Privacy blur: For detected sensitive media.

Important Notes

• Never share your credentials. They are only used to authenticate to Twitter / X.
• Data (tweets + media) updates only when you click the Refresh button. It is recommended to use this feature sparingly to avoid Twitter/X rate limitations.

Setup

1. Configure Credentials

Create a .env file in the project root with your Twitter/X credentials:

USER_ID=your_user_id_here
HEADER_AUTHORIZATION=Bearer your_authorization_token
HEADER_COOKIES=your_complete_cookie_string
HEADER_CSRF=your_csrf_token

How to obtain credentials:

1. Open Twitter / X in a desktop browser and go to your Likes page.
2. Open DevTools (F12), Network tab.
3. Filter for requests containing /Likes.
4. Select a request to https://x.com/i/api/.../Likes.
5. Copy the following headers:
   • authorization → HEADER_AUTHORIZATION
   • x-csrf-token → HEADER_CSRF
   • full cookie string → HEADER_COOKIES
6. Find your numeric userId in the request payload or URL → USER_ID
7. Paste values into the .env file.

Important: Never share or commit .env.

2. Configure Application Settings

Edit config.json:

{
  "webp_conversion": {
    "enabled": true,
    "quality": 80,
    "method": 6
  }
}

• webp_conversion.enabled (boolean): Whether to convert images to WebP format. Default: true
• webp_conversion.quality (0-100): WebP quality level. Default: 80 (recommended: 75-85)
• webp_conversion.method (0-6): WebP compression method. Default: 6 (slower but better compression; use lower values for faster processing)

3. Run

./start.sh

start.sh creates a virtual environment, installs dependencies, and starts the server. The app will be available at http://localhost:8000.

Click Refresh to fetch new likes and download/process new media.