Guide

Setup, streaming and troubleshooting in one place. Everything here applies to the app you already have - no account needed to read any of it.

Getting started

Install it, get your files in, and know where your progress lives.

How do I add books and folders to BiblioFuse on iPhone?
BiblioFuse stores files in its own iCloud-synced folder. You can add books via the Files app (copy files into the BiblioFuse folder), via AirDrop, or via the built-in Wi-Fi Transfer — open a library session from Mac or PC and drag files in from any browser.
Where are reading progress, bookmarks, ratings, and tags saved?
It depends on where the book file lives:

Libraries & servers

Kavita, Komga and any OPDS catalogue, plus folder-as-library browsing.

Streaming from your Mac or PC

Your own machine hosts the library; the app reads from it.

How does streaming from Mac or PC to iPhone work?
Your Mac or PC runs a local server and writes the connection address to iCloud Drive. Your iPhone picks it up automatically. Both devices must have Tailscale on (works at home and remotely). If only one device has Tailscale on, the connection will fail. Keeping both devices always on Tailscale gives the most consistent experience.
What do I need to set up streaming?
Both your Mac or PC and your iPhone must have the following configured:
Streaming is set up correctly but still not working — what should I try?
A stale endpoint cache is the most common cause. One or more stream_endpoint.json files stored in iCloud has an outdated timestamp, which prevents BiblioFuse from discovering the host.
Why does streaming require Tailscale? Can't it just use home Wi-Fi?
Tailscale is required because of how iOS handles local network connections. Here is what happened:
Why can't Android receive books from Mac or PC?
The Android app uses a different codebase without iCloud integration, which is how the streaming handshake works. The best workflow for Android is to sync files to your phone using Syncthing or a similar tool, then add that folder as a library source in the app.

Reading

Formats, reading direction, text-to-speech and translation.

Does BiblioFuse work on Apple Vision Pro?
Yes. BiblioFuse is a native visionOS app on the App Store — a true spatial window, not a compatibility-mode iPad app. It supports eye tracking, pinch, mouse, trackpad, and keyboard, and it is included in the universal iOS + Mac purchase at no extra cost.
What spatial reading layouts does BiblioFuse support on visionOS?
Three spatial library layouts: Spatial Bookshelves (your covers on floating shelves), Grid View (a floating grid for large libraries), and Slanted Wall (an angled gallery wall with rating and tag filters). You can also stream your library from a Mac or PC to keep Vision Pro storage free.
How do I get better text-to-speech voices in BiblioFuse?
Higher-quality voices may already be available through your device's text-to-speech system, but some must be downloaded separately. BiblioFuse will detect newly installed voices automatically when they are made available to apps.

Tools

Fix a file before you read it - in the browser, on your device.

What is the difference between the PC Reader and the PC EPUB / CBZ tools?
The PC Reader is a full reading app — it opens books, manages your library, compresses files, and streams to iPhone. The PC EPUB and CBZ tools are lighter, cheaper apps focused on compression and merging only, with no reader.

Not covered here? Support replies to real email, not a ticket queue.

Email support