0 Fork 0

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

Files

T

thePR0M3TH3AN 3dcb4ddc2a Add comprehensive documentation on finding channel URLs from Odysee

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

2026-03-15 19:52:06 -04:00

3.0 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

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.0 KiB Raw Blame History