JavaScript ยท Chrome extension

Shuffle Slideshow
for Google Photos

Plays a Google Photos album as a fullscreen slideshow in true random order, the one thing Google Photos won't do. Its own slideshow is always chronological.

Works todayManifest V3100% localMIT licence
1 / 12shuffled ยท no repeats

A working replica of the popup and a demo of the shuffle, using numbered placeholders instead of anyone's photos. Each tile shows once before any repeats.

Two modes

Two ways in, two trade-offs.

In 2025 Google removed the API that let apps list and read your existing library. That leaves two routes: read the album you have open, or use Google's official picker and choose photos by hand. The extension does both, with a switch at the top of the popup.

๐Ÿ“‚

Open album

Reads the album open in your Google Photos tab, scrolling it in the background to collect every photo, then shuffles and plays. No setup, works with shared albums, and starts on the first photo while it keeps reading. Personal use only, since it reads Google's page directly.

โœ…

Pick photos

Uses Google's official Photos Picker API with sign-in. You choose the photos or an album, and the slideshow starts on its own. Needs a one-time OAuth setup, and it's the route that could go to the Chrome Web Store.

Features

Small, and does one thing well.

๐Ÿ”€ True shuffle

A Fisherโ€“Yates "bag": no repeats until every photo has been shown, then a fresh shuffle.

๐Ÿ–ผ๏ธ Fullscreen with crossfades

Smooth fades or instant cuts. Change speed live; loop forever or stop after one pass.

๐Ÿ”’ Nothing leaves your browser

No server, no analytics. Photos load straight from Google into the tab.

Controls

Keyboard first.

KeyAction
SpacePlay / pause
โ† โ†’Previous / next
โ†‘ โ†“Faster / slower
SReshuffle
FFullscreen
EscExit

Install

Load it in a minute.

  1. Get the codeClone the repo, or Code โ†’ Download ZIP on GitHub and unzip it.
  2. Turn on Developer modeOpen chrome://extensions and flip the switch in the top-right.
  3. Load unpackedSelect the folder. Pin the extension if you like.
  4. Play an albumOpen an album at photos.google.com, click the icon, Start slideshow.
git clone https://github.com/pivovarovanatol/gphotos-shuffle-slideshow.git

More projects