Files
LBRY-Downloader/QUICKSTART.md
T
thePR0M3TH3AN e707400ffd Complete LBRY Downloader implementation v1.0.0
Features:
- Incremental sync with version tracking (sd_hash)
- Per-channel download paths
- Download limit (default: 10 most recent per channel)
- Interactive setup script with user prompts
- Uninstall script for clean removal
- Comprehensive test suite (42 tests)
- Full documentation suite

Files:
- 9 Python core modules (main, models, utils, config, client, state, planner, downloader, init)
- 3 Setup scripts (setup.py, uninstall.py, install.sh)
- 5 Test files (42 tests, all passing)
- 9 Documentation files
- 4 Build/config files

Total: 31 files, ~4,500 lines
2026-03-15 18:10:56 -04:00

1.6 KiB

Quick Start Guide

Installation

# Clone or download the repository
cd LBRY-Downloader

# Install dependencies
pip install -r requirements.txt

# Initialize configuration
python init.py

Configuration

Edit ~/Documents/lbry-downloads/config.yaml:

channels:
  - input: "https://odysee.com/@YourFavoriteChannel:1"
    enabled: true
  - input: "lbry://@AnotherChannel#5"
    enabled: true

Running

# Test what would be downloaded
python main.py --dry-run

# Actually download
python main.py

# Use custom config
python main.py --config ./custom-config.yaml

Understanding Output

Run complete.
Channels scanned: 2
Claims examined: 150
New downloads: 3
New versions: 1
Skipped existing: 146
Failures: 0

Directory Structure

Downloads are saved to:

~/Documents/lbry-downloads/
  channels/
    ChannelName__abc123/
      channel.json
      claims/
        video-name__def456/
          claim.json
          versions/
            sd_hash789/
              video.mp4
              metadata.json
              download.json
              checksums.txt

Troubleshooting

"Could not connect to LBRY daemon"

lbrynet start

"Config file not found"

python init.py

"No channels enabled" Check that at least one channel has enabled: true

Want to see more details? Edit config.yaml and set log_level: "DEBUG"

Updates

The tool is designed to be run repeatedly. It will:

  • Skip already downloaded files
  • Detect new versions of existing claims
  • Download only what's new or changed

Support

See README.md for detailed documentation.