FzThreads - Consistent Embedding of Metadata for Threads

Fixes Meta's Threads metadata for sites like Discord, Telegram, etc.

Forked from milanmdev/fixthreads, with additional features for FzThreads.

Features

• Improved metadata rendering for Threads links
• Mastodon-compatible metadata and ActivityPub-style responses
• Better video preview/player metadata
• Custom FzThreads favicon and provider icon metadata

Usage

When you send a threads.com or threads.net link, replace the domain with fzthreads.com and then send it. (im broke)

Docker

Build the image:

docker build -t fzthreads .

Create your runtime folders, then put your private credentials in config/users.json:

mkdir -p config generated
cp config/users.example.json config/users.json

Run the container:

docker run -d --name fzthreads \
  -p 20061:20061 \
  -e PORT=20061 \
  -v "$(pwd)/config:/build/config:ro" \
  -v "$(pwd)/generated:/build/generated" \
  fzthreads

config/ is mounted read-only because the app only reads config/users.json. generated/ is mounted writable so login/session tokens can persist across container restarts.

Getting config/users.json

config/users.json is private. It can contain Threads/Instagram login cookies, a bearer token, or username/password credentials. Do not commit it or paste it into issues/logs.

The recommended format is cookie-based:

[
  {
    "username": "your_threads_username",
    "cookies": {
      "sessionid": "YOUR_SESSION_ID",
      "csrftoken": "YOUR_CSRF_TOKEN",
      "ds_user_id": "YOUR_USER_ID",
      "mid": "YOUR_MID",
      "ig_did": "YOUR_IG_DID"
    }
  }
]

Quick DevTools Console method:

1. Log in at https://www.threads.com/.
2. Open DevTools, then open the Console tab.
3. Paste this script. It copies a config/users.json template to your clipboard.

(() => {
  const wanted = new Set(["sessionid", "csrftoken", "ds_user_id", "mid", "ig_did"]);
  const cookies = Object.fromEntries(
    document.cookie
      .split(";")
      .map(part => part.trim())
      .filter(Boolean)
      .map(part => {
        const index = part.indexOf("=");
        return [part.slice(0, index), decodeURIComponent(part.slice(index + 1))];
      })
      .filter(([key, value]) => wanted.has(key) && value)
  );

  const config = [
    {
      username: "your_threads_username",
      cookies,
    },
  ];

  copy(JSON.stringify(config, null, 2));
  console.log("Copied config/users.json JSON to clipboard. Keep it private.");
})();

If sessionid is missing, use the Network tab instead:

1. Open DevTools, then open the Network tab.
2. Refresh https://www.threads.com/.
3. Click a request to www.threads.com.
4. In Request Headers, copy the Cookie header. You can also right-click the request, choose Copy, then Copy as cURL, and copy the value from the cookie: header in that command.
5. Convert the Cookie header into the cookies object above. Keep at least sessionid; csrftoken, ds_user_id, mid, and ig_did are also useful.

Cookie header converter:

const cookieHeader = "PASTE_COOKIE_HEADER_HERE";
const wanted = new Set(["sessionid", "csrftoken", "ds_user_id", "mid", "ig_did"]);
const cookies = Object.fromEntries(
  cookieHeader
    .split(";")
    .map(part => part.trim())
    .filter(Boolean)
    .map(part => {
      const index = part.indexOf("=");
      return [part.slice(0, index), decodeURIComponent(part.slice(index + 1))];
    })
    .filter(([key, value]) => wanted.has(key) && value)
);

copy(
  JSON.stringify(
    [
      {
        username: "your_threads_username",
        cookies,
      },
    ],
    null,
    2
  )
);

You can also use a bearer token instead:

[
  {
    "username": "your_threads_username",
    "token": "Bearer IGT:2:YOUR_TOKEN"
  }
]

Support

If you need support, feel free to join the Discord server.