A useful second life for an iPad.
A native dashboard for Apple Home, photos, and time.
简体中文 · Watch the demo · Build it · Privacy
An existing iPad can serve as an accessible, shared display for everyday home controls, photos, and time. HomeViewPad brings those tasks together without an app account or app-owned server.
HomeViewPad gives a spare iPad a new job: a beautiful Apple Home dashboard, a clock you can read across the room, and a photo frame that finally does something with your albums. Put a HomePod mini beside it—or give them a shared stand—and you've got your own little smart-home corner.
This is an early, MIT-licensed source preview for people comfortable building with Xcode.
AI-generated setup illustration using an actual app screenshot. Demo data shown.
| The part | Its new job |
|---|---|
| An iPad you already have | The screen, the touch controls, and the photo frame. iPadOS 17+. |
| HomeViewPad | Glass widgets, Apple Home controls, clocks, and your albums. Native SwiftUI, MIT licensed. |
| A HomePod mini, if you have one | Siri, supported home-hub functions, and a speaker—through Apple's own features. |
| A stand and a power outlet | The industrial design department. |
The iPad runs the app. HomePod mini works independently in your Apple Home setup; it isn't directly paired with HomeViewPad. Apple Home remains responsible for setup, permissions, and automations. HomeViewPad is a foreground dashboard: it does not provide Siri, household recognition, integrated FaceTime, or Intercom.
Actual iPad simulator recording · Demo accessories · Owner-supplied photos · About 15 seconds
Temperature up. Lights off. A different widget. Then your photos get the whole screen.
A 15-second edit of a fresh simulator recording, with faster playback and the long slideshow waits cut out. All three supplied photos appear; the app itself still rotates albums every 30 seconds. It demonstrates the running interface; real HomeKit and HomePod behavior require separate hardware checks. Recording details →
| A home at a glance | Your photos deserve a bigger audience |
|---|---|
| A large climate tile, five smaller widgets, and soft glass over warm gray or teal. Headers and navigation stay tucked away. | Choose an album or a single photo. The photo wall adds a large clock and gentle crossfades. Your camera roll finally gets a living-room residency. |
| Controls with a purpose | A little less interface |
| Select a home, filter rooms, control supported accessories, and confirm before running a scene. Thermostat arrows follow the device's supported steps and limits. | Swipe between pages and through distinct widget stacks. Position dots appear during switching, then get out of the way. |
Prefer lights out? Overview puts just four square widgets on pure black: date, a numbered analog clock, your album, and weather. White type, yellow accents, no glass. It is now the first page. Release weather comes from Apple WeatherKit; Debug defaults to Open-Meteo and offers a provider switch in the weather panel. Both use Philadelphia by default, your city after Apple Location Services permission, or a city you choose. Tap weather to search, refresh, or switch °C/°F. Demo weather stays fixed and labeled.
Also included: optional HomeKit camera viewing, opt-in calendar and reminders, local audio playback with the system AirPlay picker, and foreground screen-awake mode. Experimental Standby and wake keeps the app unlocked, keeps the dashboard visible at minimum screen brightness, and restores brightness on touch or sound. Sound directly wakes the display by default, with adjustable sensitivity. Optional TrueDepth requires a nearby face after sound; the camera stays off between checks. Demo mode works without accessories and never initializes the real HomeKit manager.
| Do this | Get this |
|---|---|
| Swipe left / right | Overview → Home → Clock → Photos → Settings |
| Swipe up / down inside a widget | That widget's next or previous item |
| Tap empty wallpaper or the photo wall | Navigation: right side in landscape, bottom in portrait |
| Tap temperature arrows | Adjust a supported, writable thermostat target |
Animations respect Reduce Motion. Each widget stack has its own content; your light switch doesn't turn into a second clock.
Bring Xcode. The app isn't on the App Store yet.
git clone https://github.com/kuscholar/HomeViewPad.git
cd HomeViewPad
open HomePad.xcodeprojChoose the HomePad scheme and an iPad simulator running iPadOS 17 or later. Build, run, swipe left to Home, and tap Explore demo. No third-party packages or home accessories required.
Put it on your own iPad
- Copy
Config/Local.xcconfig.exampletoConfig/Local.xcconfig. - Enter your own unique bundle identifier and development team. The local file is ignored by Git.
- Connect your iPad and build with the HomePad scheme. Your account must support HomeKit provisioning; complete Apple's trust and Developer Mode prompts as needed.
- Debug starts with Open-Meteo. Tap weather → Debug weather provider to switch between Open-Meteo and WeatherKit; the choice survives relaunch. Switching clears old readings and results, but keeps your city and units. Failures never silently change providers.
- To test real WeatherKit in Debug, enable WeatherKit under both Capabilities and App Services for your App ID, then add
HOMEVIEWPAD_DEBUG_ENTITLEMENTS = HomePad/HomePad.entitlementsto ignoredConfig/Local.xcconfigand refresh Xcode signing. Default Debug usesHomePadDebug.entitlementsso Open-Meteo development does not depend on WeatherKit provisioning. Release always includes WeatherKit, requires a suitably configured paid developer account, and has no provider picker or Open-Meteo implementation. See WeatherKit setup. - Swipe left to Home, tap Connect Apple Home, grant access, and choose your home. Set up accessories and scenes in Apple's Home app first.
- Open the photo widget to choose one photo or connect an album. Limited Photos permission displays only your allowed images.
HomePod mini is optional. Add it to your home using Apple's Home app; select it in the system AirPlay picker when playing a local audio file. For Apple Music, use Apple's Music app and its system audio routing.
The display name is HomeViewPad; the project, scheme, and source directory retain their original HomePad names. Photos rotate every 30 seconds while Home, Overview, or the photo wall is visible, and pause while a panel is open or the app is inactive.
No app account, app-owned backend, analytics, or tracking SDK. HomeKit, PhotoKit, EventKit, and AirPlay use public Apple APIs and system permissions. Calendar and reminders stay hidden until you opt in.
Release uses Apple services exclusively for weather and city search: WeatherKit and Core Location geocoding. Debug defaults to Open-Meteo weather/geocoding and can switch to Apple WeatherKit in the weather panel. Provider-specific attribution and privacy text follow the selected source. The free Open-Meteo endpoint is for non-commercial development and is compiled out of Release along with the selector; Release ignores saved Debug provider preferences.
Automatic location always uses Apple's foreground permission; automatically detected weather coordinates are rounded to about 1 km and are not saved to disk. Manual city and unit choices are saved locally. Cached/offline readings are labeled. No third-party API key or app-owned backend is needed. WeatherKit includes 500,000 calls per month per paid developer membership (shared across users); commercial apps are supported under Apple's terms, and higher usage needs an appropriate plan. Normal refreshes are limited to once every 15 minutes while visible; no weather refresh occurs during standby or in the background.
Album photos are loaded on demand; iCloud may download them through PhotoKit. A single imported photo is stored in the app sandbox. The app never edits your Photos library. A shared screen is still a shared screen: anyone nearby can see the content you choose to display. Data lifecycle →
The small print, in normal-sized words
This is an early independent project, not an Apple product or a replacement for Apple Home. HomeViewPad is not a home hub and cannot access a HomePod microphone, host Siri, send Intercom messages, or embed FaceTime.
It does not create automations or directly edit locks, blinds, or thermostat modes. Existing scenes can contain those actions, so scene execution always asks for confirmation. There is no Apple Music catalog integration or background camera recording. Standby is opt-in under Settings → Standby and wake. It cannot unlock iPad or reopen the app. Enabling standby requests the needed permissions. Missing permissions or microphone failures keep or restore normal brightness and show the reason. The microphone runs while dimmed; TrueDepth checks use the front image and depth for up to three seconds, with system privacy indicators. Quiet arrivals can be missed, and real-device detection, power use, and dark-room performance remain unverified. Devices without TrueDepth can use Sound or touch; there is no regular-camera fallback.
Simulator tests cover app logic and interface flows. Real accessory compatibility, camera streaming, AirPlay, and long-running wall-display behavior still require hardware validation. What we've actually tested →
The badge reports the remote workflow, not hardware readiness. CI runs Debug unit/UI checks, Release weather regressions, and an unsigned device build. Three live weather/geocoding tests are separate opt-in checks. See actual results and toolchains, hardware checks, and source-release instructions. No App Store version or signed downloadable binary is provided.
Start with CONTRIBUTING.md for a fresh simulator, synthetic photos, test modes, and PR expectations. The roadmap lists bounded contribution opportunities. Please follow our code of conduct, report vulnerabilities privately, and read the changelog.
Bug reports and focused improvements are welcome. Include your iPad model, iPadOS version, reproduction steps, and whether you're using demo mode or a real home. Remove personal photos, home identifiers, and signing information from reports.
Build, test, and record a demo
Requires macOS and Xcode with an installed iPadOS simulator runtime. See validated toolchains.
xcrun simctl list devices available
python3 scripts/seed_test_photos.py SIMULATOR_UUID
sh scripts/test.sh SIMULATOR_UUID
python3 scripts/record_demo.py SIMULATOR_UUIDUse a dedicated simulator containing only approved recording photos; synthetic fixtures are available for routine tests. Raw videos, logs, and results stay in ignored .validation/.
Regenerate the project with python3 scripts/generate_project.py after adding source files. This overwrites generated settings but preserves the separate, ignored Config/Local.xcconfig. Keep personal signing overrides there.
Launch arguments: --demo, --state denied|empty|offline|loading, --far, and --fresh. --state applies only in demo mode.
Follow AGENTS.md: public APIs, original or licensed assets, no employer code or private services. Actual commits are restricted to after 22:00 on weekdays or anytime on weekends in America/New_York. Check with python3 scripts/commit_guard.py; never alter timestamps. Enable the optional hook with git config core.hooksPath .githooks.
Give that iPad a room with a view.
Built with SwiftUI, spare hardware, and a healthy respect for a good stand.
MIT license · Architecture · Validation · Media credits
Apple, iPad, HomePod mini, HomeKit, and AirPlay belong to Apple Inc. HomeViewPad is an independent project, not affiliated with or endorsed by Apple or other similarly named products. The DIY comparison describes overlapping use cases, not feature parity.
