Add README.md file

2026-10-14 00:30:55 +00:00
1 parent ca5daf8d16
commit b00e3c4330
@@ -0,0 +1,70 @@
+# Hearthframe
+
+Turn any spare tablet or old phone into a cozy family photo frame with a clock and caption in one minute — no accounts, no uploads, no subscription.
+
+![Hearthframe Preview](data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNjAwIiBoZWlnaHQ9IjQwMCIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBmaWxsPSIjZjBmMGYwIi8+PHRleHQgeD0iNTAlIiB5PSI1MCUiIGZvbnQtZmFtaWx5PSJBcmlhbCIgZm9udC1zaXplPSIxOCIgZmlsbD0iIzMzMyIgdGV4dC1hbmNob3I9Im1pZGRsZSIgZG9taW5hbnQtYmFzaWxpbmU9Im1pZGRsZSI+SGVhcnRoZnJhbWUgUHJldmlldzwvdGV4dD48L3N2Zz4=)
+
+## What is Hearthframe?
+
+Hearthframe is a free, browser-based tool that transforms any device into a beautiful digital photo frame. Simply drop in photos from your device, choose a frame style, add a caption, and enjoy a full-screen slideshow with a clock display.
+
+Everything works entirely in your browser - no photos are uploaded to any server, no accounts are required, and no subscription is needed.
+
+## Who is it for?
+
+Hearthframe is designed for adult children setting up family photos for a parent. It's perfect for anyone who wants to repurpose an old tablet or phone as a dedicated photo frame without the hassle of dealing with consumer photo frames that demand apps, cloud accounts, and ongoing tech support.
+
+## How to use it
+
+1. Open [hearthframe.yolopreneur.lol](https://hearthframe.yolopreneur.lol/) on any device
+2. Drag photos from your device or click to select files
+3. Choose a frame mat, clock style, and transition effect
+4. Add a caption for your slideshow
+5. Click "Preview Full Screen" and use your browser's full-screen mode
+6. Adjust your device's settings to prevent sleep mode if needed
+
+For continuous operation on a tablet:
+- Enable "Stay Awake" in developer options to prevent the screen from turning off
+- Adjust screen timeout settings to "Never" or the longest duration available
+
+## Features
+
+- **No uploads**: All processing happens locally in your browser
+- **No account required**: Use it immediately without signing up
+- **No subscription**: Completely free to use
+- **Self-contained HTML file**: Download your frame to reopen later
+- **Multiple frame styles**: Choose from classic wood, modern black, vintage tan, or minimalist white
+- **Customizable clock**: Digital time or date & time display
+- **Transition effects**: Fade, slide, or instant transitions
+- **Personal captions**: Add meaningful text to your slideshow
+
+## Honest limits
+
+Hearthframe is intentionally simple and focused:
+
+- No automatic photo syncing - you need to manually update the frame
+- No cloud storage - all photos must be stored locally on the device
+- No multi-user collaboration - only one person can manage the frame
+- No advanced scheduling - photos rotate at fixed intervals
+- No mobile app - only browser-based solution currently available
+
+## Next version (early access)
+
+A paid Android app version is planned with:
+- Installable Android frame app
+- Family album links for relatives to add photos
+- Scheduled photo updates
+- Remote captions sent to the frame
+- Multiple frames under one login (Caregiver plan)
+- Per-frame schedules and remote-caption queues (Caregiver plan)
+
+[Join early access](https://github.com/teahubxyz/time/issues/new?template=early-access.yml&title=Early+access%3A+Hearthframe&venture=hearthframe&plan=Family+%28early+access%29) for future updates.
+
+## Built with
+
+- Pure HTML, CSS, and JavaScript
+- Works entirely in the browser
+- No external dependencies
+- No frameworks or libraries
+
+Try it now at [hearthframe.yolopreneur.lol](https://hearthframe.yolopreneur.lol/)