a Bluesky client for PICO-8 picosky.vinnymac.dev
pico-8 simulation bluesky games
19

Configure Feed

Select the types of activity you want to include in your feed.

HTML 40.7%
Lua 39.1%
JavaScript 18.0%
Makefile 1.8%
Other 0.3%
9 1 0

Clone this repository

https://tangled.org/vinnymac.dev/picosky https://tangled.org/did:plc:bdmfsfujnsqnqvjm4u7sjzny
git@knot.vinnymac.dev:vinnymac.dev/picosky git@knot.vinnymac.dev:did:plc:bdmfsfujnsqnqvjm4u7sjzny

For self-hosted knots, clone URLs may differ based on your setup.



README.md

picosky#

A Bluesky (AT Protocol) client that runs as a PICO-8 cart in your browser - browse, post, and like, all in 128×128.

Roadmap#

  • Auth, Feed and Thread view
  • Demo Cart
  • Demoscene credits
  • Sfx, Music, and Change Track
  • Like / Unlike and Refresh
  • Post and Reply
  • Avatars, Images, alt text
  • Multiple Feeds
  • Quote and Repost
  • Animations
  • Alpha Testing
  • Touch/Tap/Swipe mobile support

Project Structure#

├── src/                  PICO-8 Lua source modules
├── picosky.js            web export - online mode (requires auth)
├── picosky-demo.js       web export - demo mode (no auth needed)
├── picosky.p8            standalone demo cart
├── picosky-comms.js      GPIO bridge: JS ↔ PICO-8
├── picosky-firehose.js   AT Protocol firehose client
├── picosky-shim.js       cart ↔ AT Protocol adapter
├── crt.js                CRT shader overlay
├── index.html            web player + OAuth gate
├── sw.js                 service worker (PWA offline)
├── manifest.webmanifest
├── client-metadata.json  AT Protocol OAuth metadata
├── m3x6.lua              m3x6 bitmap font (embedded in cart)
├── vendor/               third-party code (CRT shader)
├── favicons/             app icons
└── fonts/                PICO-8 bitmap font

src/#

File Purpose
cart.p8 master cart - sprites, map, sound, music
actions.lua Bluesky actions (post, like, repost)
comms.lua GPIO protocol implementation
demo.lua demo mode with mock feed
input.lua keyboard and button input
render.lua screen rendering
state.lua app state management

Credits#

picosky made by vinnymac

Special thanks to: