Support
Answers to common questions, plus the tricks that make Oak Viewer fast. Can't find what you need? Email support.
Want a map of every button? See the Button Reference. You can also replay the in-app tour any time from Settings → Replay Tutorial.
Importing
How do I get pictures into Oak Viewer?
The quickest way is the built-in browser: when a site offers a zip of images, tap its download link. Oak Viewer downloads it, unpacks it and adds it to your Library as a new folder named after the zip. Progress shows at the bottom of the browser, so you can keep browsing.
You can also press and hold any image on a web page and choose Import, share pictures or zips to Oak Viewer from other apps, open a zip from the Files app, start an import from the Library (below), or use More → Import inside a folder to bring in pictures from Photos, Files or your Photos albums.
My library is empty. Where do I start?
A new library shows the ways in: Browse the Web, Import from Photos, Import from Files or New Empty Folder. Later, tap New Folder in the Library and choose From Files…, From Photos… or From Albums… to import straight into a new folder. It uses the name you type, or today's date if you leave it empty.
Where do I see my downloads and imports?
Open the browser menu and choose Activity. It lists queued downloads and recent imports, and you can pause or retry them from there. When an import finishes, tap Library in the message to jump to the new folder.
What file types are supported?
Images: JPEG, PNG, HEIC, HEIF, GIF, TIFF, BMP and WebP.
Video: MP4, MOV and M4V play in the viewer. Other video files (such as AVI, MKV, WMV, FLV or WebM) can be imported, but may not play.
Documents: PDF, plain text, Markdown, RTF, CSV, JSON, XML, HTML and most source code files, plus Word, Excel, PowerPoint and Pages documents.
Viewing
How do I use the full-screen viewer?
- Tap the picture to show or hide the controls.
- Swipe sideways, or tap the arrows at the edges, to move between pictures.
- Pinch to zoom. Double-tap for actual pixels, and double-tap again to fit.
- Swipe down, pinch closed, or tap ✕ to close.
- Tap the caption at the bottom for file, camera and location details.
How does the slideshow work?
Tap Play in the viewer to step through the folder. Any touch stops it, and the screen stays awake while it runs. Set the timing in Settings.
Can I hide the histogram?
Yes. In the viewer, tap ••• → Hide Histogram, or turn off Show histogram in Settings under Full-screen viewer. Turn it back on the same way.
What does the histogram show?
The small histogram in the corner of the viewer shows how the picture's tones spread from black (left) to white (right), for brightness (luma) and for red, green and blue. Marks at the edges mean shadows or highlights have clipped.
Tap it to open the full panel: median brightness, how much of the picture is dark, mid and bright, its tonal range, how much is pure black or pure white, and a guide to reading a histogram.
What is the description in the histogram panel?
Oak Viewer describes the picture automatically. On devices with Apple Intelligence it writes a short sentence; otherwise it lists the subjects it recognizes. Both happen entirely on your device, and the picture is never uploaded. Descriptions can be inaccurate.
Rating
What's the fastest way to rate?
Press and hold anywhere on the picture to bring up the star pill, slide to choose one to five stars, then lift your finger. The rating is saved and you can swipe straight on to the next picture.
You can also tap the stars at the top of the viewer (tap the same star again to clear it), or press 1–5 on a hardware keyboard and 0 to clear.
The star pill is under my thumb. Can I move it?
Yes. Go to Settings → Star pill position.
Are ratings saved in my photo files?
No. Ratings live in Oak Viewer's library, not in the files' metadata, so other apps won't see them. They're included when you back up your library or move it to another device. If you delete the app without a backup, your ratings are deleted with it.
Organizing
How do I move or copy pictures to another folder?
In a folder, tap Select, choose the pictures, then tap Move / Copy. From the viewer, tap ••• → Move / Copy… to send just the picture you're looking at. Tip: More → Filter → ≥ 4 ★ shows only your top picks, ready to Select All.
How do I make a smart folder?
Tap New Folder and turn on Smart folder. Choose filters for rating, orientation or date saved. A smart folder gathers matching pictures from every folder without moving them; a 5-star smart folder is a great way to keep favorites in one place.
What can I do with a folder?
Press and hold a folder to pin it, rename it, move or copy it, export it, change its thumbnail, or use it for the Picture Frame widget. Pinned folders stay at the top of the Library and of the Move sheet.
How do I change a folder's thumbnail?
Press and hold the folder and choose Thumbnail. Or, inside the folder, press and hold any picture and choose Use as Folder Thumbnail. The same choice is in the viewer's ••• menu.
Can I search my library?
Yes. Tap the magnifying glass in the Library to find pictures by filename, or use the filters to search by rating, camera and more. Search can also match what a picture shows, using tags Oak Viewer creates on your device in the background.
What do Resume and the widgets do?
Each folder remembers the last picture you viewed. Tap the Resume button in a folder's toolbar to jump back to it. On your Home Screen, the Resume widget reopens your last picture, and the Picture Frame widget shows pictures from a folder you choose. Folder Shortcuts opens favorite folders in one tap, and Recently Added shows your newest pictures.
Can I use Siri, Shortcuts or Control Center?
Yes. Say “Resume Oak Viewer”, “Open Beach Trip in Oak Viewer” or “Start a slideshow of Beach Trip in Oak Viewer”, using any folder's name. While a picture is open, try “Next photo in Oak Viewer” or “Rate this photo five stars in Oak Viewer”. The same actions are in the Shortcuts app, along with Find Photos, Get Photo Files and Open Photo. In Control Center, add Resume Viewing, Open Folder or Start Slideshow. While App Lock is on, Siri and Shortcuts can't see your folders or pictures.
Cleaning up
What is Finish Set?
It's the end-of-set routine in one step. In a folder, choose More → Finish Set… and pick where your keepers go. The rated pictures move to that folder, the rest go to Trash, and the folder, now empty, goes to Trash too. Folders inside it are left alone.
How do I get rid of everything I didn't rate?
In a folder, choose More → Delete Unrated. Every picture with no stars moves to Trash; rated pictures are never touched. To check first, use More → Filter → Unrated.
How do I find duplicate pictures?
In a folder, choose More → Find Duplicates. Oak Viewer compares what the pictures look like, not just their files, so it finds resized or re-saved copies too. Adjust the similarity setting, review each group, or tap Auto-Select to keep the largest copy in each group. Removed duplicates go to Trash.
Is there a Trash? Can I get pictures back?
Yes. Deleted pictures and folders go to Trash first. Tap the trash can in the Library to open it, then Restore to put items back where they came from. If a picture's own folder is in Trash too, it goes to a Restored Photos folder in your Library instead. Delete and Empty Trash remove items permanently; Oak Viewer asks before doing either.
Can Trash empty itself?
It can, but it's off by default. In Settings → Auto-empty Trash, choose to clear items older than an hour, a day, a week or 30 days. It runs when you return to the Library.
Browser
Is it a full web browser?
Yes. It has tabs and tab groups, favorites, history, Reader, Find on Page and per-site zoom. Type a website or a search in the address bar; press and hold the field for Paste & Go. Tap the tab count to see, reorder and close your tabs.
Can Oak Viewer save my website passwords?
Yes. After you sign in to a site, a Save Password? bar appears above the address bar; tap it to save. Next time you're on that site's sign-in page, tap the Saved Password bar and confirm with Face ID, Touch ID or your passcode to fill it in. Passwords stay in this device's Keychain: they aren't synced to iCloud, included in backups or sent anywhere. See, copy, edit or delete them in Settings → Saved Passwords, where you can also turn the offer off.
What does a private tab do?
Private tabs aren't saved and aren't added to History. Close the tab to discard its website session. Files you download or import from a private tab stay in your library.
How do I save a site I visit often?
Open the browser menu and choose Favorites → Add Current.
Backup & privacy
Does Oak Viewer sync with iCloud?
No. Your library stays on your devices and never goes through a server. To keep two of your devices the same, use Keep in Sync; to keep a copy, back it up; to switch devices, move it directly. All three are below.
How do I keep my iPad and iPhone in sync?
On both devices, open Settings → Storage & Sync → Keep in Sync and tap Pair a Device. One device shows a six-digit code; on the other, tap its name and enter the code. After that, tap Sync Now whenever both have Oak Viewer open. Each sync shows what will change on both devices and asks first, on both. New pictures and folders, ratings, moves, renames, Trash and smart folders go both ways. Nothing is erased: anything deleted on one device goes to Trash on the other.
Can I share a folder with someone else?
Yes. Press and hold the folder, or open it and tap More, and choose Share Folder…. Your device shows a code. On the other person's iPhone or iPad, open Settings → Storage & Sync → Keep in Sync → Join a Shared Folder, tap your device and enter the code. From then on, tap Sync Now whenever both have Oak Viewer open on the same Wi-Fi. The folder, the folders inside it and their pictures stay the same on both devices; nothing outside it is shared. Each of you keeps your own ratings unless you turn on Share Ratings, and the folder can sit wherever each of you likes in your own library. As with Keep in Sync, both devices are asked first and nothing is erased. Stop Sharing leaves the folder as an ordinary folder on both.
How do I back up my library?
In Settings → Storage & Sync, choose Back Up Library and pick a destination in Files. The backup includes your folders, pictures, ratings and smart folders. To bring it back, choose Restore Library, pick the backup, and decide whether to Merge it with your current library or Replace it.
How do I move my library to a new iPhone or iPad?
Install Oak Viewer on both devices, then choose Settings → Storage & Sync → Send Library on the old device and Receive Library on the new one. Keep both devices on the same Wi-Fi network, or close together with Wi-Fi and Bluetooth turned on. The library is sent directly between your devices over an encrypted connection; nothing goes through a server. If the transfer is interrupted, it picks up where it left off.
Can I lock Oak Viewer?
Yes. Turn on App Lock in Settings to require Face ID, Touch ID or your passcode before your library opens.
Is my data private?
Yes. There's no account, no analytics and no tracking, and nothing in your library is uploaded. Read the privacy policy for details.
Purchases
How does the free trial work?
Every feature is unlocked for seven days from the first time you open Oak Viewer. After that, choose Yearly ($2.99 a year, renews automatically) or Lifetime ($9.99, one payment). Prices are in US dollars; the App Store shows your local price.
I already paid. How do I restore my purchase?
Purchases belong to your Apple Account, so Oak Viewer normally recognizes them on its own, on any of your devices. If the plan screen still appears, tap Restore Purchases on it, and make sure you're signed in with the Apple Account you used to buy. If you bought Oak Viewer before the free trial was introduced, you keep full access automatically.
How do I cancel a subscription?
Subscriptions are handled by Apple. Open Settings on your device, tap your name, then Subscriptions. Cancel at least a day before the renewal date to avoid being charged for the next year.
Tips & shortcuts
Gestures
- Press and hold any icon in the toolbar to see its name.
- Pinch the grid to make thumbnails larger or smaller, everywhere in the app.
- In a folder, tap Select to pick pictures; press and hold it to pick folders instead.
- Press and hold a folder's title to see its full path.
- Press and hold a picture in a folder to use it as the folder thumbnail or the Library background.
Hardware keyboard
- ← → previous and next picture
- Space show or hide the controls
- 1–5 rate, 0 clear the rating
- In the browser: ⌘T new tab, ⌘W close tab, ⌘L address bar, ⌘R reload, ⌘[ back, ⌘] forward
Make it yours
- Choose Light, Dark or System in Settings → Dark Mode & Theme. System follows your device.
- Change colors, thumbnail style and the app icon in Settings.
- Set a custom Library background in Settings, or press and hold any picture and choose Use as Library Background.
Still need help?
Email support@oakviewer.com and we'll get back to you as soon as we can. It helps to include your device model and the version of Oak Viewer (shown in Settings).