分散型ミニマルマイクロブログサービス twtxt についてまとめています。

ページ運営者は次です。日本語 fu-sen と英語 balloon に分けてあります。

🎈 https://fu-sen.oldcities.org/twtxt.txt - (http:) - fu-sen (日本語)
🎈 https://fu-sen.oldcities.org/twtxt.txt - (http:) - balloon (English)\

また返信とタイムライン確認用に次のアカウントがあります。
このアカウントは  twtd と  twtxt.app を用いて
タイムラインを確認・返信しています。

🎈 https://tw.fus.f5.si/twtxt.txt - balloon-fu-sen

目次

公式リポジトリ・ドキュメント

 twtxt
 document

仕組み

ページ運営者のアカウントは次です。

🎈 https://fu-sen.oldcities.org/twtxt.txt - (http:) - fu-sen

……はい。テキストファイルです。
twtxt はテキストファイルを Web 上に公開し、これをフォローする事で
タイムライン・フィードを表示する仕組みになっています。
公開するところは共用レンタルサーバーでも、VPS でも、
クラウドストレージでも、Web サービスでも、
http: または https: で参照できる場所ならどこでも良いんです。
投稿した後に更新したテキストファイルをアップロード・デプロイする必要がありますが、
クライアントによってはコマンドによってアップロードできるようにできるものもあります。

仕様上テキストの文字コードは UTF-8 と定められているので、
日本語や Unicode 絵文字も使用できます。

twtxt.app を使用する

🌐 twtxt.app

もう少し本来の twtxt に使い使い方・公開方法を維持しつつ、
スマートフォン等からでも容易に投稿し、返信も確認できるようにするために、
twtxt.app が制作・公開されました。

アカウント代わりとなるテキストファイルは次のいずれかを選択できます。

あとはフォローしたり投稿したりして下さい。
Web アプリとしてインストールしての使用も可能です。

twtd サーバー

 yarnsocial/twtd | git.mills.io

VPS やクラウドインスタンスを使用している場合、twtd を使用できます。
Go 言語をインストールした上でビルドを行います。

git clone https://git.mills.io/yarnsocial/twtd.git
cd twtd
go build -o twtd .

必要な場合 /usr/bin などの PATH が通っているところへインストールします。

sudo cp twtd /usr/bin 

更新する場合は次のとおりです。
twtxt.app で何か動きがおかしくなった時は twtd の更新が入っている可能性が高いです。
アカウントを作成して Git リポジトリを watch し、更新を通知できるようにして、
常に twtd を最新へ更新できるようにしておくのがおすすめです。

cd twtd
git pull
go build -o twtd .

インストール前に twtd を停止し、
新バージョンをインストールしたら再度動作するようにします。

sudo cp twtd /usr/bin 

twtd のオプションでテキスト出力を決めます。

-u で指定している https://ドメイン/ は HTML による説明ページになり、
https://ドメイン/twtxt.txt でテキストファイルを表示します。
この twtxt.txt を公開する事になります。

twtd -d /home/balloon/twtxt-data -n username -u https://example.net.eu.org -e "アカウントの説明" -l "リンク https://link.example.net.eu.org/" -l "リンク https://複数可能"

日本語も使用できます。UTF-8 で記載して下さい。
なお、アバターやフォロー操作は twtxt.app で設定できます。

SSL の対応とプロキシが必要になります。
例えば 🎈 Caddy を用いて https://example.net.eu.org/ で公開する場合、
Caddyfile は次のようになります。

example.net.eu.org {
  reverse_proxy localhost:8000 {
    header_up X-Real-Ip {remote_host}
    header_up X-Http-Version {http.request.proto}
  }
}

ページ運営者の経験上、Cloudflare プロキシ経由だと投稿に失敗していました。
🎈 Anubis 経由も参照できなくなる可能性があるでしょう。

twtpub.com

🌐 twtpub.com

twtd サーバーを建てられない場合でも twtpub.com を試用できます。
 twtxt.app の Settings より
「Publishing」の「Hosted feed」にある Claim a feed を選択すると
twtpub.com が選択され、nick を入力できるようになっています。
メールアドレスへコードを送るようにできます。
コードはパスワード代わりなので公開しないよう、\また紛失しないようご注意下さい。

