Liseursync

Read on your iPad

There is no app to download. Your server's website has a reader built in, and Safari can put it on your Home Screen as an app. Save a few books in it and you can read on a plane, then pick up on another device where you stopped.

Start

The same works on an iPhone. The pictures on this page are mockups of an iPad.

A page of Dracula in the LiseurSync reader, open full screen on an iPad.
The reader, opened from the Home Screen.

Before you start

  • An account on your LiseurSync server and its address, such as https://books.example.com.
  • An iPad with Safari and an internet connection for the setup.

The steps

Open your server in Safari

Type your server's address in Safari and sign in with your username and password. Your library appears.

The LiseurSync library in Safari on an iPad, with the Share button at the top right ringed in orange.
The Share button is at the top right.

Share, then Add to Home Screen

Tap the Share button, the square with an arrow pointing up. Scroll the list if you need to and tap Add to Home Screen.

On recent versions of iPadOS the Share button can sit behind the ⋯ button next to the address.

Safari's share menu open over the library, with Add to Home Screen highlighted.
Add to Home Screen is in the second group.

Tap Add

The name is filled in as Liseur Sync. Change it if you like. If you see Open as Web App, leave it on, then tap Add.

The Add to Home Screen dialog showing the Liseur Sync icon and name, with Open as Web App switched on.
The icon and name come from your server.

Open it from the Home Screen and sign in

Tap the new Liseur Sync icon. It opens full screen, without Safari's address bar.

Sign in again. The iPad keeps the app apart from Safari, so it doesn't share Safari's sign-in or anything you saved there. From now on, use the icon instead of Safari.

An iPad Home Screen with the Liseur Sync icon ringed in orange among other apps.
Liseur Sync on the Home Screen.

Save books for offline reading

Open a book in the app and tap Save offline. Keep the app open until it says Saved offline. Do the same for every book you want to take with you.

Saved books are on the Offline shelf, which works with no connection at all. Your place, highlights and notes are kept on the iPad and sent to the server the next time you open the app online.

The page for Dracula in the app, with the Save offline button ringed in orange next to Read, Mark read and Download.
Save offline sits next to Read and Download.

What you'll see

The LiseurSync sign-in page, full screen in the app.
Sign inThe first time you open the app.
The Offline shelf listing Pride and Prejudice and Dracula, each with a Remove button.
Offline shelfThe books you saved, ready without a connection.
A page of Dracula in the reader.
ReadingTap the arrows at the sides to turn pages.

On other devices

The reader installs the same way elsewhere. On an Android phone or tablet, open your server in Chrome, open the menu and choose Add to Home screen or Install app. On a computer, Chrome and Edge show an install button in the address bar. Sign in inside the installed app and save your books from there.

On Android, the Liseur app does all of this and more.

If you would rather use a regular app, Readest works well with LiseurSync and runs on the iPad, iPhone, Android, Mac, Windows and Linux. Add your library as an OPDS catalog at your server's address followed by /opds/v2, with an API token from the Apps tab of Devices & integrations as the password. To keep your place in step, turn on KOReader sync in Readest with your server's address followed by /adapter/kosync, a name for the device as the username and a fresh pairing code from the KOReader (kosync) box as the password.

If something doesn't work

There is no Save offline button

Whoever runs the server has set it up in a way that turns offline reading off. You can still read online in Safari or in the app. Ask them if you need offline books.

The books I saved in Safari aren't in the app

The app and Safari keep separate copies. Save the books again from inside the app.

My place didn't reach my other devices

The iPad only sends your reading when the app is open and online. It can't do it in the background or after you close the app. Open the app with a connection, go to the Offline shelf and leave it open for a moment, or tap Retry sync. If it asks you to sign in, do so. Your books stay readable in the meantime and the changes wait for you.

"This book is already open in another tab"

A saved book can be open in only one window at a time. Close the other window and open the book again.

The app doesn't show the latest version

Open the app while online so it can fetch the update, then close it completely and open it again. Don't clear Safari's website data to force it, because that deletes your saved books and anything not yet synced.

Saved books disappeared

The iPad can remove saved books when it runs low on storage, and removing the app from the Home Screen removes them too. Your place and statistics are on the server, so save the books again and carry on.

I'm handing the iPad to someone else

Use Log out in the app. It warns you if some reading hasn't been sent yet. Removing your access on the server stops new downloads, but it can't delete books already saved on a device that is offline.