Troubleshooting
The most frequent questions, and their answers.
The iPhone cannot find the Mac
If it says “Couvertures has no access to the local network”, access was refused: iOS only asks once. Tap Open Settings, turn on Local Network, then come back to the app.
It stays on “Looking for Couvertures on the Wi-Fi…” or says “Mac not found on this network”. Check, in order: on the iPhone, Settings > Apps > Couvertures > Local Network is on; Couvertures is open on the Mac (window closed or not); the Mac is awake; both devices are on the same Wi-Fi, and not on a guest network, which keeps devices apart; on the Mac, Settings > Connect your phone, “Reachable from the Wi-Fi” is ticked; in the Mac’s System Settings > Network > Firewall, Couvertures is allowed to receive connections. At the top of the iPhone’s Settings, “Try again” starts the search again.
If the network hides devices from each other, type the Mac’s address at the top of the iPhone’s Settings, under “Address of the computer running Couvertures”: the Mac shows it in Settings > Connect your phone, next to the QR code.
Without a Mac, put the library on the iPhone: On This iPhone Instead on the welcome screen, or Settings > Where the Library Lives. See Getting started.
The iPhone shows a Mac that is not mine
It does not connect to it on its own: it offers it, because it found it on the Wi-Fi. Tap yours when it is there, or wait until you are home: your library stays on the phone. After Use Another Mac, it likewise shows the Macs it found, and waits for your choice.
“Server unreachable”
The Mac stopped answering: it went to sleep, or the Wi-Fi changed. In the scanner, the books that already left are in To review; on a line that failed, tap “Try again” once the Mac is back, or swipe it to the right.
“Unreadable reply from the server”
The iPhone and the Mac probably do not have the same version: update both in TestFlight.
“Photos refused by the Mac”
The Mac did not accept some photos (a damaged file, a photo too heavy): they will not be sent again, take them again.
“Changed on both sides”
A record changed on the iPhone away from the Mac and, for the same field, on the Mac. Nothing is lost until you choose: Keep this version under one or the other, or Later. See The iPhone away from the Mac.
Couvertures has no access to the camera
On the iPhone, Settings > Apps > Couvertures > Camera, then try again. For dictation, in the same place: Microphone and Speech Recognition.
“Analysis failed” on a card
The AI did not answer, or its key no longer works: “Open the settings” leads to “Cover recognition”; “Test the connection” says what is wrong. Without AI, barcodes still work.
Without a key, with Apple Intelligence: Apple’s model could not read the photo just now. Tap Retry the analysis a little later.
“Type the title” on a photo of a cover
Nothing read the photo: no AI key, and no Apple model on this device (it needs iOS 27 or macOS 27, with Apple Intelligence turned on). Type the title, then “Search”. To have covers read: Setting up an AI; a saved key starts these photos again by itself.
“The AI did not recognise anything in this photo”
The AI, or Apple Intelligence, read the photo without finding a title in it: blurred, too dark, or it is not a cover, a case or a sleeve. Type the title, then “Search”; or take the photo again, sharp and well lit.
“No network” on a card
The device where the library lives (the iPhone, or the Mac) had no network when you scanned the book. Nothing to do: the search starts again by itself when the network returns.
“Source unavailable” on a card
Google Books, Open Library or the BnF did not answer, or, for a movie or an album, TMDB or MusicBrainz (outage, daily quota reached). The other sources have often found the book anyway. Later, “Search again” completes the record without reading the photo again. Google Books is only asked with a key (Settings > Online sources, “Google Books key (optional)”): without a key, its shared quota is reached straight away.
“Book not found online”, “Disc not found online”
The barcode was read, but no catalogue knows this edition. It happens more often outside France, where Open Library is often the only one to answer (Google Books needs a key). The card waits in Review, with “Barcode read, book not found online: type the title”: type the title, then “Search”. If you are abroad, tell me which books are missing: see Testing the beta.
For a DVD or a CD, the BnF and MusicBrainz look up the barcode. The card says “Movie not found online: type its title” (or “Album…”): type the title, looked up at TMDB for a movie, at MusicBrainz for an album; or “Photograph the case” (for an album, “Photograph the sleeve”): the AI or Apple Intelligence reads the title on it.
A book taken for a disc
The scanner takes book codes (starting with 978 or 979), magazine codes, and the others as those of a DVD or a CD. Some books carry two barcodes: aim at the one starting with 978 or 979, or the book is looked up as a disc.
No cover found
Some editions have no cover in any source. Take a photo of it: “My photo” when reviewing, or, in the record, “Photograph the cover” (iPhone), “Take a photo with the iPhone…” (Mac) or “Choose an image…”. A DVD gets its movie’s poster when TMDB finds its title; otherwise, photograph its case.
The recognised book is wrong
When reviewing: “Other results”, or “Wrong book?” to search yourself. If nothing matches (a rare magazine taken for another), None, at the end of the other results, clears the suggested edition: you fill in the record yourself, with your photo. Later: “Search online” in the record. The surest remains the ISBN, printed on the back next to the barcode.
The photo is grey or badly framed
In the record, the cover’s menu: “Crop my photo”, with “Correct the lighting” in the same screen, then “Apply”; “Correct the lighting” is also in the menu. Right after a photo, “Crop” does the same. For several books on the Mac: select them, then “Photos”.
The keyboard hides the page (iPhone, iPad)
During a search, scroll the results: the keyboard goes down. Elsewhere (Review, the record, Classify, Settings), pull the page down.
No more sorting by title on the iPhone
On the iPhone and the iPad, Sort now only offers Random, Recently added and By colour; a removed sort that was chosen goes back to Random. A title, an author or a year can be found with the search. The Mac keeps its six sorts. See Browsing.
A book added on the iPhone does not show on the Mac
It arrives on its own within seconds. Not to wait: View > Refresh (⌘R). If the library lives on the iPhone, the Mac does not receive it: to open it there, File > Open a Backup… (see Backing up and exporting).
“Couvertures cannot start”
The library folder is no longer there (a disk unplugged, a folder moved) or comes from a newer version of Couvertures. “Change Data Folder…” opens another one; plug the disk back in or put the folder back, then relaunch. If the message says port 3000 is already in use, it is often the web version running: close it.
Keeping a copy of the library
Settings > Backup, or File > Show Data in Finder and copy the folder. When the library lives on the iPhone, its copy in iCloud Drive (Couvertures iPhone) happens by itself. See Backing up and exporting.
“iCloud Drive isn’t available on this device”
The iPhone’s backup did not find iCloud Drive: no iCloud account, or iCloud Drive turned off in the iPhone’s Settings. Turn it on, or, in Settings > Backup, Choose a Folder… elsewhere.