📖 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, or any supported cloud provider shown in-app.
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. Available now: Google Photos and Microsoft OneDrive. Dropbox integration is in progress.
Cloud providers
Connect a supported provider account and choose the media items or folders you want to include in playback.
Unified limits
Free tier includes one cloud connection with base limits. PRO expands cloud limits and source scope.
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
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
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.
Clock
Shows the current time. Configurable size and time/date format. Always available on Free.
Weather
Live local weather conditions overlaid on the frame. Requires location permission.
Photo Metadata
Shows taken date, location, and, when available, landmark names from EXIF data. Processed locally.
Now Playing
Scrolling marquee with the current station and song information while radio is playing.
Ambient Logo
Pulsing Fravora icon that doubles as a radio status indicator and quick interaction target.
Photo Index
Shows your position in the album (e.g. 42 / 500) with independent sizing controls.
Anti Burn-In
Periodically micro-shifts overlays and varies opacity to protect OLED displays.
Overlay Layout (PRO): Place overlays in corner and center slots, adjust per-overlay font sizes, and hide overlays you do not need.
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
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 playedQuick history of your most recent stations so you can jump back instantly.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 requires a short acknowledgement delay.
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 radio, start radio, resume radio, turn on radio, or launch radio.Radio stop commandsExamples:
stop radio, pause radio, turn off radio, end radio, or close radio.Slideshow play commandsExamples:
play slideshow, start slideshow, resume slideshow, or turn on slideshow.Slideshow stop commandsExamples:
pause slideshow, stop slideshow, turn off slideshow, or end slideshow.Disable voice controlQuickly disable voice listening with phrases like
disable voice control, stop voice control, or turn off voice control.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 the listening timeout for commands (3 to 15 seconds).
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.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
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 12-hour and 7-day views.
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.
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.
10
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 | ||
| Local folders per album | 1 | Multiple |
| SMB folders per album | 1 | Multiple |
| Cloud connections | 1 connection | Expanded |
| Include subfolders (recursive) | — | ✓ |
| Scan interval control | — | ✓ |
| Low storage cache alerts | ✓ | ✓ |
| Slideshow | ||
| Uninterrupted slideshow | ✓ | ✓ |
| Smart Shuffle order | — | ✓ |
| Transition effects | None only | 10+ effects |
| Transition speed control | — | ✓ |
| Running hours scheduling | ✓ | ✓ |
| Bouncing standby clock | — | ✓ |
| Radio | ||
| Search & play stations | ✓ (limited) | ✓ unlimited |
| Station persistence | Session only | Across restarts |
| Favorites | — | ✓ |
| Advanced search filters | — | ✓ |
| Recently played | — | ✓ |
| 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 | — | ✓ |
| Appearance | ||
| App font size control | — | ✓ |
| App color scheme | — | ✓ |
| Controls | ||
| Voice control | — | ✓ |
| 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.
11
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, use double tap to zoom, pinch to zoom smoothly, and drag to pan while zoomed. The ambient logo also supports quick actions: single tap to play/pause radio, double tap to open station search.
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.
12
Support
User Manual
Open Settings → Support → User Manual for direct access to this documentation from inside the app.
Report an Issue
Go to Settings → Support → Report an Issue to send a detailed bug report by email, including device and app version details.
Feature Requests
Use Settings → Support → Feature Request to share ideas for improvements or new features.
Check for Updates
Use Settings → Support → Check for Updates to verify you have the latest version from the Play Store.
Release Notes
Open Settings → Support → Release Notes to review what changed in your currently installed version.
Roadmap
Check Settings → Support → Roadmap to see planned features and known issues under active work.
Replay Onboarding
Re-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.