yarn を使用する

🧵 yarn (yarn.girlonthemoon.xyz)

右上に Register があり、ここから登録できます。
ユーザー名（英数と - _ ）・パスワード・メールアドレス・
コミュニティガイドライン遵守同意に を入れます。
ここでのユーザー名は twtxt の nick =（ニックネーム）になります。

ログインしたら、右上 Settings で「Add Custom Link」に URL を加えます。
twtxt では link = で表示されます。
また Change Avatar で画像を設定すると twtxt の avatar = 、
Update Tagline に説明を入れると twtxt の description = に入ります。
その他テーマの変更などが可能です。

Timeline で見たアカウントをフォローしていっても良いですが、
twtxt の URL を把握した場合は「Search for twts」のところに入れると、
そのユーザーが表示され、フォローが可能です。
（yarn で参照していなかったアカウントの場合はほぼ非表示になりますが、
　フォローすると twtxt の情報を読み込んでまともに表示されるようになります）

実際に使用したところ、一部のアカウント（コメントにアカウント情報を入れていない）で
ドメイン・handle の判別でのアカウント分類ができないために、
何かフォローすると他のアカウントを解除してしまうケースがある事を確認しています。
また一部のドメインでフォローができないケースがある事を確認しています。

投稿には Reply と Yarn が存在します。使い分けは次のとおりです。

なお yarn.girlonthemoon.xyz は管理者が twtxt を数ヶ月使わない状態になり、
twtxt の新仕様反映が遅れる事による不具合を起こす場合がありました。
ページ運営者は当初 yarn を使っていましたが、この問題が一因となって、
開発が進んでいた  twtd と  twtxt.app へアカウントを変更しています。

🌐 twtxt.net

同じシステムを使用している twtxt.net も存在するのですが、
こちらは現在新規登録がほぼ困難になっています。

インストール

 “pkg_resources is deprecated” ugly message when run the twtxt #194 | GitHub buckket/twtxt issues

オリジナルの twtxt をおすすめしたいところですが、
実は 2026年2月 より pkg_resources が削除された影響で、
そのままインストールすると動作できない事をページ運営者が確認できています。

 twtxt | PyPI

twtxt のインストールには Python が必要です。pip を用いてインストールします。
もしインストールしてエラーに遭遇している場合は一旦 twtxt をアンインストールします。

pip uninstall twtxt

pkg_resources が含まれていた setuptools にして、twtxt をインストールします。
これで警告は出ていますが、動作は可能です。

pip install "setuptools<=80.10.2"
pip install twtxt

ただし、毎回警告表示が数行表示されるようになってしまい、
140 文字制限などもあり、使いにくさがあります。

同じ仕様の異なるプログラミング言語で作られた
クライアントがいくつか存在していますので、
現在はこれらの派生アプリケーションを使った方が良いでしょう。

 batyshkaLenin / twtxt-cli | GitHub

なぜか twtxt-cli はインストールの記載がありませんが、npm でインストールできます。

npm i -g twtxt-cli

これで twtxt-cli コマンドが使えるようになります。

 win0err / twtwt | GitHub

twtwt はバイナリーが公開されていませんが、README にビルド方法が明記されています。
twtwt コマンドが使えるようになります。

オリジナルは twtxt コマンドです。
以下 twtxt で記載しているので、置き換えて使用して下さい。
また、クライアントによってコマンドが異なる場合があります。

とりあえずはじめてみる

まずは初期化します。

twtxt quickstart

twtwt はオプションなしの初期起動で同じ動作になります。

クライアントにより、他にも入力する項目が発生する事があります。
入力した内容も含めてテキストファイルに含まれます。
この段階でテキストファイルが生成されます。
そしてこの段階ではすでにアップロード先の URL も
確定しておかないといけない、という事になります。

それでは初投稿してみましょう。

twtxt tweet "こんにちは！"

テキストファイルが更新されたはずです。このファイルをアップロードして公開します。
クライアントによっては投稿前後でコマンドを実行できるようになっているので、
自動的にアップロードを行うようにできます。

