Forged by ForgeBoro Follia Documentation • User & Agent Manual v1.0 ← Back to Follia Subpage | ← ForgeBoro Main Site

Follia User & Agent Guide

Comprehensive manual covering visual ePub reading, synchronized speech synthesis, keyboard shortcuts, and machine-readable AI agent automation.

🚀 1. Getting Started

Importing Books

Follia supports standard DRM-free .epub files. To add books to your library:

Managing Your Library

Use the live filter bar to find books by title or author instantly. Tap any book cover to open the reader. Use the trash icon on any card to remove a book from your local storage.

📖 2. Visual Reader & Navigation

Reading Tools

🎙️ 3. Synchronized Text-to-Speech (TTS)

Audio Features

⌨️ 4. Keyboard Shortcut Cheat Sheet

Follia features full desktop keyboard support for fast, hands-on-keyboard reading:

Shortcut Action Scope
Space Toggle TTS playback (Play / Pause) Reader Screen
→ (Right Arrow) Turn forward 1 page Reader Screen
← (Left Arrow) Turn backward 1 page Reader Screen
Shift + → Fast-forward 10 pages Reader Screen
Shift + ← Fast-rewind 10 pages Reader Screen
? or F1 Open in-app Help & Documentation modal Global
Esc Close active modal, drawer, or dialog Global

🤖 5. AI Agent & Automation Specification

MACHINE-READABLE SPEC ACTIVE

Follia is engineered for seamless operation by autonomous AI agents, web scrapers, and headless browsers. Key UI elements feature predictable DOM attributes, and the web environment exposes a global programmatic runtime bridge.

Machine-Readable Spec File

Agents can fetch the complete JSON Schema definition directly at: /agent-spec.json or /public/agent-spec.json.

Runtime Window Attachment

In web runtimes, Follia binds to window.__FOLLIA_AGENT_SPEC__:

// In your browser automation script (Playwright / Puppeteer / Agent SDK): const spec = window.__FOLLIA_AGENT_SPEC__.getSpec(); console.log("Supported tools:", spec.agent_tools); // Programmatically trigger actions: window.__FOLLIA_AGENT_SPEC__.triggerAction("next-page"); window.__FOLLIA_AGENT_SPEC__.triggerAction("play-tts");

Semantic DOM Attributes

Agents can query and interact with elements using predictable data attributes:

❓ 6. Storage & FAQ

Where are my books and progress stored?

Follia uses client-side storage exclusively (IndexedDB on Web, SQLite on Mobile/Desktop). Your books, audio settings, and reading progress remain 100% on your device and are never transmitted to external servers.

Can I read offline?

Yes. Once an EPUB is imported or downloaded from Gutenberg, it is cached locally and can be read and listened to completely offline without an internet connection.