Origo Source
Give good contenta source of its own.
Connect your books, articles and serial chapters to reading apps through one open HTTP(S) contract. You keep your content and choose how it is stored.
ORSP 1.6 candidateHTTP(S) / JSON
Origo XStart small. Add what your readers need.
Core reading stays compact. Optional profiles extend it without replacing your existing endpoints.
Text & illustrated chaptersCore reading
Plain text, Markdown and sanitized HTML, with clear chapter identities and image URL resolution.
contentChapter updatesOptional profile
Follow new chapters and corrections. Versioned catalogs also detect deletion and reordering.
top.xxread:chapter-updatesFull EPUB publicationsOptional profile
Offer the original book file with its size and checksum, alongside existing text chapters.
top.xxread:publicationsOrdered image chaptersOptional profile
An ordered page sequence with asset metadata, ready for readers that implement the media profile.
top.xxread:image-sequenceRecorded audioOptional profile
Recording URLs, expiration metadata and bounded refresh. Client text-to-speech remains a separate capability.
top.xxread:remote-audioMultiple rankingsOptional profile
Named lists, absolute ranks and snapshot-aware pagination, while keeping the original popular feed.
rankingsThe contract defines these profiles. Each source declares what it implements; reader support must be verified separately.
An open boundary that can grow with you.
Storage, content adaptation and the reader have distinct responsibilities. Change one without rewriting the others.
- Stable identity
- Keep source, book and chapter IDs stable when URLs or storage change.
- Explicit capabilities
- Advertise working features. Existing 1.x sources keep their core reading path.
- Coherent snapshots
- Cache derived catalogs and invalidate them when content changes, even if chapter count stays the same.
{
"protocol": "origo-source",
"protocolVersion": "1.6",
"id": "org.example.my-library",
"name": "My library",
"apiBaseUrl": "https://books.example.org/api/",
"capabilities": [
"search",
"detail",
"catalog",
"content"
]
}Origo Source is the Origo X source ecosystem. ORSP means Origo Source Protocol. New sources use origo-source and HTTPS; HTTP and legacy aliases remain supported.
Build with a Skill. Verify with real requests.
The downloadable kit includes a runnable Python starter, scaffolding, canonical schemas and HTTP validation tools. It works without fetching a second contract copy.
Install the Skill
Unzip origo-source-builder into your assistant’s Skill directory, or ask it to read SKILL.md.
Describe your source
Tell it what content you own, where it lives and which profiles you need.
Run and verify
Start the generated source locally, edit a chapter and check the actual discovery URL before deployment.
Use $origo-source-builder to create my own source for original articles and serial chapters. Keep IDs stable, support chapter updates, and verify the service with real HTTP requests.
The starter implements text reading, browsing and chapter updates. EPUB, media and rankings come with contracts and reference fixtures for adding them.
Package checksum
9aba059412a89251b49da4aa6ef5550d35a686554b4682ae48f81971739dcb29Pinned protocol sourceEverything you need to begin.
What is Origo Source?
The names, core reading path and capability boundaries.
Build your first source
Install the Skill, run a local service and add your own content.
Reading profiles & updates
EPUB, media, cache revisions and ranking snapshots.