Wall Candy
Support
Get in touch
Email us and we'll get back to you. It helps to mention which app you're using (Wall Candy on iPhone or iPad, Wall Candy TV, or Wall Candy Studio on a Mac), which screen you're hanging on (Samsung The Frame, Apple TV, AirPlay, Google Cast or an email frame) and what the app said.
What you need
- An iPhone or iPad running iOS 17 or later. Shortcuts automations that run without asking need iOS 17 too.
- A screen to hang on: a Samsung The Frame, an Apple TV 4K or Apple TV HD running tvOS 17 or later with the Wall Candy app (coming soon to the App Store), any AirPlay screen, a Chromecast or Google TV, or a digital frame that accepts photos by email.
- For Wall Candy Studio, a Mac running macOS 14 or later that stays on. Studio is a free download, not a Mac App Store app, and it hangs on The Frame and Apple TVs.
- Your phone or Mac and your TVs on the same Wi-Fi network.
Connecting your screen
Wall Candy can't find my Samsung The Frame
Make sure the TV is on or in Art Mode and on the same Wi-Fi as your phone. Tap the chip at the top of the app, choose Samsung The Frame, tap "Frame settings and what's on the wall," then "Find my Frame." The first time, your TV may ask whether to allow the connection. Choose Allow.
An upload to the Frame stopped partway
The Frame sometimes refuses a picture when several arrive quickly. Wall Candy pauses, reconnects and tries again on its own. If it still stops, wake the TV fully, then hang the remaining pictures again: the app keeps track of which ones already made it.
Using the Apple TV app
Open Wall Candy on your Apple TV, then on your iPhone tap the chip at the top and choose Apple TV. Pictures you hang appear on the TV, and it keeps them. On the Apple TV, click the touchpad to open the settings panel: choose an art wall or a slideshow, how often pictures change, transitions, mats, the inner line and QR codes, for every picture or just the one on screen.
Using AirPlay
Open Control Center, tap Screen Mirroring and pick your TV, then hang a picture. Only the art appears on the TV, and your music keeps playing.
Adding pictures right on the Apple TV
On an empty wall, click the touchpad; otherwise open the settings panel and choose Add pictures. Museum and NASA collections work right away. For Flickr, Google Photos or Immich, first sign in on your iPhone, then tap the chip at the top, choose Apple TV and tap "Send sign-ins."
Shortcuts and Siri
What the actions do
Wall Candy adds six actions to the Shortcuts app on your iPhone and iPad. They work while Wall Candy is in the background, so an automation can run them at any hour.
- Hang Photos dresses the photos you hand it (from Shortcuts' Find Photos or Select Photos) in a mat style you pick and hangs them on the screen you pick; the first one goes up right away.
- Hang a Day Card draws a card with today's events, the week, the weather, your to-dos, a countdown, or a photo with the date, and hangs it.
- Show on the Frame switches the Frame to the next picture, a random one, or the first.
- Run the Frame Slideshow has the Frame change pictures on its own, anywhere from every 3 minutes to every 7 days, shuffled if you like.
- Turn the Frame On or Off does just that: on, off, Art Mode or TV Mode.
- Clear My Photos from the Frame takes down everything Wall Candy hung, and asks before it does.
Siri runs them too. Try "Hang a photo on the Frame with Wall Candy," "Show the next picture on the Frame with Wall Candy," "Turn the Frame off with Wall Candy" or "Run the Frame slideshow with Wall Candy."
A fresh picture every morning
Open Shortcuts, tap Automation, then +. Choose Time of Day and set the time. Choose Run Immediately, then add Hang a Day Card. For photos instead, add Find Photos first (say, your Favorites, limited to five) and then Hang Photos, with The Frame as the screen. That's the whole thing: from then on The Frame changes on its own.
It asks me before it runs
In the automation, choose Run Immediately rather than Ask Before Running. That option arrived with iOS 17; on an older iPhone, Shortcuts always asks.
My phone wasn't home when it was due
The actions need your phone on the same Wi-Fi as the TV, and iOS doesn't go back and run an automation it missed. Add a second automation that hangs again when you arrive home (Arrive, with your home address) or when your phone joins the home Wi-Fi (Wi-Fi, with your network's name). Set it to Run Immediately too.
Waking and sleeping an Apple TV
Wall Candy doesn't need to: Apple's own Shortcuts actions do it. In the same automation, put Wake Apple TV and Open App on Apple TV (choose Wall Candy) before Hang Photos or Hang a Day Card, and make an evening automation with Sleep Apple TV. Those three actions come with Shortcuts on iPhone and iPad; they aren't offered on the Mac. The Apple TV needs to be on the same Wi-Fi and signed in to the same Apple account as your phone.
Day cards
Setting up a day card
A day card is a picture of your day, drawn on your phone and hung like any photo. Its editor has five choices: the kind of card (today's events, the week, the weather, your to-dos, a countdown, or a photo with the date), light or dark paper, the type size, a photo behind it or not, and an accent color. That's all, on purpose: like Notes, you choose bold and size, never the font. Want the full designer, with looks and widgets? That's the Easel in Wall Candy Studio on a Mac.
Which calendars, lists and weather it uses
Choose them in the app, not in Shortcuts: the calendars and Reminders lists to draw from, and the place for the weather. The first time, iOS asks whether Wall Candy may read your calendars and Reminders; it only reads them, and only to draw the card. The forecast comes from Apple Weather for the place you chose.
The card is out of date
A card shows the moment it was drawn, so hang a new one when things change: run Hang a Day Card again, or let a Time of Day automation do it every morning (and at lunch, if your afternoons fill up).
Photo sources
Connecting an Immich server
Create an API key in Immich under Account settings → API Keys. In Wall Candy, open Choose a source → Immich and enter your server's address and the key. Use the server's network name or address (for example, http://my-mac.local:2283), not "localhost," so your iPhone and Apple TV can both reach it.
Google Photos asks me to sign in again
Google sign-ins can expire. Sign in again when asked. If you use Google Photos on your Apple TV too, tap "Send sign-ins" afterward so the TV gets the new sign-in.
Adding the QR code to a picture
For Flickr, museum, NASA and Immich pictures, Wall Candy can put a small QR code in the mat that opens the picture's page. Select the picture and turn on its link switch (for example, "Museum link") in the settings below the preview.
The Apple TV screensaver
Tap the chip at the top, choose Apple TV, and tap "Make the TV screensaver." Wall Candy saves your dressed prints to a "Wall Candy" album in Photos. Then, once, on your Apple TV: sign in to iCloud Photos, open the Screen Saver settings, choose the option that shows your photos, and pick the Wall Candy album. Run it again whenever your collection changes.
Wall Candy Studio on a Mac
Installing Studio
Studio is a free download from eclectek.com/wallcandy/studio, not the Mac App Store. Download the zip, double-click it to unzip, and drag Wall Candy Studio to your Applications folder. It's notarized by Apple, so it opens like any other app. The first launch asks for access to your calendars and Reminders; say yes so it can draw your cards. It needs macOS 14 or later.
Keeping it up to date
Studio updates itself: once a day it checks eclectek.com for a newer build and, when there is one, offers the download in its menu bar panel and at the bottom of Settings › General, where you can also check right away. Unzip the new copy and drag it over the old one in Applications; your settings and schedule stay.
Getting started
Studio lives in the menu bar (the flower). The first time, a welcome window offers three steps: add a screen (Settings › Walls), pick your supplies (Settings › Supplies: calendars, Reminders lists, the weather's place, pictures and news), and make your cards (Settings › Easel). Turn on "Open at login" there or under General: the schedule only runs while Studio is open, so a Mac that stays on and awake is best.
Adding a screen
For a Samsung The Frame, open Walls › The Frame and choose "Find my Frame"; the first time, the TV asks whether to allow Wall Candy Studio. For an Apple TV, open Wall Candy on it, then choose "Add as a screen" in Walls › Apple TVs.
Making cards on the Easel
Your cards are a list: add one from the Add tile (Today, Week ahead, To-do list, Weather, News, a picture with the date, or all in one), reorder them, and switch any off. For the card on the easel, pick a style (paper, a photo, full screen, alongside, frosted, a photo grid, a 1960s living room or just the picture), its look (paper, ink, type, size; the house look unless you give it its own) and its widgets. A card with one big widget, like Today, is drawn big; more widgets share the card. Hang It Now sends them right away; otherwise they go out at the next update.
Channels and the schedule
In the Schedule tab, each screen has a week grid. Click a day to add a change at that time, drag a change's handle to move it, or click it to edit or delete it. Channels are what a screen shows: your dashboard (or a channel with its own cards and look), Family photos from Immich, the pictures hung on the TV itself, or Off.
Countdowns
Add them in Supplies › Calendar under Countdowns: what's coming and the date. They show in a card's footer slot, in the corner, or as a Countdowns widget, until the day passes.
To-dos and names
Pick your Reminders lists in Supplies › To-do. Check things off in the Reminders app; the cards catch up within a minute. Start a to-do with a listed person's name and a colon ("Mia: return library books") and the TV shows a name tag instead.
The Home app, scenes and Siri
Studio can appear in the Home app, so Home automations and scenes can change what's on your TVs without a phone in the loop: screens Off when the last person leaves, the dashboard when someone comes home, family photos at sunset. In Studio, open Settings › Walls › Home app and turn on "Appear in the Home app". Then in the Home app on your iPhone, tap + › Add Accessory › More options…, pick Wall Candy Studio, and type the code Studio shows (or point the camera at it). Each screen shows up as an accessory with a switch for every channel. Turning a switch on shows that channel until the screen's next change on the timetable; turning it off goes to Off. Siri works too: "turn on Living Room Dashboard". It needs Studio from the download (version 1.0 build 5 or later) and a home hub, which any Apple TV or HomePod is.
Off, and waking an Apple TV
When a screen's channel turns Off, The Frame turns its screen off (if the schedule's power switch is on) and Wall Candy on an Apple TV goes dark so the TV can sleep. Studio can wake and sleep an Apple TV itself: in Walls › Apple TVs, choose "Pair…" beside the TV, turn the TV on, and type the 4-digit code it shows. From then on Studio wakes that Apple TV and opens Wall Candy when a channel starts, and puts it to sleep for Off. No Shortcuts automation needed.
The weather doesn't show
Choose a place in Supplies › Weather (type a city, or use your location once). Forecasts come from Apple Weather and refresh with each update.
Free and unlocked
What's free, and what does the unlock add?
Wall Candy is free to try. The free version keeps up to 10 pictures in your collection, and every feature works on them: every source, every screen, every style, day cards, and the Shortcuts actions. Day cards don't count toward the 10. One $7.99 purchase in the iPhone app unlocks everything: no limit on pictures, for good, on all your devices, and it covers Wall Candy TV on your Apple TV. There's no subscription. Wall Candy Studio is a free download.
I bought it on another device, or reinstalled the app
Open the unlock screen and tap "Restore a past purchase." Make sure you're signed in to the App Store with the Apple ID you used to buy it.
Refunds
Apple handles all App Store purchases, so refunds are requested from Apple at reportaproblem.apple.com.
Privacy
Your photos, calendar and to-dos go only to the screens you choose, and Eclectek runs no servers behind the apps. A day card is drawn on your phone, and only the finished picture goes to your TV. Read the full privacy policy.