---
visibility: public
---

# ATProto

**repo:** [atblueprints/awesome-atproto](https://github.com/atblueprints/awesome-atproto)  
**category:** [[decentralized-systems|Decentralized Systems]]
**related:** [[mastodon|Mastodon]]

---

[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
</div>

# Awesome ATProto 

> [AT Protocol](https://atproto.com/) is a federated protocol for building social applications on an open, decentralized network

## Contents

* [AT Protocol](#at-protocol)
    * [References](#references)
    * [Articles](#articles)
* [Browsers](#browsers)
* [Platforms](#platforms)
    * [Bluesky](#bluesky)
* [Tools](#tools)
* [Lexicons](#lexicons)

## AT Protocol

### References

* [Glossary](https://atproto.com/guides/glossary) - Quick reference to AT Protocol terms.
* [Lexicons, Pinned Posts, and Interoperability](https://docs.bsky.app/blog/pinned-posts) - Post-mortem about the evolution of lexicons and lessons learned.
* [Quick start guide to building applications on AT Protocol](https://atproto.com/guides/applications) - Guide to create a basic ATProto application.

### Articles

* [First impressions of Bluesky's AT Protocol](https://educatedguesswork.org/posts/atproto-firstlook/) - In-depth analysis of Bluesky's ATProto, highlighting its aim to create a decentralized social media architecture.
* [Nostr and ATProto](https://shreyanjain.net/2024/07/05/nostr-and-atproto.html) - Comparison of Nostr and ATProto, two decentralized social media protocols, exploring their origins, similarities, and differences.
* [How decentralized is Bluesky really?](https://dustycloud.org/blog/how-decentralized-is-bluesky/) - Critical examination of Bluesky's decentralization claims and its architectural challenges compared to established protocols.
* [Reply on Bluesky and Decentralization](https://whtwnd.com/bnewbold.net/3lbvbtqrg5t2t) - Reply to Christine Lemmer-Webber's thoughtful (and widely read) "How decentralized is Bluesky really?" blog post.
* [What is atproto.com good for?](https://bnewbold.net/2022/atproto_thoughts/) - Technical exploration of ATProto's [design principles](/@harrisonqian/awesome/wiki/miscellaneous/design-principles), architectural challenges, and potential limitations as a decentralized social media protocol.
* [The AT Protocol Architecture](https://hackernoon.com/the-at-protocol-architecture) - Analysis of the ATProto's architecture.
* [Notes on Running a Full-Network atproto [Relay](/@harrisonqian/awesome/wiki/front-end-development/relay) (July 2024)](https://whtwnd.com/bnewbold.net/entries/Notes%20on%20Running%20a%20Full-Network%20atproto%20Relay%20(July%202024)) - Experience about running an ATProto [relay](/@harrisonqian/awesome/wiki/front-end-development/relay).

## Browsers

* [PDSls](https://pdsls.dev/) - ATProto repositories browser.
* [ATProto Browser](https://atproto-browser.vercel.app/) - ATProto URIs browser.

## Platforms

* [Bluesky](https://bsky.social) - The beloved social network and main ATProto platform.
* [Blue Place](https://place.blue/) - Massive real-time collaborative [canvas](/@harrisonqian/awesome/wiki/front-end-development/canvas).
* [Bookhive](https://bookhive.buzz/) - Goodreads alternative.
* [Frontpage](https://frontpage.fyi/) - Federated link aggregator.
* [GrayHaze](https://grayhaze.live/about) - Live [streaming](/@harrisonqian/awesome/wiki/big-data/streaming) service (alpha).
* [Linkat](https://linkat.blue/) - Link in bio for Bluesky.
* [Pastesphere](https://pastesphere.link/) - Pastebin alternative.
* [Picosky](https://psky.social/) - ATProto chatting appview.
* [PinkSea](https://pinksea.art/) - Oekaki BBS.
* [recipe.exchange](https://recipe.exchange/) - Cooking recipes sharing.
* [Skylights](https://skylights.my/) - Book reviews.
* [Smoke Signal](https://smokesignal.events/) - Event creation and managing.
* [Sparta Social](https://github.com/dblock/sparta-social) - Exercise activity tracker (wip).
* [Whitewind](https://whtwnd.com/) - [Markdown](/@harrisonqian/awesome/wiki/miscellaneous/markdown) blog service using ATProto with no registration required.

### Bluesky

* [ClearSky](https://clearsky.app/) - Tool to explore Bluesky accounts.
* [cleanfollow](https://cleanfollow-bsky.pages.dev/) - Select inactive or blocked accounts to unfollow.
* [Handles directory](https://blue.mackuba.eu/directory/) - Handles ranking by TLDs.
* [Labellers](https://blue.mackuba.eu/labellers/) - List of known labellers.
* [BluSki account history](https://mocku.me/nt/#%23+BluSki+account+history//%23%23+Whose+history%3F//Let's+pick+a+rando+hot+poster+from+Discovery+feed+--//%60%60%60JavaScript/%2F%2F+downloading+Discovery+feed+posts/let+discoveryFeedPosts+=+(await+fetch(/++'https:%2F%2Fapi.bsky.app%2Fxrpc%2Fapp.bsky.feed.getFeed%3Ffeed=at:%2F%2Fdid:plc:z72i7hdynmk6r22z27h6tvur%2Fapp.bsky.feed.generator%2Fwhats-hot%26limit=100',/++%7B+headers:+%7B+'accept-language':+'en'+%7D+%7D).then(x+=%3E+x.[json](/@harrisonqian/awesome/wiki/miscellaneous/json)())).feed;//%2F%2F+sort+by+likes/let+topTextPost+=+discoveryFeedPosts/++.filter(p+=%3E+p.post.record.text+%26%26+!p.post.record.embed)/++.sort((p1,+p2)+=%3E+p2.post.likeCount+-+p1.post.likeCount)%5B0%5D;//%2F%2F+let's+see+all+the+info+now/let+hotAuthor+=+%7B/++...topTextPost.post.author,/++post:+%7B+...topTextPost.post,+...topTextPost.post.record,+post:+undefined,+record:+undefined,+author:+undefined+%7D/%7D;/%60%60%60//If+you're+after+specifc+handle,+specify+it+now.//%60%60%60JavaScript/let+bskyHandle+=+%2F%2F+'oyin.bo';+++++++%2F%2F++%3C--+like+this/++hotAuthor.handle;+//let+resolvedAccount+=++await+fetch(/++'https:%2F%2Fpublic.api.bsky.app%2Fxrpc%2Fapp.bsky.actor.getProfile%3Factor='+%2B+bskyHandle).then(x=%3Ex.json())/%60%60%60//%23%23+Finding+PDS+for+that+account//PDS,+personal+data+server+physically+stores+account's+data.+Usually+it's+one+of+a+couple+dozens+BluSki+servers+in+the+cloud.//By+tradition+they+get+Latin+mushroom+names.//Accounts+sometimes+shift+from+one+mushroom+to+another,+so+we+find+the+latest+most+actual+PDS.//%60%60%60JavaScript/let+plcEntries+=+await+fetch(%60https:%2F%2Fplc.directory%2F$%7BresolvedAccount.did%7D%2Flog%2Faudit%60).then(x+=%3E+x.json());+%2F%2F+full+account+registry/let+lastKnownPds+=+plcEntries.slice().reverse().map(x=%3Ex.operation%3F.services%3F.atproto_pds%3F.endpoint).filter(Boolean)%5B0%5D;+%2F%2F+last+PDS+operation+record/%60%60%60//%23%23+Downloading+the+history+in+CAR%2FCBOR+format//Account+history+is+a+public+service,+because+it's+used+in+distributing+BluSki+data+across+the+network.+The+file+can+be+anything+between+1-50Mb+depending+on+shitposting+power.//The+binary+CAR%2FCBOR+format+saves+storage+and+bandwith,+and+has+extra+funky+cryptographic+signatures+(of+which+no+normal+person+cares).//%60%60%60JavaScript/let+binarySnapshot+=+await+fetch(lastKnownPds+%2B+'%2Fxrpc%2Fcom.atproto.sync.getRepo%3Fdid='+%2B+resolvedAccount.did).then(x+=%3E+x.arrayBuffer());/binarySnapshot.byteLength.toLocaleString()/%60%60%60//%23%23+Extracting+useful+data+from+CAR%2FCBOR//There+are+libraries+for+that+in+every+programming+language.+Just+invoke+and+it'll+come.//%60%60%60JavaScript/import+%7B+readCAR+%7D+from+'https:%2F%2Funpkg.com%2Fcoldsky';/let+parsedRecords+=+await+readCAR(resolvedAccount.did,+binarySnapshot,+%7B+sleep:+600+%7D)/%60%60%60//%23+Finally,+useful+info!//Having+this+rich+history+of+shitposts,+replies,+likes+and+more,+we+are+ready+to+look+at+actual+stats.//%23%23+What+kind+of+activity+dominates%3F//%60%60%60SQL/SELECT+%5B$type%5D,+COUNT(*)/FROM+$4+GROUP+BY+%5B$type%5D/ORDER+BY+COUNT(*)+DESC/%60%60%60//%23%23+5+days+of+heaviest+shitpost//%60%60%60SQL/SELECT+TOP+5+createdAt-%3Esplit('T')-%3E%5B0%5D+as+date,+COUNT(*)/FROM+$4/++WHERE+%5B$type%5D+=+%22app.bsky.feed.post%22/++GROUP+BY+createdAt-%3Esplit('T')-%3E%5B0%5D/ORDER+BY+COUNT(*)+DESC/%60%60%60//%23%23+5+days+of+love:+more+likes+gifted+to+others//%60%60%60SQL/SELECT+TOP+5+createdAt-%3Esplit('T')-%3E%5B0%5D+as+date,+COUNT(*)/FROM+$4/++WHERE+%5B$type%5D+=+%22app.bsky.feed.like%22/++GROUP+BY+createdAt-%3Esplit('T')-%3E%5B0%5D/ORDER+BY+COUNT(*)+DESC/%60%60%60//%23%23+10+favourite+accounts//%60%60%60SQL/SELECT+TOP+10+subject-%3Euri-%3Esplit('at:%2F%2F')-%3E%5B1%5D-%3Esplit('%2F')-%3E%5B0%5D+as+did,+COUNT(*)+AS+likes/FROM+$4/++WHERE+%5B$type%5D+=+%22app.bsky.feed.like%22/++GROUP+BY+subject-%3Euri-%3Esplit('at:%2F%2F')-%3E%5B1%5D-%3Esplit('%2F')-%3E%5B0%5D/ORDER+BY+COUNT(*)+DESC/%60%60%60//%23%23+Who+are+these+people%3F//Account+history+file+refers+to+other+accounts+with+hexadecimal+DID,+which+as+you+see+above+isn't+that+readable.//No+sweat,+BluSki+has+a+service+to+resolve+DID+to+account+name%2Fhandle%2Finfo.+Here+you+go.//%60%60%60JavaScript/Promise.all($8.map(async+entry+=%3E+%7B/++const+profile+=+await+fetch('https:%2F%2Fpublic.api.bsky.app%2Fxrpc%2Fapp.bsky.actor.getProfile%3Factor='+%2B+entry.did).then(x+=%3E+x.json());/++return+%7B/++++did:+profile.did,+handle:+profile.handle,+displayName:+profile.displayName,/++++likesCount:+entry.likes,/++++postsCount:+profile.postsCount,/++++...profile/++%7D;/%7D))/%60%60%60//%23%23+10+accounts+getting+most+reply+traffic//%60%60%60SQL/SELECT+TOP+10+reply-%3Eparent-%3Euri-%3Esplit('at:%2F%2F')-%3E%5B1%5D-%3Esplit('%2F')-%3E%5B0%5D+as+did,+COUNT(*)+AS+replies/FROM+$4/++WHERE+%5B$type%5D+=+%22app.bsky.feed.post%22+AND+reply+AND+reply-%3Eparent-%3Euri/++GROUP+BY+reply-%3Eparent-%3Euri-%3Esplit('at:%2F%2F')-%3E%5B1%5D-%3Esplit('%2F')-%3E%5B0%5D/ORDER+BY+COUNT(*)+DESC+/%60%60%60//And+again,+with+names+and+extra.//%60%60%60JavaScript/Promise.all($10.map(async+entry+=%3E+%7B/++const+profile+=+await+fetch('https:%2F%2Fpublic.api.bsky.app%2Fxrpc%2Fapp.bsky.actor.getProfile%3Factor='+%2B+entry.did).then(x+=%3E+x.json());/++return+%7B/++++did:+profile.did,+handle:+profile.handle,+displayName:+profile.displayName,/++++repliesCount:+entry.replies,/++++postsCount:+profile.postsCount,/++++...profile/++%7D;/%7D))/%60%60%60//) - Editable notebook to analyze a Bluesky account.
* [Starter Packs](https://www.starterpacks.net/) - Search Bluesky starter packs and profiles.
* [PDS self-hosting](https://atproto.com/guides/self-hosting) - Self-hosting a Bluesky PDS means running your own Personal Data Server that is capable of federating with the wider ATProto network.
* [Bluesky-powered comments for any website](https://github.com/czue/bluesky-comments) - Embed Bluesky comments on your website easily ([announcement](https://www.coryzue.com/writing/bluesky-comments/)).

For more Bluesky tools, check [Awesome Bluesky](https://github.com/notjuliet/awesome-bluesky), a more exhaustive list of tools and clients available for Bluesky.

## Tools

* [ATFile](https://github.com/ziodotsh/atfile) - Store and retrieve files on the ATmosphere.

## Lexicons

Lexicon is a schema definition language used to describe atproto records, HTTP endpoints (XRPC), and event stream messages.

Find below each platform's lexicons:

* [ATFile](https://github.com/ziodotsh/lexicons/tree/main/blue/zio/atfile)
* [Bluemoji](https://github.com/aendra-rininsland/bluemoji/tree/main/schema/blue.moji)
* [Bluesky](https://github.com/bluesky-social/atproto/tree/main/lexicons/app/bsky)
* [Bookhive](https://github.com/nperez0111/bookhive/tree/main/lexicons)
* [Frontage](https://github.com/likeandscribe/frontpage/tree/main/lexicons/fyi/unravel/frontpage)
* [GrayHaze](https://github.com/hugeblank/grayhaze.live/tree/main/lexicons/live/grayhaze)
* [Linkat](https://github.com/mkizka/linkat/tree/main/lexicons/blue/linkat)
* [Pastesphere](https://github.com/echo8/pastesphere/tree/main/lexicons)
* [Picosky](https://github.com/psky-atp/appview/tree/main/lexicons/social/psky)
* [PinkSea](https://github.com/shinolabs/PinkSea/tree/master/PinkSea.Lexicons/com/shinolabs/pinksea)
* [place.blue](https://github.com/QuietImCoding/place.blue/tree/main/atproto/lexicons)
* [recipe.exchange](https://recipe.exchange/lexicons/)
* [Skylights](https://github.com/Gregoor/skylights/tree/main/web/lexicons)
* [Skymdb](https://github.com/safwanyp/skymdb/tree/main/domain/lexicons)
* [Smoke Signal](https://github.com/SmokeSignal-Events/lexicon)
* [Sparta Social](https://github.com/dblock/sparta-social/tree/main/lexicons)
* [Whitewind](https://github.com/whtwnd/whitewind-blog/tree/main/lexicons/com/whtwnd/blog) 

## Contributing

Contributions welcome! Read the [contribution guidelines](contributing.md) first.
