Peek - Stash Browser

Awesome Browser, it has all the features I felt was missing from Stash! Thanks for it!

By any chance, are you considering releasing or at least giving compilation instructions for arm64? I’m using my Raspberry Pi 5 to host my Stash collection, and would be more convenient to put Peek in it as well.

Thanks very much! ARM64 support is a quick fix, I’ll go ahead and update that right now and get it into the next version that gets built

3.1.0 has been released, and should have an ARM64 version for you @5h0d4n

Just installed it using Docker on my Rasp Pi, works like a charm, thanks a lot =)

Great! Make sure you got the patched version 3.1.1 because 3.1.0 had a nasty memory leak issue. You can see the version in the app under Server Settings

I installed it testwise in a container and man, this is a cool alternative.

One question: When a scenes gets an update (in my case: a stash id), when will peek browser get the updated scene? Or do I have to scan manually?

Would it be possible to add some sort of “clips/segments” feature? It would be similar to markers but unique to each user. Meaning, without creating additional media files, it would be possible to create shorter video clips from originally longer scenes. It would be awesome to have full scenes but also be able to “extract” the best segments and play them on their own. As a bonus, it would be great to be able to include these clips in playlists as well.

Thanks! Peek will sync with Stash every hour, checking only for updates (new, updated, or deleted items) that have happened since the last sync operation. It also syncs on startup or if you click Full Sync from the Server Settings page

This is actually slated for an upcoming branch! I’m trying to sort out some maintainability and performance issues in the current versions, then using that solid foundation to start rapidly knocking out feature requests

1 Like

Peek v3.2.2 Release Notes

What’s New Since v3.0

New Browse Modes

  • Timeline View - Browse content chronologically by date
  • Folder View - Navigate content through tag hierarchy
  • Wall View - Justified gallery layout for visual browsing
  • Table/List View - Dense list view for all entity types
  • Tag Hierarchy View - Visual tag organization

User Experience

  • User Stats Page - See your viewing statistics with percentile-based engagement scoring
  • Grid Density Controls - Small/Medium/Large options across all views
  • Card Display Customization - Configure what metadata appears on cards
  • Landing Page Preference - Choose where to land after login
  • URL State Management - Back button and filters now work properly
  • Images Page - Browse and view images with lightbox support
  • Mobile UX improvements across all views

Admin Features

  • Database Backup UI - Export/restore your Peek database
  • Scene Merge Detection - Recover data when Stash merges scenes
  • Unified Settings Page - All settings in one place

Performance & Scalability

  • 500k+ Scene Support - SQL-based query builders for massive libraries
  • Smaller Docker Images - 28% reduction with arm64 builds now available
  • Soft-Delete Entities - Graceful handling when content is removed from Stash

I just tried to load Peek after a while. It couldn’t sync so I tried re-installing it on my unraid server.
now after setting things up Inside peek it does say it’s synced with stash but I get this error everywhere: Error: HTTP error! status: 500
and it doesnt load anything from stash

Oh no! Do you happen to know what version you had previously? Can you send me some logs from the Peek docker? Some more clues are needed. You can DM me here or on Discord if you’d like

3.3.0 is released with a bunch more new features including more user management features, playlist sharing between users, multiple Stash instance support, Markers/Clips integration, and more bug fixes!

Release v3.3.0 · carrotwaxr/peek-stash-browser

1 Like

This is so cool, I got it up and running 5 minutes ago and I really like the presentation.

Thank you, I really appreciate that! Please, if you run into anything you feel like is “missing” or any bugs, report them on Github! It’s easy for me to track and work through them there, and I really rely on the community to help me test and make the app better

1 Like

Thanks for the great work on this. Really makes the Stash viewing UX a lot smoother. Two issues I ran into recently.

  1. Got the following issue when upgrading from 3.3.2 to 3.3.5, was able to resolve it by manually running some SQL.

mmigrate found failed migrations in the target database, new migrations will not be applied. Read more about how to resolve migration issues in a production database: Patching & hotfixing | Prisma Documentation The 20260216000000_add_instanceid_to_multi_instance_tables migration started at 2026-03-01 06:51:14.857 UTC failed

  1. When I upgrade it seems like I get kicked to the setup/create account flow, is this expected? Want to make sure I didn’t do anything silly.

No, you should be able to upgrade versions cleanly and resume using the app without needing to go through setup again. But you will get that when the first time setup is still running. I typically watch the Docker logs after a version upgrade until it says the app is up and ready. If you’re still getting that, we might have had a broken version. I’m going to be pushing another tonight