オリジナルの twtxt は 140 文字制限になっています。140 文字を超えると警告表示になり、
実際のタイムラインでも 140 文字を超えていると [...] が語尾に付いて省略されます。
しかし、この制限の意味はなく（以前の Twitter 仕様を継承しただけと思われます）
派生アプリケーションではこの制限がないケースが多いようです。

Twitter 時代は文字数制限の考慮で短縮 URL が使われていましたは、
yarn などの Web アプリでは画像・動画を展開表示するため、その辺の利便性を考えると
URL は短縮 URL を経由せずに直接入れてしまっても良いでしょう。

twtxt tweet "@<balloon-fu-sen https://tw.fus.f5.si/twtxt.txt> こんにちは！"

返信はこんな感じに @<ハンドル URL> としますが、
アカウントがクライアントでフォローされているか、
yarn などのサービスでは誰かがフォローして
サーバーからテキストが参照されている必要があります。
yarn・twtxt.net では別の返信方法が使われていて、元の投稿がわかる仕組みになっています。

ページ運営者へは yarn アカウント balloon-fu-sen へ ＠ して下さい。
yarn アカウント同士なら把握できます。
そうでなければ、予めフォローされている必要があるでしょう。
クライアントによってはフォローした時に通知を行うので、それで気がつくのですが、
 レジストリ に登録する等で、アカウントの存在を広めて下さい。

twtxt follow fu-sen https://fu-sen.oldcities.org/twtxt.txt

フォローはこのようにします。表示するニックネームと公開されている URL です。

twtxt following

フォローしている人の一覧はこのようにします。
クライアントによってはテキストファイルにフォローしているアカウントを記載します。

twtxt timetine

これでフォローしたアカウントのタイムラインを表示します。
各 URL を参照し、日付順に並べ替えて表示するので、少し時間を要します。

twtxt ファイル

通常 twtxt.txt になっている事が多いですが、定まっているファイル名ではなく、
次に多いのは tw.txt です。テキストファイルなので、直接テキストエディターで編集できます。

仕様上文字コードは UTF-8 と定まっています。
したがって日本語・Unicode 絵文字も使用できます。
改行コードは LF なので、Windows を使用している場合はご注意下さい。

行頭 # で始まる行はコメントです。
ここにクライアントがアカウント情報を加え、この情報を使用します。

このコメントが全くない状態でも使用できるのですが、
yarn は nick = とドメイン名をアカウントの判別対象にしていますし、
avatar = の画像もタイムラインに表示するようにしているので、
できるだけ項目を入れておいた方が良いでしょう。
follow は非公開でも問題ありません。

投稿は 日時(タブ)投稿内容(LF) となります。あとはこれが並ぶだけです。
新しい投稿を下に追加するクライアントが多いですが、
上に追加しているテキストも見られるので、定まっていないと思って下さい。

日時は RFC 3339 です。日本標準時だと 2026-06-30T12:34:56+09:00 という感じです。

レジストリ・リスト

twtxt の問題として、twtxt を行っている人を見つけにくい、というのがあります。
それを解消するために、twtxt の URL を収集・一覧しているところが存在します。

 https://registry.twtxt.org/api/plain/users
 https://twtxt.envs.net/api/plain/users

こちらはリポジトリですぐに登録して一覧に追加する事ができます。

curl -X POST 'https://registry.twtxt.org/api/plain/users?url=https://ドメイン名/twtxt.txt&nickname=名前'

curl -X POST 'https://twtxt.envs.net/api/plain/users?url=https://ドメイン名/twtxt.txt&nickname=名前'

ページ運営者の twtxt も上のリポジトリに登録してあります。

 DracoBlue / twtxt-registry | GitHub
 getwtxt - twtxt Registry

リポジトリは API が公開されていて、いろいろと操作可能です。

🎈 https://balloon.oldcities.org/twtxt-active-users.txt
🎈 https://gist.github.com/fu-sen/d5850332019758384d85ec96f096ade4

ページ運営者が様々な場所から収集して、
おおよそ 1 年位の間に投稿しているアカウントをまとめていますが、
100 アカウントもありません。
それだけ仲間を集められずにいつしか投稿も忘れてしまうのが現況のようです。

検索

 レジストリ・リスト にも検索機能が備わっていますが、
