Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
M

MMM-GooglePhotos

> 编程语言
Open source

Display your photos on MagicMirror from Google Photos.

198 stars0 likes2 views
WebsiteGitHub

About

Display your photos on MagicMirror from Google Photos.

MMM-GooglePhotos

Display your photos from album of Google Photos on MagicMirror².

[!IMPORTANT]
This plugin is not working currently because new changes in Google Photos API take effect March 2025

Reference:

https://github.com/hermanho/MMM-GooglePhotos/issues/194

https://github.com/hermanho/MMM-GooglePhotos/issues/208

Screenshot

Installation & Upgrade

INSTALL.md

Configuration

…

Usage

albums

Now this module can access not only your owns but also shared. You can specify album title like this.

javascript
albums: ["My wedding", "family share", "Travle to Paris", "from Tom"],
  • Caution. Too many albums and photos could make long bootup delay.
  • Remember this. You can only show max 8640 photos in a day. Manage your album what to show, it will make better performance.

updateInterval

  • Minimum updateInterval is 10 seconds. Too often update could makes API quota drains or network burden.

sort

  • new, old, random are supported.

uploadAlbum

  • If you set this, you can upload pictures from MagicMirror to Google Photos through GPHOTO_UPLOAD notification.
javascript
this.sendNotification("GPHOTO_UPLOAD", path);
  • This album SHOULD be created by create_uploadable_album.js.
bash
node create_uploadable_album.js MyMagicMirrorAlbum
  • At this moment, MMM-Selfieshot and MMM-TelegramBot can upload their pictures through this feature.

condition

  • You can filter photos by this object.
  • fromDate : If set, The photos which was created after this value will be loaded. (e.g: fromDate:"2015-12-25" or fromDate:"6 Mar 17 21:22 UT")
  • toDate : If set, The photos which was created before this value will be loaded. (e.g: toDate:"Mon 06 Mar 2017 21:22:23 z" or toDate:"20130208")
  • ISO 8601 and RFC 2822 is supported for fromDate and toDate.
  • minWidth, maxWidth, minHeight, maxHeight : If set, the photos have these value as original dimensiont will be loaded. You can use these values to avoid too big or too small pictures(like icons)
  • minWHRatio, maxWHRatio : With these values, you can get only portrait photos(or landscaped, or squared)
  • WHRatio is width / height. So =1 will be squared dimension. >1 will be landscaped. ` { return ['10px', '10px', 'none', 'none'] // This will show photo info top-left corner. }

## Tip

- Not to show photo info : Add this into your `css/custom.css`.

```css
#GPHOTO_INFO {
  display: none;
}
  • To move photo info to other position (e.g: top-left corner): Add this into your css/custom.css.
css
#GPHOTO_INFO {
  top: 10px;
  left: 10px;
  bottom: inherit;
  right: inherit;
}
  • Not to show blurred Background : Add this into your css/custom.css.
css
#GPHOTO_BACK {
  display: none;
}
  • To cover whole region with image : Add this into your css/custom.css.
css
#GPHOTO_CURRENT {
  background-size: cover;
}
  • To shrink image and be fully visible on smaller screens : Add this into your css/custom.css.
css
#GPHOTO_CURRENT {
  background-size: contain;
}
  • To display clock more clearly on showing in fullscreen_below : Add this into your css/custom.css.
css
.clock {
  padding: 10px;
  background-color: rgba(0, 0, 0, 0.5);
}
  • To give opacity to photos:
css
@keyframes trans {
  from {opacity: 0}
  to {opacity: 0.5}
}
#GPHOTO_CURRENT {
  background-size:cover;
  opacity:0.5;
}

Notice

  • First scanning will take a few (~dozens) seconds. Don't panic.
  • If there are 1000s of photos, this scan could take minutes(over 10). longer scans increase the probablity of an error happening. If a single error happens in the scan, it will retry after 1 hour. After first successful scan, subsequent startups should go very quickly(seconds).

Last Tested

  • MagicMirror : v2.26.0
  • node.js : required over v18.

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

JavaScriptgoogle-photosgooglephotosjavascriptmagicmirror

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 18, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言