Introduction to SeedSphere 2.0

SeedSphere is a federated media discovery protocol. Unlike centralized services, SeedSphere relies on a swarm of user-operated nodes ("Gardeners") to index, metadata, and healthy signals for content.

This documentation covers the usage of the Gardener Client (Android/iOS) and the SeedSphere Bridge.

Installation

Android

Download the APK from the dashboard or homepage. Allow "Install from Unknown Sources" if prompted.

adb install seedsphere-gardener-v2.0.0.apk

iOS

Join the TestFlight beta using the link on the dashboard. Slots are limited to 10,000 users.

Authentication

SeedSphere uses a secure, passwordless authentication system.

  • Google OAuth: Standard secure login.
  • Magic Link: Email-based JWT sign-in.

Once authenticated, you receive a session cookie seedsphere_session which is valid for 30 days.

P2P Architecture

Your device acts as a DHT node. It participates in:

  1. Gossipsub: Broadcasting content health signals.
  2. Kademlia DHT: Storing distributed metadata.

Port 2022 (UDP) must be open for optimal performance.

API Reference

The Router exposes a REST API on port 8080.

GET /api/v1/health
GET /api/v1/swarm/peers
POST /api/auth/logout