mirror of
https://github.com/PR0M3TH3AN/LBRY-Downloader.git
synced 2026-10-27 08:22:24 +00:00
thePR0M3TH3AN
3dcb4ddc2a
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
162 lines
3.0 KiB
Markdown
162 lines
3.0 KiB
Markdown
# Quick Start Guide
|
|
|
|
## One-Line Install
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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)
|
|
|
|
1. Go to https://odysee.com
|
|
2. Search for and navigate to the channel you want
|
|
3. Copy the URL from your browser's address bar
|
|
- Example: `https://odysee.com/@TechChannel:1`
|
|
4. Add it to your config.yaml
|
|
|
|
### Edit Config File
|
|
|
|
Edit `~/Documents/lbry-downloads/config.yaml`:
|
|
|
|
```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:
|
|
|
|
```bash
|
|
# Start the daemon
|
|
lbrynet start
|
|
|
|
# Check if it's running
|
|
lbrynet status
|
|
```
|
|
|
|
### Launch LBRY Downloader
|
|
|
|
**Method 1: Using the Launcher (Recommended)**
|
|
```bash
|
|
cd ~/Documents/LBRY-Downloader
|
|
./bin/lbry-downloader --dry-run
|
|
```
|
|
|
|
**Method 2: Add to PATH and run from anywhere**
|
|
```bash
|
|
# 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**
|
|
```bash
|
|
cd ~/Documents/LBRY-Downloader
|
|
source venv/bin/activate
|
|
python main.py --dry-run
|
|
```
|
|
|
|
### Common Commands
|
|
|
|
```bash
|
|
# 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"**
|
|
```bash
|
|
lbrynet start
|
|
```
|
|
|
|
**"Config file not found"**
|
|
```bash
|
|
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.
|