- Added _wait_for_download method that polls for files to appear
- Waits up to 5 minutes (300s) checking every 5 seconds
- Checks both filesystem and daemon file_list API
- Added comprehensive troubleshooting section about incomplete downloads
- Documents why downloads fail (peer availability)
- Provides solutions: using Odysee web player, LBRY Desktop app, timing
- Explains P2P nature of LBRY network
Downloads now properly wait for content instead of giving up immediately.
Corrected previous misinformation:
- LBRY SDK DOES require blockchain header sync (not full blocks)
- First run: 5-10 minutes to download ~1.7M headers
- Added troubleshooting entry for BlockHeightEvent messages
- Users now understand what the sync process looks like
- Provided commands to stop the daemon
This addresses user concerns about the invasive blockchain sync
and ensures users know what to expect on first run.
Added FAQ-style notes to both README.md and LINUX_SETUP.md explaining:
- LBRY SDK is a light client, not a full node
- Does NOT download the blockchain
- Only downloads requested content
- Minimal disk space usage
This addresses common concerns about blockchain size and sync time.
All three main documentation files updated with detailed instructions:
README.md:
- New section 'Finding Channel URLs'
- Method 1: From Odysee website (easiest)
- Method 2: From video page
- Method 3: Using LBRY Desktop app
- All supported URL formats with examples
QUICKSTART.md:
- Added 'Finding Channel URLs' subsection
- Simple 4-step instructions
- Tip about copy-pasting Odysee URLs
LINUX_SETUP.md:
- Expanded 'Add Your Channels' section significantly
- Detailed 3 methods with step-by-step instructions
- Example popular channels
- All URL format examples
- Clear recommendation to use Odysee URLs
Users now have clear guidance on:
- Where to find channels (Odysee.com)
- How to copy channel URLs
- What URL formats work
- Examples of popular channels
thePR0M3TH3AN