User Manual
Everything you need to set up, personalize, and get the most out of Fravora, from first launch to advanced gestures and voice workflows.
🚀 Quick Start
Go from install to your first running slideshow in five first-launch onboarding steps:
- Open Fravora and complete first-launch onboarding. You can replay it anytime from Settings → Support → Replay Onboarding.
- During onboarding, choose at least one photo source: local folder, SMB/NAS share, Google Photos, Microsoft OneDrive, Dropbox, or Immich.
- Finish onboarding album setup by creating your first album and attaching your selected folders or cloud collections.
- In Settings → Slideshow, set your preferred interval, display mode, and optional running hours.
- Return to the frame view. The slideshow starts automatically once images are found.
If nothing appears, check the in-app guidance cards. They explain missing albums, empty sources, or sources that have not been scanned yet.
🗂️ Sources
Sources define where your photos come from. Fravora supports local folders, network shares, and cloud services. Add your sources first, then attach them to albums.
Network Shares (SMB / NAS)
- Host/share format is
hostname/sharename(nosmb://prefix required). - Test connection checks host/share path and credentials before saving.
- Username and password are optional, including guest access and domain-qualified users.
- After connecting, select one or more folders from the share to activate it.
- Network Retry Count controls how many times Fravora retries failed image loads before marking them unavailable.
Local Folders
Add folders from internal storage, SD card, or USB media using Android's system picker. Fravora stores only the access grants required for playback.
PRO: Albums can reference multiple local folders. Free tier is limited to one local folder per album.
Cloud Sources
Supported cloud providers are Google Photos, Microsoft OneDrive, Dropbox, and Immich. The source flow is unified, so setup is consistent across providers.
- Free tier includes one cloud connection with base limits.
- PRO expands cloud limits across all supported providers.
- You can re-link or switch cloud accounts without rebuilding all albums.
Cache & Storage
- Image Cache Size: 128 MB to 2 GB with automatic pruning.
- Low Storage Alert: warns when configured cache exceeds available storage.
- Scan Interval (PRO): 5 to 120 minutes for periodic source refreshes.
- Google Photos headroom: reserves device free-space before downloading cloud items.
- Clear Cache: available for image cache and Google Photos cache.
🖼️ Albums
Albums are the playback collections Fravora scans for slideshow images. You can create multiple albums and enable or disable each one independently.
- Create album: name it, then attach SMB folders, local folders, and/or cloud collections.
- Enable for playback: only enabled albums are included in slideshow rotation.
- Include subfolders: recursive folder scanning for deeper imports (PRO).
- Image counters: each album shows visible, hidden, and total image counts.
- Hidden photos: hide photos globally or per album and restore them later from Settings → Albums → Hidden photos.
If all photos in enabled albums are hidden, Fravora shows a blank slideshow until some images are unhidden.
▶️ Slideshow
Playback settings
- Photo Interval: 10 to 600 seconds.
- Image Order: Date Added, Taken Date, Album Order, File Name, Random, or Smart Shuffle (PRO).
- Smart Shuffle (PRO): reduces back-to-back similar shots by recognizing burst-like file/time patterns.
- Display Mode: Fit (no crop) or Fill (edge crop).
- Image Backdrop Style (PRO): styles empty letterbox areas in Fit mode.
- Transition Effects: Free is hard cut only; PRO adds 10+ transitions and transition speed control.
Running hours & standby
- Daily running window with start/end times.
- Custom day-by-day schedule support.
- Standby style outside running hours: large clock or full black screen.
- Bouncing standby clock for OLED burn-in reduction (PRO).
If an SMB share goes offline, Fravora continues with reachable sources and cached photos, then exposes quick Retry/Open Sources actions when intervention is needed.
🎨 Appearance
- App Theme: System, Light, or Dark.
- App Color Scheme (PRO): seven complete UI themes.
- App Language: follow system language or force a selected language.
- App Font Size (PRO): Small, Medium, or Large.
- Fullscreen Mode: hides system bars for a true frame look.
- Keep Screen Awake: prevents sleep while Fravora is foregrounded.
- TV Compatibility: supports Android/Google TV and Amazon Fire TV launchers.
- Settings Photo Background (PRO): blurred current photo as Settings backdrop.
✨ Overlays
Overlays are information layers shown on top of photos during playback. Each one can be enabled, sized, and positioned independently.
- Clock: configurable time/date display (free).
- Weather: live local weather overlay with forecast details (PRO).
- Photo metadata: taken date, location, and landmarks from EXIF (PRO).
- Now Playing: scrolling station/song info while audio is active (PRO).
- Ambient logo: pulsing Fravora icon and quick audio control target (PRO).
- Photo index: current position indicator, such as 42 / 500 (PRO).
- Anti burn-in: micro-shifts overlays and adjusts opacity over time (PRO).
Overlay Layout (PRO): assign weather, clock, metadata, and logo to a 2x2 corner grid with collision-safe placement. On Free, clock position remains fixed.
🎵 Audio
Audio has two tabs: Radio for internet streams and Music for local playlists. Both share running-hours scheduling, background playback options, and media controls.
Radio (Free + PRO)
- Search by station name, genre, language, or country. Free has a daily search cap.
- Play/Pause/Stop controls are always available.
- Free keeps station selection during the current app session; PRO persists across restarts.
- PRO unlocks favorites, recently played history, advanced filters, unlimited search, and auto-play options.
- PRO enables background playback and lockscreen/notification media controls.
- Fravora marks failed stations in-session so unstable streams are easy to avoid.
Music playlists (Free + PRO)
- Free supports one playlist; PRO supports unlimited playlists.
- Add whole folders recursively or individual files (MP3, M4A, AAC, FLAC, OGG, OPUS, WAV, AMR).
- Manual refresh reports Added/Removed/Re-linked tracks.
- Free keeps deduplication always on; PRO can disable deduplication.
- PRO adds automatic background scanning with configurable intervals and expanded sort modes.
If a station fails, Fravora surfaces the reason directly: timeout, network issue, access denied, unavailable stream, or unsupported format.
🎙️ Voice Control
PRO feature. Voice control requires microphone permission and an Android speech recognition service (typically Speech Services by Google).
Setup
- Install and set Speech Services by Google (or another voice service) as default voice input.
- Grant microphone permission in Settings → Voice.
- Enable Voice Control and complete the first-time safety disclaimer acknowledgement.
- Choose wake phrase and optional feedback sound, then enable command categories you want.
Command behavior
- Wake phrases: Hello Frame and Hello Fravora.
- Supports slideshow, radio/music, volume, and disable-voice commands.
- Wait for follow-up keeps listening briefly for multi-step interactions.
- Command window is adjustable (3 to 7 seconds).
- Runtime feature gating executes commands only when corresponding Voice toggles are enabled.
- Video audio can pause/duck automatically while listening and resume after recognition.
Visual feedback: blue frame means listening, green means command accepted, red means recognition unavailable/failed.
💬 Support
- User Manual: open from Settings → Support → User Manual.
- Report an Issue: sends a detailed email report with app/device version context.
- Feature Request: submit product ideas directly from the app.
- Check for Updates: routes to Google Play or Amazon Appstore automatically by build flavor.
- Release Notes: review version changes in-app or on the website archive.
- Roadmap: view planned features and active known issues.
- Replay Onboarding: restart the complete onboarding flow anytime.
Support contact: aniujual.dev@yahoo.com. For policies, see Privacy and Data Deletion.
🖐️ Frame Interactions
Fravora includes touch and overlay interactions that are faster than opening settings for frequent actions.
Slideshow gestures
- Single tap opens the in-frame menu (when not zoomed).
- Double tap toggles 2x zoom around the tap point, then resets.
- Pinch-to-zoom and one-finger pan work for detailed inspection.
- Swipe left/right navigates photos; swipe is locked while zoomed to avoid accidental skips.
Overlay interactions & status
- Ambient logo single tap toggles audio play/pause; double tap opens station search.
- Weather overlay opens detailed forecast views.
- Clock/date overlay opens full-screen calendar (PRO).
- Zoom navigator mini-map appears while zoomed.
- Badges indicate network outages, app updates, Google Photos storage state, and newly discovered images.
🌦️ Weather Forecast
PRO feature. Tap the weather overlay in frame view to open full-screen forecast details.
- 24-hour hourly strip plus 7-day daily forecast cards.
- Swipe navigation inside hour/day detail views.
- Forecast colors adapt to app theme and weather context.
- Slideshow timer pauses while forecast is open and resumes after close.
📅 Calendar
PRO feature. Tap the clock/date overlay in frame view to open the full-screen calendar.
Views & events
- Month swipe navigation and day-detail browsing.
- Configurable week start for month grid layout.
- Create, edit, and delete events with all-day support.
- Recurring events with edit scopes and skip-date exclusions.
- Per-event reminders: digest, 1-hour, and 15-minute options.
- Reminder actions include Snooze, Dismiss, Delete, and Close.
- Long-press day multi-select with bulk delete for faster cleanup.
⭐ Free vs PRO
The free tier is fully usable for daily photo frame operation. PRO removes limits and unlocks advanced capabilities with a one-time purchase (no subscription).
Free includes
- Uninterrupted slideshow, scheduling, and one album/source baseline setup.
- Local folders, NAS/SMB support, and one cloud connection baseline.
- Clock overlay, hidden-photo controls, and core radio playback/search.
PRO unlocks
- Expanded source/album/cloud limits and recursive include-subfolders.
- Smart Shuffle, transition effects, transition speed, and backdrop styles.
- Weather/metadata/now-playing/ambient overlays plus anti burn-in.
- Background audio, favorites/history, advanced station filters, and unlimited music playlists.
- Voice control, calendar, color schemes, font sizing, and advanced UI controls.
Temporary PRO can also be enabled via rewarded ads. When temporary PRO expires, PRO preferences are preserved and restored automatically on reactivation.