専門の検索エンジンも存在します。

 Twtxt Search

Add feed… から公開している twtxt テキストファイルの URL を入れる事で、
自分の twtxt を検索対象にする事もできますが、
誰かとお話している状況であれば、自動的にクローラーが追加する可能性もあるようです。

Q&A

日本語で使用している人はいますか？

少なくても日本の曲を投稿しているのは確認できています。
日本のブログで twtxt をまとめている記事は見かけるのですが、
実際に使用して公開しているのは確認できていません。
おそらくフォロー先を探すのが難しく、twtxt の仕組みだけをまとめて、
実際に使ってみる状況まで至らなかった記事が多い感じがします。

ページ運営者が行ってますので、はじめた方はご連絡下さい。
日本語利用者が増えてきたら、個別にリスト化するかもしれません。

なお、2026年6月現在、ページ運営者がはじめた段階で
どうやら唯一の日本語メインなアカウントになっているようです。
英語と併用して中国語で投稿するアカウントは確認できています。

誰がフォローしているか確認したり、返信する方法はありますか？……

現在のおすすめは  twtxt.app を使用する事です。
twtxt.app を使用する事で、他の SNS みたいにタイムラインを表示でき、
フォローされた場合の表示なども行う事ができます。
GitHub など Git リポジトリを使用する場合はこれを指定する事ができます。
VPS を使用する場合は twtd をインストールして使用可能です。

他にも CLI レベルで返信をサポートしているアプリもあるようです。

古いパソコンとかからでも使用できますか？

UTF-8 のテキストファイルが生成できるのであれば、日本語で作成でき、
FTP が使えるレンタルサーバーであれば（暗号化されていませんが）公開もできます。
Windows 9● や Windows CE・Android 初期の頃は Unicode 絵文字が定まっていません。
Windows 95 以前になってくると、UTF-8 が非対応なので、英語使用前提になっています。
クライアントは C 言語であればビルドして使えるかもしれません。
または http: で使用できる Web アプリのクライアントができれば使えるでしょう。

クライアントをいくつか見てみましたが、いずれも最新コミットが数年前なのですが……

twtxt の仕組みがシンプルで、timeline であれば、
URL からテキストを読み込んで、並べ替えて表示しているだけになります。
quickstart はファイルを生成し、フォローはリストに加えてるだけです。
テキストベースであれば、一通りの機能が整えばコミットする必要がないので、
それで数年コミットが発生していない状態になっていると思われます。

ただし、オリジナルの twtxt みたいに、年数の経過で構成しているライブラリがなくなり、
使用できなくなっているクライアントは他にも存在している可能性があります、
ソースレベルで最近更新が入っているクライアントを選択しておくと良いでしょう。

GitHub リポジトリや GitHub Gist で公開しても良いのですか？

GitHub リポジトリ・GitHub Gist 共に raw でオリジナルのテキストファイルを表示できるので、
raw の表示を正式な公開 URL という形にして可能です。
実際 GirHub リポジトリで twtxt を行っている人がいます。

GitHub リポジトリの場合、GitHub Pages を用いても良いのですが、
ソースの raw にしてしまう方法もあります。

ポート番号の異なる URL があります。プロキシ経由になっているようですが？

これは http: (:80) ・ https: (:443) ではないプロトコルで公開されていて、
プロキシサービス経由にしています。
以下、いずれも WWW の代わりになるインターネットプロトコルになります。

:70（gopher:）と :1965 (gemini:) は利用者が比較的多いので、
そちらで公開されているケースをいくつか確認できています。
:1900 (nex:) の nightfall.city/shore も twtxt をしている住民が数名いました。

 SmolNet Portal

現在プロキシは SmolNet Portal がおすすめです。（下リンク等の (https: 変換) で使用しています）
変換する URL（gemini: など）を入れて表示された際の https: の URL をそのまま使用できます。
上記のプロトコルに対応し、bot 対策も行われていますが、問題なく使用できるようです。

🚀 🎈 fusen.srht.site (gemini:) - (https: 変換)
🎈 fusen.nya.je

各プロトコルについては fusen.srht.site で簡単に、fusen.nya.je では詳細に紹介しています。
fusen.nya.je はその表示しているプロトコル別になっています。