📖 Documentation
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.
01
Quick Start
Go from install to your first running slideshow in five steps:
1
Open Fravora and complete onboarding. You can replay it anytime from Settings → Support → Replay Onboarding.
2
Go to Settings → Sources and add at least one photo source — local folder, SMB/NAS share, Google Photos, Microsoft OneDrive, Dropbox, or Immich.
3
Go to Settings → Albums, create an album, and attach the source folders or collections you added.
4
In Settings → Slideshow, set your preferred photo interval, display mode, and optional running hours.
5
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 haven't been scanned yet.
02
Sources
Sources define where your photos come from. Fravora supports local folders, network shares, and cloud services. Start by adding sources, then attach them to albums.
Network Shares (SMB / NAS)
Connect to any SMB-compatible NAS or shared folder on your local network.
Host / ShareEnter in
hostname/sharename format — no smb:// prefix needed.Test ConnectionVerify host/share path and credentials before saving to catch access issues early.
CredentialsUsername and password are optional — leave blank for guest access. Domain-qualified users are supported.
FoldersAfter connecting, choose one or more folders from the share. A share with no selected folders stays inactive.
Network Retry CountHow many times Fravora retries a failed image load before marking it unavailable. Increase for unstable networks.
Local Folders
Add folders stored directly on the device using Android's system file picker. You will be prompted to grant folder access.
External storage such as SD cards and USB drives is supported through Android's storage access framework.
PRO: Albums can reference multiple local folders. Free tier is limited to one local folder per album.
Cloud Sources
Fravora supports cloud providers through a unified source flow. Supported cloud sources are Google Photos, Microsoft OneDrive, Dropbox, and Immich.
Cloud providers
Connect Google Photos, OneDrive, Dropbox, or Immich and choose the media items, folders, or albums you want to include in playback.
Unified limits
Free tier includes one cloud connection with base limits. PRO expands cloud limits across all supported cloud providers.
Cloud account management lets you switch or re-link services without rebuilding albums. Free tier supports one cloud connection; PRO expands cloud limits.
Cache & Storage
Image Cache SizeControls how much local storage is used for the resized image cache. Range: 128 MB to 2 GB with automatic pruning of older entries.
Low Storage AlertFravora warns you if your configured cache target exceeds currently available device storage.
Scan IntervalHow often Fravora rescans all enabled sources for new or removed photos. Range: 5 to 120 minutes.PRO
Google Photos headroomReserves free-space on your device before downloading Google Photos images, protecting against storage exhaustion. Includes status feedback and warning icons when your target exceeds available space.
Clear CacheAvailable for both standard image cache and Google Photos cache. Useful if old picks are no longer needed or the cache grows too large.
03
Albums
Albums are the playback collections Fravora scans for slideshow images. You can create multiple albums and turn each one on or off independently.
Create albumGive the album a name, then attach SMB folders, local folders, and/or cloud collections to it.
Enable for playbackOnly enabled albums are included in the slideshow. Toggle albums on/off without deleting them.
Include subfoldersRecursively scan nested folders within the attached source. PRO tier only.
Image countersEach album shows visible / hidden / total image counts so you can verify the configuration.
Hidden photosHide individual photos per-album or globally without deleting them. Unhide anytime from Settings → Albums → Hidden photos.
Hidden managerBrowse hidden photos as thumbnails, select multiple items, and unhide selected photos or unhide all at once.
If all photos in your enabled albums are hidden, Fravora will show nothing. Go to Hidden photos to unhide some images.
When importing from Google Photos, Fravora warns you if any selected picks are already hidden and excludes them automatically.
04
Slideshow
Playback Settings
Photo IntervalHow long each photo is displayed. Range: 10–600 seconds.FREE
Image OrderDate Added, Taken Date, Album Order, File Name, Random, or Smart Shuffle (PRO).
Smart ShuffleIntelligent shuffle that reduces back-to-back similar shots by detecting burst-style filenames and close capture times.PRO
Display ModeFit — shows the full image with no cropping. Fill — fills the screen, may crop edges.FREE
Image Backdrop StyleIn Fit mode, styles the empty letterbox/pillarbox area for a cleaner frame look. Hidden when Display Mode is Fill.PRO
Transition EffectsFree tier runs without transitions. PRO unlocks Slide, Cube, Zoom, Crossfade, Depth, Parallax, Accordion, Vertical Slide, Card Deck, and Random.PRO
Transition SpeedChoose animation pace for transitions: Slow, Medium, or Fast.PRO
Scan IntervalHow often Fravora rescans sources for new or removed photos (5 to 120 minutes).PRO
Running Hours & Standby
Set a daily active window for your frame. Outside those hours, Fravora switches to standby mode.
Running HoursEnable a daily start/end window. The slideshow only runs during this window.FREE
Custom Daily ScheduleSet different start/end times per day of the week.FREE
Screen SaverOutside running hours, shows a large standby clock or a fully black screen.FREE
Bouncing ClockStandby clock bounces around the screen to prevent burn-in on OLED/AMOLED displays.PRO
Reliability
If an SMB share goes offline, Fravora continues the slideshow with reachable sources. After repeated failures a connection warning overlay appears — tap Retry or Open Sources to fix the issue.
05
Appearance
App ThemeSystem (follows Android setting), Light, or Dark.FREE
App Color SchemeChoose from seven complete UI themes: Amethyst, Dark Blue & Yellow, Slate & Cyan, Graphite & Copper, Warm Gallery, Midnight OLED, and Monochrome Ink.PRO
App LanguageFollow system language or force a specific language. Applied immediately at runtime.FREE
App Font SizeAdjust text size across the app interface (Small, Medium, Large).PRO
Fullscreen ModeHides the status bar and navigation bar for a true frame look.FREE
Keep Screen AwakePrevents the device from sleeping while the app is in the foreground.FREE
TV CompatibilitySupports Android/Google TV and Amazon Fire TV launchers.FREE
Settings Photo BackgroundUses a blurred version of the current slideshow image as settings backdrop.PRO
06
Overlays
Overlays are information layers displayed on top of your photos during playback. Each one can be positioned, sized, and toggled independently.
Overlay Types
ClockShows the current time with configurable size and time/date format.FREE
WeatherLive local weather overlay. Requires location permission.PRO
Photo metadataShows taken date, location, and available landmark names from EXIF data. Processed locally.PRO
Now PlayingScrolling marquee with current station and song information while radio is active.PRO
Ambient logoPulsing Fravora icon that also acts as a quick radio interaction target.PRO
Photo indexShows current photo position in album (for example 42 / 500) with independent sizing controls.PRO
Anti burn-inPeriodically micro-shifts overlays and varies opacity to protect OLED displays.PRO
Overlay Layout (PRO): Assign weather, clock, metadata, and ambient logo across a 2x2 corner grid with collision-safe swaps and optional hide state.
On Free, the clock is fixed to the bottom-right. The position controls are visible but locked until PRO is active.
07
Radio
Fravora includes built-in internet radio that plays alongside your slideshow. Find stations by name, genre, or country in seconds.
Basic Playback (Free)
SearchSearch for stations by name, genre, language, or country. Free tier has a daily search limit.FREE
Play / Pause / StopManual controls available at all times during the session.FREE
Session persistenceCurrent station is remembered during the session but cleared when the app restarts.FREE
Favorites listFavorites remain visible in the UI but are locked on Free.FREE
Recently played listRecently played history remains visible in the UI but is locked on Free.FREE
PRO Radio Features
Station persistenceYour last station is remembered across app restarts — no need to search again.PRO
FavoritesSave stations to a favorites list for quick access.PRO
Unlimited searchNo daily search limit.PRO
Advanced filtersFilter by country code, language, genre tag, and minimum bitrate to find better streams faster.PRO
Recently playedHistory of the last 3 stations (deduped by URL) with per-item remove actions in Settings → Radio.PRO
Station failure trackingSession-only warning icons appear next to stations that failed to play, helping you quickly spot unstable streams.
Auto-play on selectTapping a station in search results starts playback immediately.PRO
Auto-play on app startOptionally resume radio automatically when Fravora launches.PRO
Background playbackRadio keeps playing when the screen turns off or another app is in the foreground.PRO
Lockscreen controlsPlay/pause and previous/next station from the Android notification shade and lockscreen.PRO
Radio Running HoursSet when radio auto-starts and stops, with optional per-day custom schedules.PRO
If a station fails to load, Fravora shows the specific reason: timeout, network issue, access denied, unavailable stream, or unsupported format. Try a different station or check your connection.
08
Voice Control
PRO feature. Voice control requires microphone permission and an Android speech recognition service (typically Speech Services by Google).
Setup
1
Make sure Speech Services by Google (or another speech recognition service) is installed and set as the device voice input in Android Settings → General Management → Language and Input.
2
In Fravora, go to Settings → Voice and grant microphone permission when prompted.
3
Enable the Voice Control master toggle and review the activation disclaimer. First-time enable includes a mandatory 3-second acknowledgement lock.
4
Choose your wake phrase, optional wake feedback sound, and the feature toggles you want (radio, slideshow, assistant). Say the wake phrase and you will see a blue listening frame.
Safety check (first enable): Voice Control shows a mandatory disclaimer with a brief acknowledgement lock before activation.
Wake Phrases
Hello FrameDefault wake phrase. Processed entirely on-device using OpenWakeWord.
Hello FravoraAlternative wake phrase. Same on-device processing.
Command Categories
Radio play commandsExamples:
play/start/turn on/switch on/resume/unpause/begin/launch/enable/activate/open/run radio.Radio stop commandsExamples:
stop/pause/turn off/switch off/end/close/disable/deactivate radio.Slideshow commandsExamples:
play/start/turn on/resume slideshow and pause/stop/turn off/end slideshow.Assistant volume commandsExamples:
increase volume, decrease volume, set volume to 40, mute, and unmute.Disable voice controlExamples:
stop/disable/turn off/switch off/end/close/deactivate voice control (also works with voice shorthand).Command Behavior
Wait for follow-upKeeps listening briefly after a command so you can issue another one without saying the wake phrase again.
Command windowAdjust how long Fravora listens for a command (3 to 7 seconds).
Runtime feature gatingRadio, slideshow, and assistant commands only run when their corresponding Voice settings toggles are enabled.
Parsing Rules
English-onlyVoice commands are currently parsed in English.
Noun-qualifiedCommands should include the target, for example
play radio rather than only play.Fuzzy matchingWake phrases tolerate slight variations, and command parsing accepts common filler words like
stop the radio.State-aware alternativesWhen speech alternatives conflict (for example start vs stop), Fravora chooses based on the current runtime state.
Visual Feedback
Blue frameFravora is listening for a command.
Green frame + soundCommand was recognized and acted on.
Red frame + soundSpeech recognition is unavailable or failed.
If no station is configured and you say "play radio", Fravora opens Settings → Radio automatically so you can pick one.
09
Support
Support Tools
User ManualOpen Settings → Support → User Manual for direct access to this documentation from inside the app.
Report an IssueUse Settings → Support → Report an Issue to send a detailed bug report by email, including device and app version details.
Feature RequestUse Settings → Support → Feature Request to share ideas for improvements or new features.
In-frame update alertsUpdate availability can appear in the in-frame notification strip with periodic checks and per-version acknowledgement to avoid repeated prompts.
Check for UpdatesUse Settings → Support → Check for Updates to verify you have the latest version. Store routing is automatic (Google Play or Amazon Appstore, depending on build flavor).
Release NotesOpen Settings → Support → Release Notes to review what changed in your currently installed version, or browse the website release archive at Release Notes.
RoadmapOpen Settings → Support → Roadmap to see planned features and known issues under active work.
Replay OnboardingRe-run the 8-step first-launch onboarding flow anytime from Settings → Support → Replay Onboarding.
You can also reach the developer directly at aniujual.dev@yahoo.com. For privacy details, see the Privacy Policy. To request data deletion, visit Data Deletion.
10
Frame Interactions (Hidden Gems)
Beyond Settings, Fravora includes touch gestures and overlay actions that make daily use faster and smoother.
Slideshow Gestures
Single tapOpens the in-frame menu when you are not zoomed in.
Double tapToggles zoom at the tapped position (2x), then resets back to full view.
Pinch-to-zoomSmoothly zoom in or out on any image.
Pan while zoomedDrag the image with one finger to inspect details.
Swipe left / rightMove to the next or previous photo. Swipe is locked while zoomed to prevent accidental skips.
Overlay Interactions
Ambient logo tapSingle tap toggles radio play/pause.
Ambient logo double tapOpens radio station search immediately.
Ambient logo animationThe icon breathes during playback and subtly pulses with bass intensity.
Weather overlay tapOpens a detailed weather forecast overlay with 24-hour and 7-day views.
Clock/date overlay tapOpens the full-screen calendar overlay.PRO
In-Frame Menu
SettingsQuick shortcut to the full settings menu.
Hide photoHide the current image from the active album only, or globally from all albums.
Close appFully exits Fravora from frame view.
Status & Alerts
Zoom navigatorMini-map appears while zoomed, showing the full image and your current viewport.
Network warning badgeAppears when one or more SMB shares are unreachable. Tap to list failed shares.
Update available badgeThe in-frame notification strip can display app update availability and route update actions to the correct store for your build.
Google Photos storage statusCloud status icons indicate import state: red for blocked/pending, yellow + count for partial recovery, and green + count for full recovery.
Blocking network overlayFull-screen warning appears if Fravora cannot load any photo due to network failures.
New images badgeNotification strip appears when new photos are discovered during a scan.
New Images Overlay
Discovery badgeA notification-strip badge appears when periodic scans detect newly added photos.
Tap-to-open viewerTapping the badge opens a dedicated viewer for newly discovered items.
Session-aware dismissalClosing the viewer acknowledges and clears the current new-image notification set.
Order-aware integrationNew items are integrated without duplicating photos already queued in random-order playback.
Scope safetyScope-changing refreshes clear stale discovery buffers so out-of-scope photos are not shown as new.
11
Weather Forecast
PRO feature. Tap the weather overlay in frame view to open full-screen forecast details.
Views & Navigation
Tap-to-open forecastOpen forecast details directly from the weather overlay.PRO
24-hour forecastHourly forecast strip for the next 24 hours.
7-day forecastDaily forecast cards with weather-adaptive styling.
Swipe navigationSwipe left/right inside hour/day detail views across visible forecast bounds.
Forecast Details
Weather-adaptive stylingForecast UI colors blend with the active app theme and current weather tone.
Rich forecast dataTemperature, precipitation probability, wind, humidity, UV, and day/night context.
Localized labelsHour/day labels follow your configured clock/date formatting preferences.
Runtime Behavior
Top-level overlayForecast opens above slideshow content in full-screen mode.
Slideshow pause integrationWhile forecast is open, slideshow timing is paused and resumes when closed.
12
Calendar
PRO feature. Tap the clock/date overlay in frame view to open the full-screen calendar.
Views & Navigation
Tap-to-open calendarOpen calendar directly from the date/time overlay while viewing photos.PRO
Month navigationSwipe left or right to move between months.
Day detailsOpen a day and swipe within the visible day range.
Week start preferenceMonth grid follows the configured first day of week.
Events & Reminders
Event CRUDCreate, edit, and delete events.
All-day supportAll-day toggle with timed-range restore when switched back off.
RecurrenceRecurring events with edit scopes (this occurrence, this and following, whole series) and skip-date exclusions.
Per-event remindersDigest, 1-hour, and 15-minute reminder options.
Reminder actionsSnooze, Dismiss, Delete, and Close from the reminder summary dialog.
Calendar UX Enhancements
Day multi-selectLong-press enters multi-select mode with bulk Delete selected action.
Scroll-stable selectionSelecting events does not jump scroll position in day view.
Change-aware saveEvent editor Save stays disabled until draft changes are made.
13
Free vs PRO
The free tier is genuinely usable. PRO removes limits, unlocks advanced features, and is a one-time purchase with no subscriptions.
Try PRO for free: Watch an optional rewarded ad for +15 minutes of temporary PRO access. Up to 4 ads per day, stackable. No purchase required.
| Feature | Free | PRO |
|---|---|---|
| Sources & Albums | ||
| Total source entries | 1 | Expanded |
| Albums | 1 | Expanded |
| Local folders per album | 1 | Multiple |
| SMB folders per album | 1 | Multiple |
| Cloud connections | 1 connection | Expanded |
| Cloud target assignments per album | 1 | Expanded |
| Include subfolders (recursive) | — | ✓ |
| Scan interval control | — | ✓ |
| Low storage cache alerts | ✓ | ✓ |
| Slideshow | ||
| Uninterrupted slideshow | ✓ | ✓ |
| Smart Shuffle order | — | ✓ |
| Image backdrop style (Fit mode) | — | ✓ |
| Transition effects | None only | 10+ effects |
| Transition speed control | — | ✓ |
| Running hours scheduling | ✓ | ✓ |
| Bouncing standby clock | — | ✓ |
| New images overlay badge & viewer | ✓ | ✓ |
| Radio | ||
| Search & play stations | ✓ (limited) | ✓ unlimited |
| Station persistence | Session only | Across restarts |
| Favorites | Visible (locked) | ✓ |
| Advanced search filters | — | ✓ |
| Recently played | Visible (locked) | ✓ |
| Station failure tracking | ✓ (session) | ✓ (session) |
| Background playback | — | ✓ |
| Lockscreen media controls | — | ✓ |
| Radio running hours | — | ✓ |
| Overlays | ||
| Clock overlay | ✓ (fixed position) | ✓ (any position) |
| Weather overlay | — | ✓ |
| Photo metadata (date/location) | — | ✓ |
| Now Playing overlay | — | ✓ |
| Photo index overlay | — | ✓ |
| Ambient logo indicator | — | ✓ |
| Overlay positioning | — | ✓ |
| Anti burn-in effect | — | ✓ |
| Full-screen weather forecast (24h/7d) | — | ✓ |
| Tap-to-open calendar from clock/date | — | ✓ |
| Event editing, recurrence & reminders | — | ✓ |
| Appearance | ||
| App font size control | — | ✓ |
| App color scheme | — | ✓ |
| TV launcher compatibility | ✓ | ✓ |
| Controls | ||
| Voice control | — | ✓ |
| Assistant volume voice commands | — | ✓ |
| Voice activation disclaimer | — | ✓ |
| Unlock PRO | ||
| Rewarded ad (+15 min) | ✓ up to 4/day | — |
| One-time purchase | — | ✓ |
When PRO expires, all PRO settings revert to Free defaults — but a snapshot is saved. When you reactivate PRO, your previous settings are automatically restored.
14
FAQ & Troubleshooting
What is the fastest way to set up Fravora?
- Add at least one source in Settings → Sources.
- Create an album in Settings → Albums and attach source folders.
- Enable the album for playback.
- Set photo interval and display mode in Settings → Slideshow.
How do I use hidden frame features like zoom, panning, and quick radio controls?
In frame view, these shortcuts work as "hidden" interactions:
- Double tap to zoom, pinch to zoom smoothly, and drag to pan while zoomed.
- Ambient logo: single tap toggles radio play/pause, and double tap opens station search.
- Weather overlay: tap to open detailed weather forecast (24-hour and 7-day views, PRO).
- Clock/date overlay: tap to open the full-screen calendar (PRO).
- New images badge: tap to open the new-images viewer when fresh photos are detected.
No photos are showing
- Confirm at least one album exists and is enabled for playback.
- Check that the album has at least one source folder attached.
- If photos are in nested folders, enable Include subfolders (PRO for SMB).
- Wait for the initial scan to complete — large folders take a moment.
All photos are hidden / slideshow is blank
Go to Settings → Albums → Hidden photos and unhide the images you want to show. Album counters display visible/hidden/total counts to help identify the issue.
SMB / NAS share won't connect
- Verify the host/share path — use
hostname/sharenameformat with nosmb://prefix. - Check your credentials. Try guest access (blank username/password) if the share allows it.
- Increase Network Retry Count in Sources for unstable network links.
- Ensure the device is on the same local network as the NAS.
Google Photos import is blocked or storage keeps filling up
- Free up storage space on the device.
- Increase Google Photos headroom in Sources to reserve more free space.
- Clear the Google Photos cache from Sources settings if old picks are stale.
- Watch cloud status icons in the frame notification strip: red means blocked, yellow means partial recovery, green means fully recovered.
Radio station won't play
Fravora shows the specific failure reason: timeout, network issue, access denied, unavailable stream, or unsupported format. Try a different station if the stream is down, or check your internet connection.
Why do some stations show warning icons in Radio settings?
Those are session-only station failure indicators. They mark stations that failed during the current app run so you can avoid unstable streams quickly.
Voice control won't enable or hears only one command
- Install Speech Services by Google from the Play Store if it's not already present.
- Set it as the default voice input: Android Settings → General Management → Language and Input → Voice Input.
- Grant microphone permission to Fravora when prompted.
- On first enable, complete the mandatory activation disclaimer acknowledgement.
- Enable Wait for follow-up in Voice settings if you want multi-step voice interactions.
- Increase the Command window timeout if commands are timing out too quickly.
How do I keep radio playing when the screen is off?
Enable Background playback in radio settings (PRO), then use lockscreen or notification controls to manage playback without reopening the app.
Can I run slideshow and radio on different schedules?
Yes. Slideshow running hours and radio running hours are separate, so you can keep background audio active on a different timetable than image playback.
Screen keeps turning off during slideshow
Enable Keep Screen Awake in Settings → Appearance. Also check your device's display timeout setting — some Android versions override app-level wake locks at aggressive timeout values.
PRO features disappeared after an ad session expired
Temporary PRO access from rewarded ads expires after the granted time (+15 min per ad, up to 4/day). Your PRO settings are saved and will be automatically restored the next time you activate PRO — either via another ad or a permanent purchase.