Welcome to Peek Stash Browser¶

A modern web application for browsing and streaming your Stash media library with adaptive video streaming, playlists, and watch history tracking.

Quick Start

Get up and running in minutes with Docker or unRAID

Installation

Configuration

Set up Peek to connect with your Stash server

Setup Guide

Troubleshooting

Common issues and solutions

Get Help

What is Peek?¶

Peek is a web-based browser for your Stash library, offering a sleek modern interface optimized for video streaming and playback.

Key Features¶

Adaptive Video Streaming - Real-time HLS transcoding with multiple quality options (720p/480p/360p)
Watch History Tracking - Automatic progress tracking and resume playback (Learn more)
Playlist Management - Create, organize, and play custom playlists (Learn more)
Modern Interface - Responsive React UI with theme support
Full Keyboard Navigation - Complete TV remote and keyboard control support (Learn more)
Mobile Ready - Optimized for all devices

Quick Start¶

Installation¶

DockerunRAID

docker run -d \
  --name peek-stash-browser \
  -p 6969:80 \
  -v /path/to/stash/media:/app/media:ro \
  -v /path/to/peek/data:/app/data \
  -e STASH_URL="http://your-stash:9999/graphql" \
  -e STASH_API_KEY="your_api_key" \
  carrotwaxr/peek-stash-browser:latest

Open Community Applications
Search for "Peek Stash Browser"
Click Install and configure
Access at http://your-unraid-ip:6969

Default Credentials:

Username: admin
Password: admin

Important: Change Default Password

Immediately change your password after first login via Settings → My Settings

Requirements¶

Stash server with GraphQL API enabled
Docker (or unRAID)
Network access between Peek and Stash
Shared media storage accessible to both containers

Architecture¶

Peek uses a single-container architecture:

Frontend: React 19 app served by nginx
Backend: Node.js/Express API server (proxied through nginx)
Database: SQLite (embedded, no separate container)
Transcoding: FFmpeg for real-time video conversion

Community & Support¶

Bug Reports: GitHub Issues
Feature Requests: GitHub Issues
Stash Community: Discord - #third-party-integrations channel

License¶

This project is licensed under the MIT License.

Acknowledgments¶

Built with Stash, React, Express, FFmpeg, and other amazing open source projects.