Yarn.social

Yarn.social is a decentralized self-hosted social media that has a privacy-first focus.

There are no ads, no tracking and no personal information is ever collected or stored.

Getting Started

🤗 Join an existing Pod

You are welcome to join one of the existing pods listed here:

twtxt.net The first Yarn.social pod launched 20 July 2020 Hosted in AU by @prologic
twt.nfld.uk A Yarn.social pod Hosted in the UK by @jlj
we.loveprivacy.club A Yarn.social pod Hosted in AU by @eldersnake

📱 Mobile App

There is a native Mobile App for Yarn.social pods available called “Goryton for Twt” available on both Apple App and Google Play stores.

See Goryon for details

🧶 Run a Pod

If you have Docker installed and available to run containers you can run a yarnd instance by simply running:

$ docker run -p 8000:8000 prologic/yarnd

Otherwise it is recommended to clone the source code and build yarnd from source. Be sure to have Go installed.

$ git clone https://git.mills.io/yarnsocial/yarn
$ cd yarn
$ make deps
$ make

Now run your instance by running:

yarnd

For options see yarnd --help.

💪 Manually

Since Yarn.social is built upon the Twtxt spec with a few small extensions, all you need to do to join the network and participate in the growing number of users and conversations is have:

A twtxt.txt file hosted somewhere
A avatar.png hosted next to your twtxt.txt
A twtxt client such as:
- jenny: A console twtxt client with mutt integration (tutorial)

🌐 Hosting

Coming soon™

Services

The following supporting services help to support the Yarn.social platform and are provided for the benefit of all users:

search.twtxt.net This is an instance of the Yarns search engine and crawls and indexes Yarn.social pods and Twtxt feeds.
feeds.twtxt.net This is an instance of rss2twtxt and is used as the primary “feed source” for all Yarn.social pods (by default) and supports RSS/Atom and Twitter™. This allows users to “subscribe” to and “follow” websites, blogs or Twitter™ accounts.

💾 Sources

The project is managed by a self-hosted Gitea instance at https://git.mills.io/yarnsocial

yarn 📕 The yarnd self-hosted Yarn.social Pod server itself as well as the yarnc command-line client for posting and interacting with the pod’s API.
yarns 🔍 The Yarn.social search engine that crawls the network of pods and twtxt feeds, scrapes and indexes every post.
rss2twtxt 📜 an RSS/Atom and Twitter feed aggregator that consumes RSS/Atom and Twitter™ feeds and produces twtxt feeds for consumption by Yarn.social pods as well as twtxt clients in general.
Goryon 🐦 A Flutter iOS and Android App for the Yarn.social yarnd API to provide a native mobile experience for users.

Contributing

If you would like to help the project and contribute ideas, bug-fixes, improvements, etc, we’re always looking for new contributors and we still have loads of things to do!

Please reach out to @prologic or join our Gitea instance at https://git.mills.io/ and start filing issues and pull requests to the main project https://git.mills.io/yarnsocial/yarn

Collaboration

We have an IRC channel #yarn.social on the Libera.Chat IRC network. You are welcome to come chat to us and hang out.

Privacy and Abuse Policy

Yarn.social is a decentralised social media platform that supports micro-blogging (Twts) and full blogging. Pods (or individual instances) are owned and operators by “Pod Owners” or “Pod Operators”. Pods can either be configured as single-user or multi-user (the default).

As such all Yarn.social pods share the following defaults Abuse and Privacy policies:

Note: The privacy policy applies to ALL Yarn.social pods as the software yarnd DOES NOT collect any personali identifable information from users (PII), or any metadata or analytics of any kind nor does it send, sell or transfer any data from pods to any 3rd-parties.

Licenses

Most of the software components here are licensed under the terms of the MIT License with the exception of the hosting platform.