A comprehensive media center solution combining the power of Kodi with advanced networking capabilities via Tailscale VPN, optimized for Raspberry Pi with LibreELEC-inspired performance enhancements.

Project Raven transforms your Raspberry Pi into a high-performance media center with:

• Direct Kodi Boot: Bypasses desktop environment for instant media center startup
• TV Remote Control: Full CEC integration for seamless TV remote operation
• Secure VPN Access: Built-in Tailscale for secure remote streaming
• Jellyfin Integration: Pre-configured Jellyfin plugin for media library access
• LibreELEC Performance: Video optimizations matching LibreELEC's media performance
• Full Linux Flexibility: Complete Raspberry Pi OS with access to entire package ecosystem

1. Download the latest release for your Pi model
2. Flash to SD card using Raspberry Pi Imager
3. Boot and enjoy - everything is pre-configured!

git clone https://github.com/SysGrimm/Project-Raven.git
cd Project-Raven
sudo ./raspios/scripts/build-image.sh pi4

• Raspberry Pi 2, 3, 4, or 5 (Pi 4/5 recommended for 4K)
• MicroSD Card: 16GB minimum, 32GB recommended
• HDMI Cable: For video output and CEC control
• Network Connection: Ethernet or WiFi

• Raspberry Pi OS: Latest Bookworm (automatically downloaded)
• Build Tools: Linux/macOS system with Docker (for building)

• Hardware Acceleration: Optimized video decoding for all Pi models
• 4K Support: Smooth 4K@60fps playback on Pi 4/5
• Format Support: H.264, H.265, MPEG-2, VC-1 hardware decode
• CEC Integration: Control with your TV remote
• Audio Passthrough: Full surround sound support

• LibreELEC Inspired: Implements proven video optimizations
• Memory Management: Device-specific GPU memory allocation
• I/O Optimization: Media-optimized storage and network performance
• Thermal Management: Sustained playback without throttling

• Tailscale VPN: Secure remote access to your media
• Zero Configuration: Automatic network setup
• Firewall Optimized: Secure by default configuration
• Remote Streaming: Access your media from anywhere

• Zero Configuration: Works out of the box
• Fast Boot: 25 seconds from power-on to Kodi
• Minimal Footprint: 1.5GB system size (75% smaller than stock)
• Auto Updates: Built-in update mechanism

# Build for specific Pi model
sudo ./raspios/scripts/build-image.sh pi4

# Build for all models
sudo ./raspios/scripts/build-image.sh all

# Test configurations locally
./raspios/scripts/pi-ci-test.sh

# Validate optimizations  
./raspios/scripts/optimize-video.sh --validate

Complete documentation is available in our Wiki:

• Quick Start Guide - Get running in 30 minutes
• Hardware Requirements - Compatible devices and specs
• Installation Methods - Different deployment options

• Video Optimization Documentation - Technical details
• Pi-CI Testing Integration - Development testing
• Build System Documentation - Build process details

• CEC Troubleshooting - TV remote control issues
• Known Issues - Common problems and solutions
• Boot Fixes Documentation - Boot troubleshooting

Project-Raven/
├── raspios/                    # Raspberry Pi OS implementation
│   ├── scripts/               # Build and configuration scripts
│   ├── configurations/        # System configurations
│   └── README.md             # Pi OS specific documentation
├── libreelec-custom-build/    # LibreELEC implementation (legacy)
├── libreelec-tailscale-addon/ # Tailscale addon for LibreELEC
├── wiki/                      # Documentation wiki
└── archive/                   # Archived/deprecated files

We welcome contributions! Please see our Contributing Guide for details.

git clone https://github.com/SysGrimm/Project-Raven.git
cd Project-Raven

# Set up development environment
./raspios/scripts/pi-ci-test.sh --setup-dev

• v2.0 (September 2025): Raspberry Pi OS implementation with LibreELEC optimizations
• v1.0 (Previous): LibreELEC-based implementation

See Implementation Status for detailed version history.

• Documentation: Check our comprehensive Wiki
• Issues: Report bugs on GitHub Issues
• Discussions: Community support in GitHub Discussions

This project is licensed under the MIT License - see the LICENSE file for details.

• LibreELEC Team: For the inspiration and optimization techniques
• Tailscale: For making VPN access simple and secure
• Jellyfin Project: For the excellent media server software
• Raspberry Pi Foundation: For the amazing hardware platform
• Kodi Team: For the outstanding media center software

Made with [HEART] for the home theater community