Getting Started

What is QuKi Notes?

QuKi Notes is a scratchpad and pasteboard: a blank canvas when you open it. Type a thought, draft a message, jot a list, dump a link. Use the content right there, send it somewhere, or let it drift down the list as newer things arrive. There's no vault, no folder structure, no organization ritual.

Each QuKi is a plain markdown (.md) file.

Download and Install QuKi Notes

All the latest versions can be found on the Downloads page.

Join our test group to download QuKi Notes on Google Play, or sideload the APK directly. See Get QuKi Notes for Android for the details

First launch

On Android, Windows and Linux, the first launch asks where your QuKis should live. This screen appears once. You can change the location later in Settings → Storage.

Windows and Linux

• Choose a folder: pick any folder. QuKis are saved there as plain .md files you can open, back up or sync with anything you like.
• Use app storage: QuKis go in a qukis folder inside your Documents folder.

Either way, your QuKis are ordinary files in an ordinary folder, and uninstalling QuKi Notes leaves them where they are.

Android

• Filesystem storage (recommended): QuKis are saved in Documents/QuKi_Notes on your device, where any file manager can see them. They survive uninstalling the app. QuKi Notes needs Android's All files access permission for this. If it isn't granted yet, you'll see a short explanation and a Grant access button that opens the system settings page. Turn the permission on, then switch back to QuKi Notes.
• Use app storage: QuKis are kept in the app's private storage. No other app can see them, and they're removed if you uninstall. Settings shows a warning while this is in use.

Web

There's no setup screen. QuKis are stored in your browser's private storage for this site. They're only in that browser, on that device, and clearing the site's data deletes them. See Settings for what that means in practice.

After this, the editor opens: blank, ready for typing.

If QuKi Notes already has your QuKis

If you used an earlier version of QuKi Notes on the same device, the first launch picks up the folder it was using and goes straight to the editor, without asking. Nothing in the folder is renamed or converted.

If your folder isn't reachable

If the folder you chose can't be found at launch (an unplugged drive, a disconnected network share), QuKi Notes says so instead of opening an empty editor. You can pick a different location, or go back, which closes the app so you can reconnect the folder and try again.

Every launch

QuKi Notes always opens to a new, blank QuKi. Your earlier QuKis are one tap away in the QuKis list.

Your QuKi saves automatically as you type. When you're done, send it somewhere or just leave it; it'll be in the list next time.

Navigation at a glance

The editor is home. It doesn't have a back button.

The editor's top bar, left to right:

Button	What it does
QuKis (far left)	Opens your QuKis list. Greyed out until you start typing your first QuKi.
Mode	Switches between the rendered view and plain text, while editing or reading. See Capturing QuKis.
New QuKi	Starts a new, blank QuKi
Help	Help: version, documentation, Discord, GitHub and support links
Send	Sends the QuKi. See Sending QuKis.
Settings	Opens Settings
Delete (red, far right)	Moves the current QuKi to Trash. Greyed out until the QuKi has been saved at least once.

Going back on Android

On Android, the system Back (swipe in from the edge of the screen, or the Back button) takes you back through where you've been:

• If a dialog is open, Back closes it, the same as tapping Cancel or Close.
• Otherwise it steps back through the QuKis you've opened or started and the QuKis list, in the order you visited them. Starting a new QuKi and pressing Back takes you to the QuKi you were in before.
• A QuKi you come back to opens for reading, scrolled to where you left it.
• Settings and Trash are never stops. Back from either takes you to wherever you were before you opened them.
• A QuKi you've deleted since is skipped.
• A blank QuKi counts as a stop too, even if you never typed anything into it, including the one the app opens with. Back brings it back blank and ready for typing.
• Pressing Back on the first place you visited closes the app.

Your path is forgotten when the app closes. Each launch starts fresh.