lbry.tv account and wallet syncing
Users expect consistent experiences across devices and sessions. This includes everything from account preferences to subscriptions to account balances. In the land of central servers, this is straightforward, but in blockchain land, it is tricky. This article explains how we provide this functionality, various options in using it, and it's limitations.
How it works
- Every user, whether on LBRY Desktop, Android, or lbry.tv, has a single wallet file. This file stores your private keys (like a password) that controls your channels and account balances. The keys in this file are the only way to move or spend LBC or publish to your channel.
- On an ongoing basis, your account preferences and other settings are written to your wallet file.
- If you create a lbry.tv login and turn on account sync (backup), your wallet file will be copied to and from a LBRY, Inc. server each time you login and at regular intervals.
- Each time this happens, your preferences, channels, subscriptions, and other data will be updated on the new device.
- If your wallet file has a password on it, LBRY, Inc. cannot see into your wallet or do anything with it, including reset your password.
Using wallet sync
As of writing, current limitations are:
- Can't set or change passwords (coming soon). Only Android allows setting of a password on new accounts currently.
- Cannot remove a previously synced account (i.e. which you don't know the password to). This process is currently manual, please contact us
- On Desktop, if you sign out and back in with a different email, these wallets and accounts will be merged. Do not do this unless it's intentional and you expect the new email to be used by the same person. To prevent this, rename/remove the default_wallet file in the lbryum folder and quit the app with Ctrl-Q after signing out.
- If running the desktop app for the first time, you will be prompted during the first-run process to opt-in.
- If you want to opt-in later, click the Settings button in the top right and enable Sync.
- If you previously had sync configured with a password (i.e on Android), you'll be prompted for this. If you do not remember, please reach out to us so we can remove the existing synced account.
- If running the Android app for the first time, you will be prompted during the first-run process to opt-in.
- If you want to opt-in later, click your balance or navigate to the Wallet area and you will see the option to turn this on.
Syncing is automatically on for lbry.tv users and cannot be disabled. After all, what good would lbry.tv be if you could no longer use it once you signed out! If you have balances on other devices, these will not be reflected at this time.
I'm having trouble
If you have any trouble using or enrolling in account sync, check out this FAQ article on how to report this to us.
See a mistake? Edit this page on GitHub.