Getting Started
The Seed Hypermedia desktop app is the primary way to create, edit, and collaborate on hypermedia documents. It runs a local daemon that handles peer-to-peer networking, cryptographic identity, and document synchronization — all behind a clean editing interface.
Available for macOS, Windows, and Linux.
Installation
Download the latest release from the official website:
• macOS: .dmg installer (Apple Silicon and Intel supported)
• Windows: .exe installer with auto-update support
• Linux: .AppImage (portable, no install required)
The app bundles its own Seed daemon, so you don't need to install anything separately. On first launch, it starts the daemon automatically and guides you through account setup.
Onboarding: Creating Your Identity
When you first open the app, you'll go through a quick onboarding flow:
1. Welcome Screen — Introduction to Seed Hypermedia and what it offers.
2. Profile Setup — Choose a display name and optionally upload an avatar image (JPEG, PNG, GIF, or WebP, up to 5MB).
3. Recovery Key — Your account is secured by a cryptographic key pair derived from a mnemonic seed phrase. Write this down and store it safely. If you lose access to your device, the recovery phrase is the only way to restore your identity.
4. Ready — You're set up and can start creating documents immediately.
You can also import an existing account if you have a recovery phrase from another device.
The Interface
The desktop app is organized around a few key areas:
Sidebar
The left sidebar provides navigation between your main views: Feed, Drafts, Contacts, Library, and Settings. It also shows your current account and lets you switch between multiple accounts if you have them.
Feed
The feed shows recent activity from accounts you follow — new documents, edits, and comments. This is your starting point for discovering what's happening in your network.
Library
Your library contains all documents you've created or subscribed to. Documents are organized by account and path, making it easy to browse your own content and content from others.
Contacts
Manage the accounts you follow. Adding a contact means your daemon will sync their documents, making their content available locally even when they're offline. You can view a contact's profile, see their published documents, and manage collaboration permissions.
Creating Documents
To create a new document, click the "+" button or use the keyboard shortcut. Every document starts as a draft.
The Block Editor
Seed uses a block-based editor similar to Notion or Google Docs. Each piece of content — a paragraph, heading, image, code block — is an individual block that can be rearranged, nested, or referenced independently.
Supported block types:
• Paragraph — Regular text with rich formatting (bold, italic, code, links)
• Heading — Section headers (multiple levels)
• Code — Syntax-highlighted code blocks with language selection
• Image — Upload or paste images, stored as content-addressed blobs
• Video — Embed video content
• File — Attach any file type
• Embed — Reference another Seed document or external content inline
• Math — LaTeX math equations
• Nostr — Embed Nostr posts
• Web Embed — Embed web content from X/Twitter, YouTube, Vimeo, and other platforms
Type "/" in the editor to open the block menu and see all available types.
Drafts
Drafts are local-only until you publish them. You can work on multiple drafts simultaneously, and they persist across app restarts. The drafts page shows all your work-in-progress documents.
When you're ready, hit "Publish" to sign the document with your cryptographic key and make it available to the network. Published changes are immutable — each edit creates a new version, preserving the full history.
Collaboration
Seed Hypermedia supports real-time collaboration through its peer-to-peer sync protocol.
Adding Collaborators
To let someone edit your documents, add them as a collaborator with the appropriate role:
• Editor — Can create and modify documents under your account
• Writer — Can propose changes (similar to pull requests)
Access control is managed through cryptographic capabilities — you grant specific permissions to specific account keys. No central server decides who can edit what.
Comments
Any Seed user can comment on any document. Comments are cryptographically signed and attributed to the commenter's account. You can reply to comments, creating threaded discussions directly on the document.
Branching
Anyone can fork (branch) a document to create their own editable copy. The branch maintains a reference back to the original, preserving attribution. This enables an open collaboration model — fork, improve, and share — without needing permission from the original author.
See the Branching Guide for details on how branching and refs work.
Publishing to the Web
By default, your documents live in the peer-to-peer network and are accessible to anyone running a Seed daemon. To make them available on the regular web, you can connect to a gateway.
Gateway Settings
In Settings → Gateway, you can configure which gateway(s) your daemon syncs with. The main public gateway is hyper.media, which serves your documents at URLs like:
https://hyper.media/hm/z6Mk.../your-document-pathYou can also run your own gateway for full control over your web presence. See the Self-Hosting Guide for details.
Custom Domains
Through the aliases system, you can point a custom domain to your Seed account, so your documents appear at a custom domain instead of a gateway URL. See Aliases for setup instructions.
Keyboard Shortcuts
The desktop app supports standard editing shortcuts plus some Seed-specific ones:
• Cmd/Ctrl + N — New document
• Cmd/Ctrl + B — Bold text
• Cmd/Ctrl + I — Italic text
• Cmd/Ctrl + K — Insert link
• Cmd/Ctrl + E — Inline code
• / — Open block type menu
• Cmd/Ctrl + F — Find in page
• Tab / Shift+Tab — Indent/outdent blocks
Settings
The settings page lets you configure:
• Account Management — Edit your profile, manage multiple accounts, export recovery keys
• Gateway Settings — Configure which gateways to sync with
• Experiments — Enable experimental features (toggle at your own risk)
• Auto-Update — The app checks for updates automatically and prompts you to install them
Tips and Tricks
• Embed documents within documents — Use the Embed block to create rich, interlinked content. Embedded documents update live when the source changes.
• Use the URL bar — Paste any hm:// URL to navigate directly to a document.
• Web importing — You can import web pages into Seed. The app scrapes the page content and converts it to Seed blocks.
• Markdown export — Right-click a document to save it as a .md file for use outside Seed.
• Multiple windows — Open multiple documents in separate windows for side-by-side editing.
Troubleshooting
If you run into issues, check the Troubleshooting Guide for common problems and solutions. The diagnosis tool (accessible from Settings) can help identify connectivity and daemon issues.
See Also
• Quick Start Guide — Get up and running fast
• Publishing Guide — Deep dive into publishing workflow
• Blocks Reference — All block types explained
• Identity & Signing — How your cryptographic identity works
• CLI Guide — For programmatic access and automation