akoue/guides/if something is wrong

If something is wrong

Almost every problem in Akoue has a screen of its own: it names the cause and suggests the next step. Here is where to find them and what to tap before you write to the developer.

None of these situations wipes the catalog: a book with no files keeps its progress, bookmarks and place in the series, and a deleted one waits in the trash for thirty days. Everything described here is free except sync, which is Pro.

If nothing helped, write: Settings → “About” → “Write to the developer”. Attach the “Diagnostics” report to the email — the last scenario covers it.

01/10

A book will not play

When a book cannot be played, the player does not just go silent: in place of the cover a screen appears with the cause and some buttons.

  1. “Files not found” — the book’s files are neither on the device nor in iCloud. Buttons: “Check again”, “Open book card”, “Delete the book”.
  2. “Chapter did not load” — a chapter of an offloaded book did not arrive from iCloud: there is no connection, or the download has been stuck for more than three minutes. If you were waiting for the chapter on the “Listen” button, the player opens with this screen by itself. Check the network and tap “Try again”.
  3. “File will not play” — the chapter’s file is damaged. The book pauses at that spot, and the position is saved.
  4. “Delete the book” does not erase it but moves it to the trash for thirty days, with its progress and bookmarks.

The player does not skip a broken file by itself: the book waits at the point of failure. Such a file can be excluded from the book in its make-up — swipe the row and tap “Exclude”.

02/10

Files not found

The book is in the catalog, but its files are not: they were deleted in Files or the folder was moved. The catalog itself is intact.

  1. At the top of the card is a “Files not found” banner; the main button is disabled and reads “Files unavailable”.
  2. Tap “Check again”: the app looks for the files on the device and in iCloud and tells you what it found.
  3. If you have the files, bring them in through “•••” → “Add files”: they return to the book with its progress and bookmarks. A regular import recognises them too and puts them back in place.
  4. If there will be no files, use “Delete this edition”: the chapters and the listening position go, while the book, the author and the series stay.

For a book linked to a folder the banner reads “The book’s folder is gone”. A folder deleted from iCloud Drive can be restored from Recently Deleted in Files; while it is there the book plays, and the card warns that time is running out.

03/10

The book is on the second device, the files are not

Sync carries the catalog, position, bookmarks and edits, but not the audio: files are brought to each device or offloaded to iCloud on one of them.

  1. Such a book’s card says “No files on this device” and where they are: which device holds them and whether they are offloaded to iCloud. In the library the book is labelled “on another device”.
  2. Offload the book to iCloud on the device that holds it (offloading is part of Pro): here it becomes a cloud book by itself, with “Listen” and “Download” buttons. For that, iCloud Drive for Akoue must be on here too: if it is off, the hint on the card asks you to turn it on and restart the app.
  3. Tap “Listen”: while a chapter downloads, the button shows “Downloading chapter” with the share below it, for example 58%, a second tap cancels, and “Download” can’t be tapped in the meantime. Once the chapter is down, the book plays from the place that came through the exchange, and the other chapters arrive as it plays.
  4. If you don’t want to offload it, bring the files here with the “Add files” button on the card or a regular import: the progress finds its own book by the make-up of the files.
  5. In Settings → “Sync”, the “Waiting for its book” row counts what has arrived for a book that is not on this device yet; once the book is set up, the number goes down.

If the positions on the two devices differ by more than a minute, the app asks where to continue when you open the card, naming both places and their devices.

04/10

Import did not take everything

The report at the end of an import lists what did not make it into books and why. Files the app did not take stay where they were.

  1. “Format not supported” — ogg, wma, ape and the like: they do not play without conversion. Under the line is the file’s extension.
  2. “Format is protected” — aax and aaxc from Audible: they are encrypted and cannot be opened.
  3. “Empty file” — a zero-size audio file; “Could not read” — for example, a folder more than six levels deep.
  4. If the import broke off because the app closed, the “Add books” screen offers “Continue import” or “Cancel import”.

The full list of what plays without conversion is on the Formats page.

05/10

Titles arrived garbled

Tags from old releases are often written in Windows-1251 or KOI8-R and read as `Ïèêíèê`. The app notices this by itself and repairs it the way you choose.

  1. On the book card tap “Fix” on the “Titles may be wrong” banner — or, in the import report, next to the “Title encoding” row.
  2. For every suspicious field — title, author, narrator, series — the first row is the original as written in the file, and below it the readings with an encoding and a confidence.
  3. Pick the readable ones and tap “Apply”.

