sartoopjj/thefeed

What is it?

Key features

• 01Reads public Telegram channels and public X accounts through encrypted DNS queries.
• 02Optional end-to-end-encrypted messenger between users of the same server.
• 03Optional Telegram-over-DNS mode for using your own Telegram account through the server.
• 04Resolver bank with a scanner that finds DNS resolvers able to reach the server.
• 05Media relay through DNS or a GitHub repository, with size caps and verification.
• 06Client apps for Android, iOS, Windows, macOS and Linux, plus a web UI.

Use cases

• Reading Telegram channels on a network where normal internet traffic is blocked but DNS still resolves.
• Running a shared feed server that serves public channels to users in a restricted network.
• Chatting with other users of the same server when the wider internet is unavailable.
• Connecting an AI agent to the messenger so it can be reached over DNS.

Quick start

1. 1

   Install the client app from Google Play, the releases page, or TestFlight

2. 2

   Copy the Docker environment template before editing it

   cp .env.example .env
3. 3

   Start the feed server with Docker Compose (after setting your domain and key in .env)

   docker compose up -d

Things to know

• !Running your own server requires a domain you control, DNS records, and a server outside the censored network.
• !X (Twitter) posts are currently broken because the Nitter instances they rely on are archived and rate limited.
• !The Windows build is unsigned and is often flagged by Defender as a false positive.
• !The iOS app is distributed only as a TestFlight beta for now.

In collections

Topics

FAQ

What is thefeed?

A feed reader and lite messenger that runs over plain DNS queries, letting users read Telegram channels and X accounts where only DNS gets through. thefeed is a DNS-based feed reader and lite messenger for networks where only DNS queries get through. A server outside the restricted network pulls public Telegram channels and X accounts, then serves the content as encrypted DNS TXT responses. A browser-based client inside the network sends encrypted DNS queries through a set of resolvers and displays the feed.

Is thefeed free to use? What license does it have?

thefeed is open source under the MIT license. Check the license terms before using it in commercial products.

Is thefeed still maintained?

Actively maintained. The last commit to thefeed was on Nov 7, 2026.

What can I use thefeed for?

Reading Telegram channels on a network where normal internet traffic is blocked but DNS still resolves. Running a shared feed server that serves public channels to users in a restricted network. Chatting with other users of the same server when the wider internet is unavailable. Connecting an AI agent to the messenger so it can be reached over DNS.

How do I install thefeed?

Install the client app from Google Play, the releases page, or TestFlight Copy the Docker environment template before editing it: cp .env.example .env Start the feed server with Docker Compose (after setting your domain and key in .env): docker compose up -d

Where can I get thefeed?

The source code and installation instructions are on GitHub: https://github.com/sartoopjj/thefeed