[Bug] Need documentation for manual restore when NeoBackup fails

[asmith15]

Description
Please provide instructions for how to run commands manually to restore from the Neo Backup backups.

For example: Version 8.3.7 doesn't even show any backups at all on my phone. Version 8.3.6 does. I used this older version to restore all my apps with their data, except OsmAnd.

NeoBackup consistently fails to restore from the large (28.5GB) backup of OsmAnd.

Steps To Reproduce

1. Go back in time 12 years, spend 12 years setting up your OsmAnd just the way you like it.
2. Do a full backup of OsmAnd using NeoBackup, this takes several attempts, each attempt taking several hours.
3. Keep repeating (2) until the backup completes successfully.
4. Do a factory reset on the Android phone.
5. Install NeoBackup 8.3.6, give it all the permissions it's asking for, connect it to the backup location.
6. Attempt to do a restore of the OsmAnd backup.
7. The apk gets installed, but the data does not get restored.

Expected behavior

When Neo Backup fails to restore a backup: that's a big, scary problem. People normally only make backups because they have important stuff they really don't want to lose. People don't normally test restoring from the backup, usually for good reasons.

I'm comfortable guessing that the failure is due to one of many stupidities in the Android subsystems, but it doesn't actually matter what the cause is. It is unreasonable for a desperate user to have to wait till someone (maybe, at some point) finds and fixes the bug, makes a release, etc, etc.

In such an event: I would like to be able to follow some documentation for restoring the backup manually. I (obviously) already have root access, and am comfortable with the shell.

If not a full, proper restore: at least as much as can be restored on the command-line.

If someone can provide some guidance for how to do such a manual restore: I'll volunteer to write it up in proper english in whatever format works for you for publishing purposes.

Thanks!

[3xistenz]

I have the same problem on 2 phones since the latest update July 30th. All backups are gone and I can't find how to start a new series. The app finds nothing. Backups are still on the device, but nowhere to be found by NeoBackup. There is a tab here saying "documentation". When I hit that, nothing happens or opens. How to read that file?

[machiav3lli]

@3xistenz your issue is #886. Either wait for F-droid to build the update 8.3.8 or switch to our build (from IzzyOnDroid, Github or Codeberg).

[3xistenz]

Thank you. Working again. Had to put all my settings back manually, though. We shall overcome :-)