Sumi

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

Getting started

Frequently asked

How do I search for an exact phrase, or exclude a word?
You typeYou get
sqlite indexNotes containing both words
"full text"That exact phrase
data*Anything starting with data
-draftEverything except notes with draft
plan OR specEither 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.