Q&A
Common questions about FolioSpace Reader
A few practical notes for importing books, connecting remote libraries, and understanding how FolioSpace Reader works on iPhone, iPad, and Apple Vision Pro.
Book Formats
Which file formats can FolioSpace Reader open?
FolioSpace Reader supports EPUB books, local TXT files, PDF documents, and CBZ or ZIP comic archives. Image-based ZIP archives work best when they contain page images in reading order.
Can FolioSpace Reader open MOBI, AZW, or AZW3 files?
Not directly yet. These Kindle formats should be converted to EPUB first, for example with Calibre, and then imported into FolioSpace Reader.
Why does a ZIP book fail to import?
Some ZIP files use compression methods that are not supported by the system reader yet. Re-exporting the archive from Calibre, Komga, or another ZIP tool with standard deflate compression usually fixes it.
Remote Libraries
What address should I use for Komga?
Use Komga's OPDS catalog address, not just the server home page. It usually looks like:
http://your-komga-host:8088/opds/v1.2/catalog
Replace the IP address and port with your own Komga server address. If your Komga server requires sign-in, enter the same username and password you use for Komga.
What address should I use for Calibre-Web?
Start with the address of your Calibre-Web server, including
http:// or https://. If your setup exposes
a specific OPDS endpoint, use that endpoint. Make sure OPDS is
enabled in Calibre-Web settings.
Why can my Mac open the server but Vision Pro cannot?
Your Vision Pro must be able to reach the same network address.
Check that both devices are on the same Wi-Fi network, the server is
running, the port is open, and your router or firewall is not
blocking local network access. If you use a private IP address such
as 192.168.x.x or 10.x.x.x, it usually
only works inside your local network.
Can I use a remote library outside my home network?
Yes, if your server is reachable from outside your local network, but you are responsible for securing it. Prefer HTTPS, strong passwords, and a trusted private network or reverse proxy. Avoid exposing an unsecured book server directly to the internet.
Does FolioSpace Reader upload my books to its own server?
No. FolioSpace Reader does not operate a cloud library for your books. Local books stay on your device. Remote library requests go to the Calibre-Web or Komga server address you enter.
Is FolioSpace Library a cloud service?
No. FolioSpace Library is self-hosted. You deploy the server on your own NAS, Docker host, or local server. FolioSpace Library does not host your books, PDFs, comics, ROMs, or documents.
Does FolioSpace Library provide ROM downloads?
No. Game library support only indexes and manages user-owned local ROM files. FolioSpace Library does not provide ROM downloads, distribution, or built-in copyrighted resources.
Is FolioSpace Library a full Plex or Jellyfin replacement?
No. Library provides local catalogs, original-file streams, movie and TV metadata, seasons, episodes, and client APIs for playback state. TMDB matching is optional and requires your own token. Compatible clients handle decoding; optional HLS remains available. This is a self-hosted index and service layer, not a full replacement for every media server.
Free Edition and Pro
How many local books can I keep for free?
There is no local book limit. The free edition includes core EPUB, PDF, comic, and webtoon reading, bookmarks, notes, progress, offline downloads, and one saved FolioSpace Library server.
Do I need FolioSpace Library to use the reader?
No. You can import supported files directly and read unlimited local books. FolioSpace Library is an optional self-hosted source for browsing, progress sync, and offline downloads across devices.
What does FolioSpace Reader Pro include?
Pro is an optional one-time purchase with no subscription. It adds page-turn effects, the full ambient sound collection, up to five saved FolioSpace Library servers, Calibre-Web and Komga connections, Markdown notes export, and Vision Pro features such as Mini Book Mode.
How do I restore a previous purchase?
Open the FolioSpace Reader Pro screen and choose Restore Purchases. Make sure you are signed in with the Apple ID that originally made the purchase.
Reader 1.40 and recent updates
Are the reading sounds synthesized?
No. The current Reading Companion uses recordings of rain, dawn birdsong, waterfalls and lakeside waves. Download each recording once; after it is saved, playback works offline. Pro adds volume controls and a sleep timer.
How does full-screen lock work?
In EPUBs and comics, lock the full-screen menus to reduce accidental taps. Page turning, text selection and comic zoom remain available. Hold the small lock to restore the controls.
What can I import and customize?
Local TXT import includes a preview, chapter detection and encoding choices. EPUB and TXT share font settings, including built-in Noto Serif SC and LXGW WenKai Lite and imported TTF, OTF, TTC or OTC fonts. Comic folder import can include loose images and supported archives or PDFs in subfolders; page spacing is saved per comic.
Do excerpts and comments sync?
Local EPUB and TXT support excerpts, comments and bookmarks. Text EPUBs downloaded from Library also support these on the current device, even after removing or rebuilding the download. These annotations do not sync to the server or other devices.
Reader release details. AI translation and bilingual reading are not included in this release.
Reading Experience
Is FolioSpace Reader a virtual bookshelf?
No. FolioSpace Reader is designed around quiet reading, not displaying decorative 3D book models. The goal is to make books, documents, and visual pages comfortable to read in a spatial environment.
Does FolioSpace Reader include books or comics?
No. FolioSpace Reader is a reading app. You import your own books, documents, and comics, or connect to your own Calibre-Web or Komga library.