Lodestarr is a powerful, lightweight indexer aggregator and proxy for Torznab-compatible sources. Built with Rust for performance and React for a modern user experience, it unifies search results from multiple indexers into a single, responsive interface.
| Feature | Lodestarr | Jackett | Prowlarr |
|---|---|---|---|
| Language/Runtime | Rust (native binary) | C# (.NET) | C# (.NET) |
| Memory Usage | ~15-30 MB | ~100-300 MB | ~150-400 MB |
| Startup Time | Instant (<1s) | 5-15s | 10-30s |
| Native Indexer Support | ✅ Uses Jackett YAML definitions | ✅ Built-in | ✅ Built-in |
| Proxied Indexers | ✅ Torznab proxy | ✅ Torznab feed | ✅ Torznab + Newznab |
| Query Caching | ✅ SQLite-backed (1hr TTL) | ✅ Yes | ❌ No |
| CLI/TUI Interface | ✅ Full TUI + CLI | ❌ Web only | ❌ Web only |
| Docker Image Size | ~125 MB | ~300 MB | ~400 MB |
| Raspberry Pi Optimized | ✅ Native ARM64 | ||
| Arr App Integration | ✅ Torznab API | ✅ | ✅ Auto-sync |
| Usenet Support | ❌ Torrents only(for now) | ✅ Full |
-
🦀 Rust Performance: Single binary with no runtime dependencies. Perfect for low-power devices.
-
🖥️ Terminal-First: Full TUI (Terminal UI) and CLI for headless servers. Search, browse, and download without ever opening a browser.
-
🔌 Jackett Compatibility: Uses Jackett's battle-tested YAML indexer definitions directly. If it works in Jackett, it works in Lodestarr.
-
📦 Minimal Footprint: ~125MB Docker image vs 300-400MB for alternatives. Uses ~20MB RAM at idle vs 100-300MB.
- Blazing Fast: Native Rust binary with async I/O for maximum throughput
- Low Resource Usage: Ideal for Raspberry Pi, NAS devices, and VPS instances
- Smart Caching: SQLite-backed result caching with configurable TTL (default: 1 hour)
- Aggregate Results: Query all indexers simultaneously with a single search
- Advanced Filtering: Filter by indexer, category, size, or text
- Sorting Options: Sort by name, size, seeders, leechers, or date
- Pagination: Handle large result sets with built-in pagination
- Jackett Definitions: Download and use indexer definitions directly from the Jackett repository
- YAML-Based Config: Human-readable indexer configurations
- One-Click Install: Browse and install indexers from the web UI
- Auto-Updates: Keep indexer definitions current
- Torznab Proxy: Connect to any Torznab-compatible source (Jackett, Prowlarr, etc.)
- Unified Interface: Mix native and proxied indexers seamlessly
- Easy Configuration: Simple forms for adding external indexers
- SQLite Database: All data persists across restarts
- Search Logs: Complete history of every search query
- Statistics: Track indexer performance and usage patterns
- Configuration Storage: Robust settings management
- Dark/Light Themes: System-aware theme with manual override
- Responsive Layout: Works on desktop, tablet, and mobile
- Real-Time Dashboard: Live metrics, activity feed, and indexer status
- Full CLI: Script searches and automate workflows
- Interactive TUI: Rich terminal interface for browsing results
- Magnet/Torrent Downloads: Download directly from command line
- Torznab API: Standard
/api/v2.0endpoints - Capability Reporting: Full
/capsendpoint support - Category Mapping: Proper category translation for *arr apps
The command center with real-time metrics, activity feed, and system health.
Aggregate results from all indexers with powerful filtering and sorting.
Browse, install, and configure native and proxied indexers.
Multi-architecture images for linux/amd64 and linux/arm64.
services:
lodestarr:
image: ghcr.io/ddonindia/lodestarr:latest
container_name: lodestarr
ports:
- "3420:3420"
volumes:
- ~/.config/lodestarr:/root/.config/lodestarr
restart: unless-stoppeddocker-compose up -dAccess the dashboard at http://localhost:3420.
docker run -d \
--name lodestarr \
-p 3420:3420 \
-v ~/.config/lodestarr:/root/.config/lodestarr \
ghcr.io/ddonindia/lodestarr:latestPrerequisites: Rust (latest stable) and Node.js 18+.
git clone https://github.com/ddonindia/lodestarr.git
cd lodestarr
cargo build --release
./target/release/lodestarr serveConfiguration is stored in config.toml:
- Linux:
~/.config/lodestarr/config.toml
# config.toml
db_path = "/custom/path/to/lodestarr.db"RUST_LOG=debug ./lodestarr serve# Basic search
lodestarr search "ubuntu iso"
# TV search with season/episode
lodestarr search "Game of Thrones" -t tvsearch --season 1 --ep 1
# List installed native indexers
lodestarr indexer list
# List proxied indexers
lodestarr indexer list --proxied
# Download indexers from Jackett
lodestarr indexer download --list # Browse available
lodestarr indexer download --names yts,eztv # Install specific
lodestarr indexer download --all # Install all
# Test an indexer
lodestarr indexer test yts --query "test"# Launch interactive terminal UI
lodestarr tuiLodestarr provides a Torznab-compatible API for integration with Sonarr, Radarr, Lidarr, etc.
| Endpoint | Description |
|---|---|
/api/v2.0/indexers/all/caps |
Capabilities for all indexers |
/api/v2.0/search?q=query&t=search |
Unified search across all indexers |
/api/info |
Server information and version |
/api/search |
Web UI search endpoint |
/api/stats |
Server statistics |
- Go to Settings → Indexers → Add
- Select Torznab
- Set URL:
http://localhost:3420/api/v2.0/indexers/all - API Key: (leave empty or use any value)
┌─────────────────────────────────────────────────────────────┐
│ Lodestarr │
├─────────────────────────────────────────────────────────────┤
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
│ │ Web UI │ │ CLI │ │ TUI │ │
│ │ (React) │ │ (Clap) │ │ (Ratatui) │ │
│ └──────┬──────┘ └──────┬──────┘ └──────────┬──────────┘ │
│ │ │ │ │
│ └────────────────┼─────────────────────┘ │
│ ▼ │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ Axum HTTP Server │ │
│ │ (Torznab API) │ │
│ └───────────────────────┬───────────────────────────────┘ │
│ ▼ │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ Search & Aggregation Layer │ │
│ │ (Caching, Dedup, Timeout Management) │ │
│ └───────────────────────┬───────────────────────────────┘ │
│ ▼ │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ Native Indexers │ │ Proxied Indexers│ │
│ │ (Jackett YAML) │ │ (Torznab) │ │
│ └────────┬────────┘ └────────┬────────┘ │
│ │ │ │
│ └──────────┬───────────┘ │
│ ▼ │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ SQLite Database │ │
│ │ (Config, Cache, History, Stats) │ │
│ └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
- Running on Raspberry Pi or low-power devices
- You want minimal resource usage (RAM/CPU/disk)
- You prefer CLI/TUI for headless servers
- You need fast repeat searches (caching)
- You want a single binary with no dependencies
- You need maximum indexer compatibility
- You're already in the .NET ecosystem
- You have plenty of server resources
- You want auto-sync with *arr applications
- You need Usenet indexer support
- You prefer the *arr app ecosystem
This project is provided for educational purposes only. Lodestarr does not promote, encourage, or condone piracy or the unauthorized distribution of copyrighted material. Users are solely responsible for ensuring their use of this software complies with all applicable laws in their jurisdiction. The developers assume no liability for misuse of this tool.
MIT License by ddonindia.