Resetting to factory defaults
Sometimes it may be necessary to reset the application to a factory default state in order to work around persistent issues. This document describes three areas that can be reset, along with the consequences of each. Only perform any of these steps if the application has been shut down.
Note that you will have to enable showing hidden files in your file browser (i.e. Explorer/Finder on Windows/macOS) in order to navigate to the paths that are listed on this page.
Clearing the global image caches
For images or videos not contained in an Aspect library, as well as for files that have to be fetched from other Aspect instances in the network, a set of caches is maintained. In the case of data corruption, these can be safely deleted and their contents will be restored on-demand.
In order to delete the caches, delete the following folder:
- Windows:
C:\Users\YourAccount\AppData\Local\Bildhuus\Aspect
- macOS:
/Users/YourAccount/Library/Caches/Aspect
- Linux:
~/.cache/aspect
Removing application settings
The application settings are kept in the following file:
- Windows:
C:\Users\YourAccount\AppData\Roaming\Bildhuus\Aspect\app.settings
- macOS:
/Users/YourAccount/Library/Aspect/app.settings
- Linux:
~/.config/aspect/app.settings
Deleting it will revert the settings to factory defaults.
Note that this will also remove the list of known libraries, so that those will have to be opened manually afterwards. If you also intend to reset your library, you should follow the “removing a library completely” article first.
Removing all network identifications
Any Aspect device that is paired over the network in order to synchronize a
library will exchange a set of cryptographic keys. These keys are required to
perform any communication in an end-to-end encrypted manner. Deleting them will
require to perform the pairing process again. Deleting the host.json
file
will also remove any synchronization permissions from any library that is
synchronized with other devices, so that the respective device needs to be added
to the library again.
Deleting the network identifications can be done by deleting the following folder:
- Windows:
C:\Users\YourAccount\AppData\Roaming\Bildhuus\Aspect\auth
- macOS:
/Users/YourAccount/Library/Aspect
- Linux:
~/.config/aspect/auth
You may want to retain the host.json
file contained in that folder, in case
you have any libraries that are synchronized over the network.