No banner, but the title still looks odd? Fix it by hand in “Edit”: the original value is kept, and under the corrected field there is “Restore”.

06/10

The catalog and the files disagree

Two checks match the catalog against what is on disk. Both are free.

  1. Settings → “Maintenance” → “Rescan library”: checks every book’s files, fills in missing lengths, finds missing covers of text books — epub, fb2, pdf — and rebuilds search. Deletes nothing.
  2. The Storage tab → “Check integrity”: marks the books with no files and finds storage folders that no book belongs to.
  3. Before acting, the sheet shows what it “Will touch” and what it “Will delete”, with sizes. “Fix” removes the stray folders.
  4. A book deleted by mistake is on the Storage tab → “Recently deleted”: “Restore” brings it back within thirty days.

Next to it, under “Maintenance”, is “Clean up catalog”: it removes authors, series, narrators and universes with no books left.

07/10

The library did not open

The “Could not open the library” screen names the reason, and what to do depends on it. It can appear at launch or a few seconds later: the catalog is checked in the background so that opening is not delayed.

  1. Not enough space: the screen shows how much is free. Free up some space and tap “Try again”. The catalog is intact, so the screen does not offer to replace it with a copy.
  2. The catalog file is damaged: if there is an automatic copy, a “Return the catalog from…” button appears with the date and the number of books.
  3. The catalog file is write-protected and Akoue couldn't remove the protection: the catalog is intact, so don't delete anything. Tap “Write to the developer”; the screen doesn't offer to replace the catalog with a copy here.
  4. The reason is unclear: first tap “Try again” and restart the phone. The return button is here too, but the copy replaces the catalog.
  5. After returning, everything added later than the copy is gone: new books, positions and edits. The files of new books stay in storage, and “Check integrity” brings them back. A cover replaced after the copy may not come back.

The app makes an automatic copy once a day, when it is open and the phone has enough space, and keeps the last two. In the first day or on a full phone there may be none. It does not protect against losing the phone: for that there is the catalog backup in iCloud and a backup file of your own.

08/10

Changes aren't being saved

The “Changes aren't being saved” banner above the screen means the catalog has stopped accepting writes: books still play, but your place in a book, bookmarks and edits aren't remembered. The banner text names the cause.

  1. The catalog file is write-protected: restart Akoue, which restores its own write access at launch. If that doesn't help, tap “Write to the developer” on the banner. Your books and catalog are safe; there's nothing to delete.
  2. The device is out of space: free up some space. The banner goes away on its own once there's free space.
  3. Importing won't work in the meantime: “Import failed” will name the cause, write protection or lack of space, and your files stay where they were.

The cross hides the banner until the next launch; if space runs out again, it comes back. Until the cause is fixed, nothing new is saved, even when the banner isn't showing.

09/10

Pro is gone

A purchase is tied to your Apple Account, not to the device. If Pro did not switch on on a new phone or after a reinstall, one button brings it back.

  1. Open Settings → “About” and tap “Restore Purchases”. The App Store may ask for your password.
  2. The answer comes in a window: “Purchases restored.” or “No purchases found.” — in the second case, check that the right Apple Account is signed in to the App Store.
  3. The same button is on the Akoue Pro screen, under the purchase button.
  4. A purchase made on another device or shared through Family Sharing arrives by itself, without the button.

When a subscription ends, Pro features close, but books and data stay in place, and books offloaded to iCloud come back to the device for free.

10/10

Send a report

When an error does not explain itself, the app’s log helps the developer. It is gathered only at your request, and you see it before it is sent.

  1. Open Settings → “About” → “Diagnostics”.
  2. At the top the app shows where the books are — the paths to its folders; below come the report lines: version, system, device model and language, then its own log: time, section, level, text, with errors recorded as codes.
  3. Tap “Share Report” and choose Mail: the file akoue-diagnostics.txt goes out.
  4. You do not need to add the version, system or model: they are already in the report. A message through “Write to the developer” opens with them too: the subject and the lines at the bottom are visible before sending, and you can delete them.

The report contains the app version, system, device model and language, the app’s folders and its own records; errors in the log are recorded as codes, without book titles or paths to book files. It goes nowhere until you send it.

What is not here

  • Skipping a broken file: the player stops on it instead of jumping to the next one.
  • Reconnecting a linked book’s folder: put the folder back in place or bring the files in again with “Add files” — then they are copied into the app.
  • Converting ogg, wma or ape, or opening protected aax.
  • Automatic crash reports: a report leaves only by your own hand, through “Share Report”.