Support
Sumi for iPhone · iPad · version 1.0
Get in touch
Email support@beem.im — bug reports, questions and feature requests all welcome. We aim to reply within a few business days.
For a bug, it helps enormously to include your device (iPhone or iPad), your iOS version, the app version from Settings, whether your notes are stored locally or in iCloud, and what you did just before it went wrong. Please don't send the contents of a private note unless it's genuinely needed to reproduce the problem.
Requirements
- iOS or iPadOS 17 or later.
- iPhone and iPad. Works in portrait and landscape.
- An Apple Account signed in to iCloud, only if you want iCloud storage.
Getting started
- Just start typing. The app opens on an empty page. The file is created for you as you write, and the first line becomes the note's title.
- Search from the field at the top. Results appear and narrow with every character. Tap one to open the note with the match already highlighted.
- The bar above the keyboard changes with the focus. In the search field it offers words from your notes, your recent searches and the search operators. In the editor it becomes markdown keys — headings, lists, checkboxes, emphasis, code — which act at the cursor.
- All your notes are in the list behind the toolbar menu, where you can rename, share, print and delete them.
Frequently asked
How do I search for an exact phrase, or exclude a word?
| You type | You get |
|---|---|
sqlite index | Notes containing both words |
"full text" | That exact phrase |
data* | Anything starting with data |
-draft | Everything except notes with draft |
plan OR spec | Either word |
There are keys for each of these in the bar above the keyboard while the search field is focused.
Search found a note I didn't expect — or missed one I did.
Results are ordered by how well a note matches: a hit in the title counts
for far more than one in the body, and a recently edited note gets a mild
nudge upward. Exact matches are listed before matches found by stemming
(which is why recipes can turn up a note titled “Sourdough
recipe”).
If a note is missing entirely and you wrote it somewhere else, see “Can I bring markdown in from another app?” below.
Where are my notes stored?
As separate files, each one encrypted on your device before it is written. By default they are in the app's own folder; turning on iCloud storage moves them to your own iCloud Drive instead.
Because they are encrypted, they are not files you can read by opening the folder — their names are opaque identifiers and the titles are inside the encrypted contents. To get readable copies, use Export All Notes in Settings.
How do I turn on iCloud, and is it reversible?
Settings → Storage → Store notes in iCloud Drive. Your files are moved into your iCloud container rather than copied, so there is one library, not two. The switch works in both directions, and if iCloud is unavailable the app falls back to local storage rather than leaving you without notes.
The iCloud switch is greyed out.
That happens when the device isn't signed in to iCloud, or when iCloud Drive is off. Check Settings → [your name] → iCloud → iCloud Drive on the device, then come back. The switch is also disabled briefly while a move between locations is still in progress.
A note I wrote on another device hasn't appeared.
With iCloud storage on, Settings has a Refresh from iCloud button, which pulls in notes written elsewhere. If it still doesn't show up, confirm both devices are signed in to the same Apple Account, that iCloud Drive is on, and that the file is visible in Files → iCloud Drive → Sumi.
Can I bring markdown in from another app?
Yes — Settings → Import Markdown. Choose files, or a whole
folder, and each one becomes a note, encrypted like everything else on
the way in. .md, .markdown and plain
.txt are all read, and files that aren't UTF-8 have their
encoding worked out rather than being skipped.
Copying files straight into the Sumi folder no longer works, and this is why: the app can only read notes sealed with your key, so a markdown file dropped in beside them is somebody else's file as far as it is concerned. Importing is what seals it.
How do I rename a note?
From the notes list. Renaming rewrites the note's first line — keeping its
# or bullet marker — and renames the underlying file to
match.
How do I share or print a note?
Also from the notes list. Sharing hands over the real .md
file, so AirDrop, Mail, Messages and Save to Files all receive something
any other app can open. Printing renders the markdown as laid-out pages
rather than printing the raw source.
How do I lock the app?
Settings → Privacy → Require Face ID (or Require Touch ID, depending on your device). Opening Sumi then asks for it, and falls back to your device passcode. The match is made by iOS; the app only learns whether it succeeded.
Can I clear my recent searches?
Yes — Settings → Privacy → Clear Search History empties the list of recent queries the search bar offers you. The word suggestions come from your notes themselves, so those stay.
How do I delete a note, and can I get it back?
Delete it from the notes list, or simply empty it — an empty note removes its file. There is no in-app trash, so a deleted note is gone from the app, and the deletion carries to your other devices.
One exception, on purpose: if you deleted a note on one device while editing it on another, the edit wins and the note comes back. Coming back to a note you have to delete twice is a smaller harm than coming back to one that is gone.
How do I back my notes up?
Two ways, and they answer different worries. An iCloud or Finder backup of the device includes your notes, still encrypted, and restores them with your Keychain. For a copy you can read without Sumi at all, use Settings → Export All Notes: every note as plain markdown in a zip, which you can put wherever you like.
The exported zip is not encrypted. That is what makes it useful, and worth keeping somewhere you would be comfortable keeping your notes.
Light or dark mode?
Settings offers System, Light or Dark. System follows whatever the device is set to.
Is there a web version?
Sumi is an iPhone and iPad app. There is no web version: the notes are encrypted on your devices, and a web page would need a copy of the key.
Because notes are plain markdown inside the encryption, Export All Notes gives you files any markdown editor can open, and Import markdown brings them back.
What do you do with my data?
Nothing — the app collects none. See the privacy policy for the detail.
Something's broken
If the app is misbehaving, these are worth trying in order: quit it from the app switcher and reopen it (a rescan runs at launch); make sure iOS is up to date. Then email support@beem.im with the details listed at the top of this page.
Please don't delete the app as a first step if your notes are stored locally — that removes the notes with it. Run Settings → Export All Notes first and keep the zip somewhere safe.
Feature requests
Genuinely welcome, and read by the person who writes the app. Send them to support@beem.im.