0 Fork 0

mirror of https://github.com/PR0M3TH3AN/LBRY-Downloader.git synced 2026-10-27 08:22:24 +00:00

Files

T

thePR0M3TH3AN 66d7a02458 docs: Update documentation for streaming fallback feature

- Add streaming endpoint fallback to README.md features
- Add 'How Downloads Work' section explaining P2P + streaming
- Update QUICKSTART.md with download process examples
- Update CHANGELOG.md with v1.1.0 release notes for streaming fix

The tool now automatically falls back to daemon streaming when P2P
peers are unavailable, ensuring reliable downloads.

2026-03-16 10:56:46 -04:00

3.6 KiB

Raw Blame History

Quick Start Guide

One-Line Install

curl -fsSL https://raw.githubusercontent.com/PR0M3TH3AN/LBRY-Downloader/main/remote-install.sh -o install-lbry.sh && bash install-lbry.sh

Requirements: Git and Python 3.8+ must be installed.

Manual Installation

# Clone or download the repository
cd LBRY-Downloader

# Install dependencies
pip install -r requirements.txt

# Initialize configuration
python init.py

Configuration

Finding Channel URLs (from Odysee)

Go to https://odysee.com
Search for and navigate to the channel you want
Copy the URL from your browser's address bar
- Example: https://odysee.com/@TechChannel:1
Add it to your config.yaml

Edit Config File

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

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

Tip: Just paste the Odysee URL exactly as it appears in your browser!

Launching

Start the LBRY Daemon First

Important: The LBRY daemon must be running before using the downloader:

# Start the daemon
lbrynet start

# Check if it's running
lbrynet status

Launch LBRY Downloader

Method 1: Using the Launcher (Recommended)

cd ~/Documents/LBRY-Downloader
./bin/lbry-downloader --dry-run

Method 2: Add to PATH and run from anywhere

# One-time setup
echo 'export PATH="$HOME/Documents/LBRY-Downloader/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Now run from anywhere
lbry-downloader --dry-run

Method 3: Using Virtual Environment

cd ~/Documents/LBRY-Downloader
source venv/bin/activate
python main.py --dry-run

Common Commands

# Test what would be downloaded (dry run) - ALWAYS DO THIS FIRST
lbry-downloader --dry-run

# Actually download content
lbry-downloader

# Use custom config file
lbry-downloader --config ./my-config.yaml

# View help
lbry-downloader --help

Understanding Output

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

Download Process

When downloading, you'll see one of these patterns:

Fast Download (P2P Available):

📥 Downloading: ExampleFile
   File appeared: ExampleFile.zip
✓ Downloaded: ExampleFile -> ExampleFile.zip

Streaming Download (No P2P Peers):

⏳ P2P download incomplete, trying daemon streaming endpoint...
📥 Downloading: ExampleFile
   Size: 28.61 MB
   [████████████████████████░░░░░░░░░░░░░░░░] 62%
✓ Download complete: ExampleFile.zip

The tool automatically handles both scenarios - you don't need to do anything special!

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.

3.6 KiB Raw Blame History