Cached at:
05/16/26, 06:41 PM
# rocksky.app/rocksky
Source: [https://tangled.org/rocksky.app/rocksky](https://tangled.org/rocksky.app/rocksky)
### Configure Feed
IssuesPull RequestsCommitsTags
Select the types of activity you want to include in your feed\.
A decentralized music tracking and discovery platform built on AT Protocol 🎵[rocksky\.app](https://rocksky.app/)
spotifyatprotolastfmmusicbrainzscrobblinglistenbrainz
### Configure Feed
IssuesPull RequestsCommitsTags
Select the types of activity you want to include in your feed\.
[1721](https://tangled.org/rocksky.app/rocksky/commits/main)[14](https://tangled.org/rocksky.app/rocksky/branches)[0](https://tangled.org/rocksky.app/rocksky/tags)### Clone this repository
Use permalink
HTTPS
https://tangled\.org/rocksky\.app/rockskyhttps://tangled\.org/did:plc:cbczwmvvz7juuu3orgf6mlc4
SSH
git@tangled\.org:rocksky\.app/rockskygit@tangled\.org:did:plc:cbczwmvvz7juuu3orgf6mlc4
For self\-hosted knots, clone URLs may differ based on your setup\.
[Download tar\.gz](https://tangled.org/rocksky.app/rocksky/archive/main)
[commits1721](https://tangled.org/rocksky.app/rocksky/commits/main)
This covers the major threads: the full Search screen rewrite \(correct endpoint, flat hits shape, Feather icon\), MiniPlayer with Rockbox WebSocket controls and playback lock, app icon replaced with the Rocksky favicon, and sign\-in copy aligned with web/web\-mobile \(Handle label, atproto signup text, selfhosted\.social OAuth flow\)\.
[](https://github.com/tsirysndr/rocksky/actions/workflows/ci.yml)[](https://discord.gg/EVcBy2fVa3)
A decentralized music tracking and discovery platform built on AT Protocol 🎵 , see[Rocksky](https://rocksky.app/)\.
[](https://pocketenv.io/new?repo=tangled:rocksky.app/rocksky)

## ✨ Features[\#](https://tangled.org/rocksky.app/rocksky#-features)
### 🎵 Scrobbling APIs[\#](https://tangled.org/rocksky.app/rocksky#-scrobbling-apis)
- **Last\.fm Compatible API**– drop\-in replacement for Last\.fm scrobblers
- **ListenBrainz Compatible API**– works with clients that support ListenBrainz
### 🕒 Playback & History[\#](https://tangled.org/rocksky.app/rocksky#-playback--history)
- **Recently Played Timeline**– browse your listening history
- **Stories View**– see what other users are playing in real time
- **Stats**– visualize scrobbles per day
### 📊 User Insights[\#](https://tangled.org/rocksky.app/rocksky#-user-insights)
- **Top Artists, Tracks, and Albums**– personalized charts of your listening habits
- **Shoutbox & Likes**– interact with other listeners and share reactions
### 🌐 Client Integrations[\#](https://tangled.org/rocksky.app/rocksky#-client-integrations)
- **Spotify**– detect now playing tracks and scrobble directly from Spotify
- **Jellyfin**– track plays from your media server
- **Pano Scrobbler**– Android/Linux/Windows support
- **WebScrobbler**– scrobble directly from your browser
### 🔍 Search[\#](https://tangled.org/rocksky.app/rocksky#-search)
- **Search Engine**– fast search powered by MeiliSearch
## 🚧 Coming Soon / Roadmap[\#](https://tangled.org/rocksky.app/rocksky#-coming-soon--roadmap)
- **Webhooks**\- subscribe to scrobble events and integrate with Discord or your own apps
- **Personalized Feeds**– discover music through community\-driven feed algorithms
- **Last\.fm → Rocksky**Mirroring \(Future Scrobbles\) – automatically mirror new scrobbles from Last\.fm into Rocksky
- **Rocksky Connect**– remote playback across devices \(similar to Spotify Connect\)
- **Multi\-Source Libraries**– browse and scrobble from Google Drive, Dropbox, S3, FTP, and more
- **Stream & Scrobble Your Own Music**– upload your library and play directly on Rocksky
- **Extensions**– customize and extend Rocksky with your own logic
- **Crossfade & Equalizer Settings Sync**– carry your playback preferences across devices
## 📦 Prerequisites[\#](https://tangled.org/rocksky.app/rocksky#-prerequisites)
- Node\.js \(v22 or later\)
- Deno
- Rust
- Go
- Turbo
- Docker
- Wasm Pack[https://github\.com/drager/wasm\-pack](https://github.com/drager/wasm-pack)
- DuckDB[https://duckdb\.org/docs/installation](https://duckdb.org/docs/installation)`1\.2\.0`
- Spotify`SPOTIFY\_CLIENT\_ID`and`SPOTIFY\_CLIENT\_SECRET`from setup in[Spotify developer dashboard](https://developer.spotify.com/documentation/web-api/tutorials/getting-started)
## 🚀 Getting Started[\#](https://tangled.org/rocksky.app/rocksky#-getting-started)
1. Clone the repository: ``` git clone
[email protected]:rocksky.app/rocksky cd rocksky ```
2. Install dependencies: ``` npm install -g turbo bun install bun run build:raichu ```
3. Set up the environment variables: ``` cp apps/api/.env.example apps/api/.env cp apps/web/.env.example apps/web/.env cp apps/feeds/.env.example apps/feeds/.env cp .env.example .env # Edit the .env files to add your configurations ```
4. Start the Docker containers: ``` docker compose up ```
5. Run the database migrations: ``` turbo db:migrate --filter=@rocksky/api ```
6. Setup Spotify App: ``` # don't forget to set SPOTIFY_ENCRYPTION_KEY and SPOTIFY_ENCRYPTION_IV environment variables bun run spotify <client_id> <client_secret> ```
7. Populate database \(Optional\): ``` bun run db:pgpull ```
8. Start Analytics API: ``` bun run dev:analytics ```
9. Start jetstream: ``` bun run dev:jetstream ```
10. Start musicbrainz:
```
bun run mb
```
1. Start feeds:
```
bun run feeds
```
1. Start the development server:
```
turbo dev --filter=@rocksky/api --filter=@rocksky/web
```
## 📚 Documentation[\#](https://tangled.org/rocksky.app/rocksky#-documentation)
[View the full documentation](https://docs.rocksky.app/)
## ✍️ Feedback[\#](https://tangled.org/rocksky.app/rocksky#-feedback)
This repository is the central place to collect feedback and issues related to[Rocksky](https://rocksky.app/)\.
Please[**open an issue**](https://tangled.org/@rocksky.app/rocksky/issues/new)if you want to leave feedback\. Feel free to also join our[**Discord server**](https://discord.gg/EVcBy2fVa3)
## 🤝 Contributing[\#](https://tangled.org/rocksky.app/rocksky#-contributing)
We would love to hear your feedback or suggestions\. The best way to reach us is on[Discord](https://discord.gg/EVcBy2fVa3)\.
We also welcome pull requests into this repo\. See[CONTRIBUTING\.md](https://tangled.org/rocksky.app/rocksky/tree/main/CONTRIBUTING.md)for information on setting up this repo locally\.