Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Introduction

Kioku (記憶, “memory”) runs the unmodified Anki desktop app on iPhone, iPad and Android: the same deck list, reviewer, Browse, editors, statistics and desktop add-ons, made to work with a touch screen. It also runs in a browser tab, and on your own server for use from any browser (Which variant?).

On an iPhone:

Kioku on iPhone: deck list, reviewing, Browse

This manual and Anki’s manual

Kioku is Anki desktop, so everything about studying, adding cards, deck options, searching, statistics, card templates and so on works exactly as described in the Anki Manual. This manual covers only what is different on a phone or in a browser:

To learn about…Read
Studying, answer buttons, learning stepsAnki: Studying
Adding and editing notesAnki: Adding/Editing
Browse and searchingAnki: Browsing, Searching
Deck options, FSRSAnki: Deck Options
ProfilesAnki: Profiles
AnkiWeb syncAnki: Syncing
Importing and exportingAnki: Importing, Exporting
StatisticsAnki: Statistics
Add-onsAnki: Add-ons

Kioku’s own questions and bug reports go to Kioku’s GitHub issues, not to Anki’s support: Ankitects doesn’t make Kioku.

“Anki” is a trademark of Ankitects. Kioku is an independent project, not affiliated with or endorsed by Ankitects.

Which variant?

Kioku comes as three phone apps, plus two ways to use it from a browser. All run the same Anki release (26.09.3) and can sync with each other through AnkiWeb or the phone’s sync server.

On a phone or tablet

iPhone, iPadAndroid, nativeAndroid, Termux
NeedsiOS 17+Android 9+, arm64Android 7+, arm64, ~1 GB free, 3 GB+ RAM
Download size39 MB48 MB235 MB
Looks likea phone app: every window full screena phone app: every window full screena small Linux desktop with a dock
Web pages (cards, editor, stats)the system web viewAndroid System WebViewQt WebEngine, as on a PC
Add-onsyes; programs they start must be among the bundled ones (FFmpeg, MeCab, Tesseract, eSpeak, …)yes; programs they start must be among the bundled ones (FFmpeg, MeCab, Tesseract, eSpeak, …)yes, as on Linux
Other Linux appsnonoyes, on demand
Sync server on the phoneyesyesyes
AnkiDroid’s medianoyesyes
Remote desktopnonoyes
Pick it ifyou have an iPhone or iPadyou want a light, fast appyou want the full desktop and every add-on

Both Android variants can be installed side by side; they keep separate collections.

In a browser

Web (experimental)Your server (Docker)
Needsa recent Chrome, Edge or Safaria server or NAS (amd64 or arm64) with Docker; any browser
Where Anki runsin the browser tab (WebAssembly)on the server; the browser shows its screen
Your collectionin that browser on that deviceon the server, one copy for all your devices
Add-onsmost pure-Python onesyes, as on Linux
Pick it ifyou want to try Kioku without installing anythingyou want one Anki, with a large collection and your add-ons, from every device

See Web browser and Self-hosted server.

iPhone and iPad

iPhone: deck list, reviewing, Browse, Statistics

Android, native

Android: deck list, reviewing, Browse, Statistics

Android, Termux

Termux variant: the Kioku desktop, the deck list, reviewing and the Software page

Your server, in a browser

Anki desktop running on a server, shown in a browser: the Browse window over the deck list

Installing & Updating

Every release is on GitHub Releases:

FileVariant
Kioku-iOS-<version>-unsigned.ipaiPhone and iPad
Kioku-Android-<version>-arm64.apkAndroid, native
Kioku-Termux-<version>-arm64.apkAndroid, Termux

Without installing an app:

Where
kioku.krmanik.workers.devWeb browser (experimental)
ghcr.io/krmanik/kioku-desktopSelf-hosted server (Docker)

Kioku isn’t in the App Store or Google Play. On iPhone and iPad it’s also on TestFlight (sign up).

Updating keeps your data. Install the new version over the old one: collections, media, add-ons and settings stay. Don’t uninstall first: uninstalling deletes the app’s data, unless you synced or exported it.

Before a big update, sync with AnkiWeb or make a backup (File › Create Backup), as you would on a computer.

iPhone and iPad

Applies to: iPhone/iPad

Needs iOS or iPadOS 17 or newer.

Two ways to get Kioku:

  • TestFlight, Apple’s beta app: no signing, no 7-day refresh. Sign up with a short form to get the link.
  • Sideloading the unsigned .ipa from GitHub Releases: you sign it with your own Apple ID while installing.

Kioku won’t be in the App Store; TestFlight is the only Apple-signed way.

TestFlight

TestFlight has a limited number of testers, so the link comes from a signup form that allows one signup per Google account.

  1. Fill in the signup form; the TestFlight link is shown after you submit.
  2. Install TestFlight from the App Store.
  3. Open the link on your iPhone or iPad and tap Accept, then Install.

New builds show up in TestFlight; turn on Automatic Updates there.

  • Each build expires 90 days after it was uploaded. TestFlight shows the days left. Install the newer build before then; if a build has expired, Kioku won’t open until you install a newer one. Your data is kept.
  • TestFlight builds can be a little ahead of the GitHub release.
  • TestFlight shares some data with the developer; see Privacy.
  1. Install AltStore with AltServer on your computer.
  2. In AltStore: Sources › +, add https://github.com/krmanik/kioku/releases/latest/download/altstore.json.
  3. Install Kioku from that source.

New versions then show up in AltStore’s updates.

Other sideloading tools

Download Kioku-iOS-<version>-unsigned.ipa from the latest release and install it with Sideloadly, SideStore, LiveContainer or any tool that signs apps with your Apple ID.

Things to know

  • Sideloaded apps signed with a free Apple ID expire after 7 days. AltStore and SideStore refresh them in the background; with Sideloadly, install again before it expires. An expired app won’t open, but its data is kept: installing again brings it back.
  • To update, install the new .ipa over the old one (same bundle id). Your data stays.
  • A TestFlight copy and a sideloaded copy may be separate apps with separate data. To switch, sync with AnkiWeb or export a .colpkg (File › Export) first.
  • Kioku’s files are in the Files app › On My iPhone › Kioku. See Your Files.

Problems with AltServer: see Troubleshooting.

Android, native

Applies to: Android native

Needs Android 9 or newer on a 64-bit ARM phone (arm64-v8a: nearly every phone from the last years).

  1. On the phone, download Kioku-Android-<version>-arm64.apk from the latest release.
  2. Open it. Android asks to allow installing apps from your browser or file manager: allow it, go back, and tap Install.
  3. Open Kioku.

To update, download the new APK and install it the same way. Data stays.

Kioku runs next to AnkiDroid and the Termux variant; each has its own collection. To share cards between them, sync (AnkiWeb, or the phone’s own sync server).

Android asks to allow notifications the first time the sync server starts; allow it, or its notification stays hidden.

Android, Termux

Applies to: Android Termux

Needs Android 7 or newer on a 64-bit ARM phone, about 1 GB of free storage, and 3 GB of RAM or more for a smooth experience.

You don’t need Termux or Termux:X11: everything is inside the APK.

  1. On the phone, download Kioku-Termux-<version>-arm64.apk from the latest release.
  2. Open it, allow installing from your browser or file manager, and install.
  3. Tap Kioku. The first start unpacks the runtime, about a minute; the splash screen shows the progress. Then the desktop opens with Anki.

Updating

Install the new APK over the old one. The first start after an update unpacks the new runtime again. Your home folder (Anki’s collections, add-ons, settings) is never touched, and Linux apps you installed from Software are reinstalled automatically.

Removing

Uninstalling deletes everything inside the app, including collections that weren’t synced or exported. Kioku never deletes anything in the phone’s own storage (Downloads, pictures…), even when you linked those folders.

Web browser (experimental)

Applies to: web

Kioku also runs in a browser tab, nothing to install: kioku.krmanik.workers.dev. Anki itself runs inside the tab (compiled to WebAssembly), and your collection lives in that browser.

This is an early test version, for trying things out. It may crash or lose data.

  • Back up first. Before using a collection you care about, export it with scheduling information from Anki desktop or your phone (File › Export: a .colpkg, or an .apkg with Include scheduling information).
  • Sync with a test AnkiWeb account, not the one you use.
  • Your collection stays in that browser on that device. Clearing the site’s data deletes it, and Safari deletes it after 7 days without a visit (unless it is on the Home Screen). To keep one collection on your own server and open it from any browser instead, see Self-hosted server.

Browsers

Tested in Chrome on a computer, and in Safari on a Mac and on an iPhone 15 Pro Max. Opening it downloads about 31 MB and takes 20–40 s on a fast connection. Phones have less memory: keep collections small there.

Install it as an app

The page opens full screen from the home screen, without the address bar:

  • iPhone, iPad (Safari): Share › Add to Home Screen.
  • Android (Chrome): ⋮ › Add to Home screen (or Install app).
  • Chrome or Edge on a computer: the install button in the address bar.

On iPhone and iPad the home screen app keeps its own storage, apart from Safari’s: import or sync your collection again there.

Files

File › Import opens the browser’s file picker. Exports and backups are downloaded like any file from a website.

Self-hosted server (Docker)

Applies to: Docker

Run the real Anki desktop app on your own server or NAS and use it from any browser. Anki, its add-ons and your whole collection (media included) stay on the server: the browser only shows Anki’s screen and sends your keyboard, mouse and touches, so a large collection is never downloaded, copied or synced to your devices. Experimental: back up first.

Anki desktop on a server, in a computer's browser: the Browse window over the deck list
On a phone, with ANKI_FIT_SCREENBrowse on a phone
The deck list on a phone's browser, fitted to its width; the side menu's keyboard button in the cornerBrowse filling a phone's screen

Start it

With Docker Compose (compose.yaml):

services:
  anki:
    image: ghcr.io/krmanik/kioku-desktop:latest
    restart: unless-stopped
    shm_size: 1gb
    # time for Anki to close the collection and make its backup
    stop_grace_period: 1m
    ports:
      - "127.0.0.1:3000:3000"
    environment:
      PUID: 1000
      PGID: 1000
      TZ: Etc/UTC
      CUSTOM_USER: anki
      PASSWORD: change-me
      # a taskbar for switching between Anki's windows
      SELKIES_DESKTOP: "true"
      # fit Anki's pages and windows on a phone's screen
      # ANKI_FIT_SCREEN: "true"
      # download Microsoft's core fonts (Arial, Times New Roman, ...) on
      # the first start, for decks that use them; you accept their licence
      # ANKI_MS_FONTS: "true"
      # Debian packages your add-ons need, installed when the container
      # starts (only the first time: a restart finds them installed)
      # INSTALL_PACKAGES: "imagemagick sox"
    # the server's GPU (Intel, AMD) instead of the CPU, for drawing and
    # the video; only if the server has /dev/dri
    # devices:
    #   - /dev/dri:/dev/dri
    volumes:
      - ./anki-config:/config
docker compose up -d

Set TZ to your time zone (for example Europe/Berlin): Anki’s day starts by it. Everything Anki keeps is in anki-config/Anki2: profiles, collections, media, add-ons and backups (each profile’s backups folder). Back that folder up.

If the server has an Intel or AMD GPU (/dev/dri), uncomment devices: Anki’s screen is then drawn and encoded by the GPU instead of the CPU, which uses much less CPU. Leave it commented out on a server without one, or the container won’t start.

The image is for 64-bit Intel/AMD and ARM servers.

Your existing collection

Stop the container, then copy your Anki folder from the computer where you use Anki desktop (where it is) into anki-config/Anki2, and start it again:

docker compose stop
rsync -a ~/.local/share/Anki2/ server:path/to/anki-config/Anki2/
docker compose start

The files must belong to the PUID/PGID user. You can also sync it down from AnkiWeb instead (see Syncing).

HTTPS

Open it through a reverse proxy with a certificate: browsers play the stream only on https:// (or http://localhost on the server itself). Port 3000 is plain http for the proxy; the container’s port 3001 is https with a self-signed certificate, for trying it on your network. The proxy must pass WebSockets.

Caddy

anki.example.com {
    reverse_proxy 127.0.0.1:3000
}

nginx

server {
    listen 443 ssl;
    server_name anki.example.com;
    # ssl_certificate ...;
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_read_timeout 1h;
        proxy_buffering off;
    }
}

CUSTOM_USER/PASSWORD is a basic browser login. For a server reachable from the internet, put a stronger login in front (Authelia, Authentik, your proxy’s own) and never expose it without one: whoever gets in can use the whole container.

Using it

  • One screen for all devices. Every browser that opens it sees the same Anki; you can switch between your computer and phone in the middle of a review.
  • Sound plays in the browser. Click the page once if it stays silent: browsers wait for a click before playing sound.
  • The side menu (the tab at the left edge) has the on-screen keyboard, clipboard, file transfer, full screen and the stream’s quality and scaling settings.
  • Copy and paste text and images between your device and Anki (for example an image into the editor or Image Occlusion).
  • The taskbar (SELKIES_DESKTOP) switches between Anki’s windows, such as Browse and the editor behind the main window. Remove the line for more room on a phone.

Fonts

Shared decks often name Microsoft’s fonts in their card styling (AnKing uses Arial, for example). Their licence doesn’t allow them to be included in the image, so set ANKI_MS_FONTS: "true" to have the container download them from Microsoft’s original packages (via the corefonts project on SourceForge) on its first start, which accepts their licence. The first start then takes a minute or two longer; the fonts are kept in anki-config/.local/share/fonts. They are Andale Mono, Arial, Arial Black, Comic Sans MS, Courier New, Georgia, Impact, Times New Roman, Trebuchet MS, Verdana and Webdings.

Other fonts work the same way: put their files in anki-config/.local/share/fonts and restart Anki (File › Exit: it opens again).

Files from your device

Anki only sees the server’s files. To bring a file in (a shared deck, a .colpkg, images for notes or Image Occlusion), drop it on the page or use Upload in the side menu: it lands in the Desktop folder, where Anki’s Import and Add image windows open. Exports are saved in the same folder by default, and Files in the side menu downloads them.

On a phone

Anki’s desktop layout is wider than a phone. Set ANKI_FIT_SCREEN: "true" to fit it: on a screen narrower than a desktop, Anki’s pages are zoomed out and its windows fill the screen; wider screens are left alone. The side menu’s scaling setting changes the size of everything. Turn the phone sideways for more room.

Settings

Variable
CUSTOM_USER, PASSWORDbrowser login
PUID, PGID1000the user that owns anki-config
TZEtc/UTCtime zone (Anki’s day starts by it)
ANKI_FIT_SCREENtrue: fit Anki on phones (above)
ANKI_MS_FONTStrue: download Microsoft’s fonts (Fonts)
INSTALL_PACKAGESDebian packages to install (Add-ons)
SELKIES_DESKTOPtrue: the taskbar
ANKI_ARGSextra arguments for Anki

The image is built on LinuxServer’s Selkies base image; its settings (resolution, video quality, hardening) work as described there.

Syncing

Not needed between your devices. Sync works as in Anki desktop, with AnkiWeb or your own sync server, for example to also use AnkiDroid or the Kioku apps.

Add-ons

Add-ons run in Anki on the server, as on a Linux computer: install them from Tools › Add-ons as usual. Add-ons that only ship code for Windows or macOS don’t work. ffmpeg, ffprobe and ffplay are installed, for add-ons that record, convert or play sound and video with them. An add-on that needs another program can have it from Debian: list the packages in INSTALL_PACKAGES, separated by spaces (INSTALL_PACKAGES: "imagemagick sox"). They are installed when the container starts, before Anki, and again in a new container (after docker compose pull), which makes that start slower and needs Debian’s servers; a restart finds them installed. If installing fails, Anki starts without them and the next start tries again (docker compose logs shows why). To reach an add-on’s web server (such as AnkiConnect) from outside, make it listen on 0.0.0.0 in its settings and publish its port in compose.yaml.

Updating and stopping

docker compose pull && docker compose up -d

Stopping the container closes Anki the way quitting does (its collection closed, a backup made); allow it the minute in stop_grace_period.

Getting Started

Applies to: iPhone/iPad, Android native, Android Termux, web, Docker

First start

Like Anki on a computer, Kioku asks for the language the first time, then opens the deck list with an empty profile (User 1).

Kioku's deck list on Android, with the menu bar and the Decks, Add, Browse, Stats and Sync buttons

From here it’s Anki: see Getting Started in Anki’s manual.

Bringing your cards

Pick one:

  • AnkiWeb. Tap Sync in the top bar and log in with your AnkiWeb account. In an empty profile choose Download to get your collection. Login and media sync work as on a computer (Anki: Syncing). The login stays after restarting Kioku.
  • A collection file. Export a .colpkg (or .apkg) from Anki on your computer, put it on the phone, and import it: see Your Files.
  • AnkiDroid on the same Android phone. Sync both apps through the phone’s sync server, no AnkiWeb needed.
  • Your server (Docker). Copy your whole Anki folder there: see Your existing collection.

Several people or setups? Use profiles (File › Switch Profile), as in Anki.

The AnkiWeb login as a card above the deck list

Next

Using Kioku on a Phone

Anki desktop was made for a mouse, a keyboard and big windows. Kioku keeps Anki unchanged and adapts the way its windows behave:

The screens inside each window (deck list, reviewer, Browse, editor, statistics, deck options) are Anki’s own; Anki’s manual describes them.

Native apps (iPhone, Android)

Applies to: iPhone/iPad, Android native

Deck listReviewingBrowse
Deck listReviewing a cardBrowse, full screen

Windows

  • The main window (deck list, overview, reviewer) fills the screen, with Anki’s menu bar at the top: File, Edit, View, Tools, Help and add-on menus.
    • iPad with iPadOS 26 or later: Anki’s menus are also in the iPad’s own menu bar (swipe down from the top of the screen, or move the pointer there), with their ⌘, ⌃ and ⌥ shortcuts. Browse’s menus are there while Browse is open. If you keep the iPad’s menu bar on screen (iPadOS 27: Settings › Multitasking & Gestures, Automatically Show and Hide Menu Bar off), turn off View › Show Menu Row to have the menus only once. Kioku remembers it; turn it back on from the iPad’s View menu.
  • Every other window (Browse, Add, Statistics, Preferences, Deck Options…) opens full screen on top, with a title bar.
  • Closing a window:
    • iPhone, iPad: ‹ Back in its title bar.
    • Android: the Back key or gesture closes the top window. On the main window it moves Kioku to the background (Anki keeps running).
  • Small windows (the AnkiWeb login, Create Deck, Rename, message boxes) are cards in the middle of the screen, sized to their content, and move up above the keyboard while you type.
A promptA loginThe Edit menu while reviewing
Create Deck prompt as a cardAnkiWeb login as a cardEdit menu with Edit Current and More while reviewing

Touch

  • Tap for a click, drag to scroll lists and pages.
  • While reviewing, Anki hides its Edit and More buttons on a narrow screen; Kioku offers them in the Edit menu (Edit Current, More: flag, bury, suspend, card info…).
  • Landscape works; windows follow the rotation.
  • Keyboard shortcuts work with a hardware keyboard (Space to show the answer, 1–4 to answer, as in Anki).

Full screen

View › Full Screen hides the menu bar (and the status bar) for more room. To leave it, swipe right on the screen and tap Exit Full Screen (or Cancel to stay in full screen). Kioku reminds you of this for a few seconds when you enter full screen. On a page that scrolls sideways, scroll it back to its left edge first.

On an iPad with iPadOS 26 or later this item is called View › Hide Toolbars: it hides Anki’s bars, but the iPad doesn’t let apps resize their window. To make the window fill the screen, use the iPad’s Window › Full Screen. To get the bars back, choose View › Show Toolbars in the iPad’s menu bar (or press F11); a swipe right there is the iPad’s own.

Full screen: after a swipe right, Kioku asks Exit full screen? with Cancel and Exit Full Screen

Keyboard

The on-screen keyboard opens when you tap a text field and closes when you tap elsewhere. On Android the keyboard’s Enter key (✓) submits single-line fields: Browse’s search, prompts, the login.

Sound and speech

  • Card audio (mp3, wav, Ogg Vorbis, Opus) plays as in Anki, with the replay buttons.
  • {{tts}} text-to-speech uses the phone’s voices: iOS’s voices, and Android’s text-to-speech engine (Settings › Text-to-speech on the phone). Install a voice for the language you need there.

In the background

  • Android: Kioku keeps running in the background like other apps; Android may stop it when memory runs low. Your collection is saved whenever Kioku leaves the screen.
  • iPhone, iPad: iOS pauses Kioku in the background. It saves first.

Web views

Cards, the editor and statistics are web pages in the system’s web view. Card JavaScript works. For card template authors: the web views can be inspected with Safari’s Web Inspector (iOS) or chrome://inspect (Android).

Differences from Anki on a computer

  • File dialogs are the phone’s own file picker (Your Files).
  • “Show in folder” / “Open folder” show the folder’s path instead of a file manager on Android.
  • Add-ons that start other programs don’t work (Add-ons).
  • The card types editor (Cards…) is cramped in portrait; turn the phone.

Termux desktop

Applies to: Android Termux

The Termux variant starts a tiny Linux desktop with Anki open. Anki runs exactly as on a Linux PC; closing Anki returns to the desktop, where the Anki icon opens it again.

DesktopSoftwareSettings
The Kioku desktop with app icons and the dockThe Software page with recommended Linux appsSettings: wallpapers, touch screen or mouse pad

The desktop

  • Apps: a clock, search, Anki, Terminal and every app you installed.
  • Software: recommended Linux apps (Files, Text Editor, QTerminal, Web Browser, Image Viewer, Archives, System Monitor) and a search over every package in the Termux repositories. Install or remove with one tap.
  • Settings: wallpaper (six built in, or your own picture), touch screen or mouse pad, keyboard, import a deck, phone storage, display settings, remote desktop, restart desktop, Power off.

The dock

To…Do this
see the desktoptap the Kioku button at the start of the dock; tap again to get the windows back
switch windowstap a window in the dock
show or hide the keyboardthe keyboard button in the dock

In landscape the dock moves to the right edge.

Touch screen or mouse pad

Settings › Touch screen: tap to click, drag to scroll (with momentum). Settings › Mouse pad: one finger moves a pointer, tap to click, two fingers scroll; like a laptop’s touchpad.

Other apps (web browser, file manager) get real touch events: drag to scroll, long press to select text.

Keyboard

Text fields open the Android keyboard; tapping elsewhere closes it. In other apps, the keyboard opens when you tap where text can be typed (a terminal, a text box). The dock’s keyboard button always works.

Closing Kioku

Settings › Power off closes Anki (it saves the collection) and ends the session.

If start-up fails

The splash screen shows what went wrong, with:

  • Retry,
  • Safe mode: Anki without add-ons (for a broken add-on),
  • Repair runtime: unpacks the runtime again; your decks are kept,
  • Share log: send the log with a bug report.

Your Files

Applies to: iPhone/iPad, Android native, Android Termux (differences noted per variant)

Kioku keeps Anki’s data (profiles, collections, media, backups, add-ons) inside the app. It survives updates; uninstalling deletes it.

Importing

File › Import (or Import File under the deck list) opens the phone’s file picker. Pick a .colpkg, .apkg, text or CSV file; Anki then imports it as described in Anki: Importing. A big .colpkg with media can take minutes on a phone; keep Kioku open.

VariantAlso
iPhone, iPadPut files in Files › Kioku first, or pick them from iCloud Drive.
Android, nativeAny folder the system picker shows: Downloads, Drive…
TermuxSettings › Import a deck from the phone, or open/share an .apkg/.colpkg from another app to Kioku.

Images for the editor and Image Occlusion are picked the same way.

Exporting, Save PDF and backups

VariantExports and PDFs go to
iPhone, iPadFiles › On My iPhone › Kioku › Exports
Android, nativeAndroid/data/io.ankidesk.kioku/files/Exports (see below)
Termuxthe home folder, or a linked phone folder (Settings › Phone storage)

Statistics › Save PDF writes there too.

On Android 11 and newer, most file managers can’t open Android/data. Connect the phone to a computer over USB to copy them, or use AnkiWeb sync instead of export files.

Backups are made automatically, as in Anki: Backups. File › Create Backup makes one now; restore with File › Switch Profile › Open Backup.

iPhone: the Files app

Files › On My iPhone › Kioku shows:

FolderWhat
Anki2/profiles, collections, media, add-ons (as on a computer)
Exports/exported decks, PDFs

Don’t change files in Anki2/ while Kioku is open.

Termux: phone storage

Settings › Phone storage asks for Android’s all-files access and links the phone’s folders (Downloads, Documents, Pictures…) into Kioku’s home folder, so Files and Anki can reach them. Tap again to unlink. Kioku’s home folder also shows in Android’s Files app.

Add-ons

Applies to: iPhone/iPad, Android native, Android Termux

Kioku runs Anki desktop’s add-ons. Install them as on a computer: Tools › Add-ons › Get Add-ons…, enter the add-on’s code from AnkiWeb, and restart Kioku. See Anki: Add-ons.

.ankiaddon files can be installed with Install from file… in the same window.

What works

On the native apps (iPhone, Android) add-ons work unless they need one of:

  • starting another program (iOS forbids it; on Android there is nothing to start). Example: MeCab readings in Japanese Support.
  • Qt WebEngine features, such as AnkiWebView Inspector. Use Safari’s Web Inspector or chrome://inspect instead.
  • Native libraries built for Windows, macOS or Linux PCs.

On the Termux variant, add-ons behave as on Linux.

Add-ons that other apps connect to (iPhone, iPad)

Applies to: iPhone and iPad

Some add-ons answer requests from other apps. AnkiConnect is the best known: dictionary and reader apps (Yomitan, Hoshi Reader and others) send it new cards at http://127.0.0.1:8765.

iOS pauses an app a few seconds after you leave it, and a paused app answers nothing. The other app then waits, or shows “can’t connect” or a spinner that never stops. On Android this doesn’t happen.

To keep such add-ons answering, turn on Preferences › Advanced › Background › Keep running in the background:

  1. Tick Keep running in the background, read the note and choose Yes.
  2. iOS asks whether Kioku may use your location: choose Allow While Using the App, and leave Precise off (iOS’s default for Kioku). Location is only the means, see below.
  3. The group shows On: Kioku keeps running in the background. Now switch to the other app.

When Kioku goes to the background, iOS shows the location arrow at the top of the screen; with approximate location it can disappear after a while, and Kioku keeps running. It keeps running, with the screen locked too, until you turn the option off or close Kioku from the app switcher.

Why location? iOS lets an app keep running in the background only for a few purposes: playing audio, navigation, calls and a few others. Location updates are the one that fits a server best; terminal apps such as Termius use them to keep connections open the same way.

Your location is not collected. Kioku asks iOS for the lowest accuracy it offers (about 3 km, from cell towers and Wi-Fi, without GPS) and ignores what it receives: the location isn’t read, saved, shown or sent anywhere. See the privacy policy.

Add-ons and location. iOS gives location access to the whole app, and add-ons are programs that run inside Kioku. Kioku protects your location from them:

  • Only Kioku’s own location request works. When an add-on, or a web page in a card or add-on window, asks iOS for location access or for locations, it gets nothing, and no permission prompt appears.
  • iOS gives Kioku approximate location (several kilometres) unless you turn Precise on in the Settings app. Leave it off: the option works without it.
  • Kioku never asks for Always access, and add-ons can’t ask for it.

An add-on written on purpose to get around these protections could still read your approximate location while access is allowed, since it runs inside Kioku. Install only add-ons you trust, as on a computer.

Turning it off. Untick the option and Kioku stops using location at once. iOS keeps the permission until you take it back: the Settings app › Apps › Kioku › Location › Never. The group reminds you of this while access is still allowed.

Battery: at this accuracy iOS uses no GPS and wakes Kioku rarely, but an app that stays running uses more battery than a paused one, especially if an add-on keeps working in the background. Turn the option off when you don’t need it.

If you chose Don’t Allow, the group says that location access is off: turn it on in the Settings app › Apps › Kioku › Location › While Using the App.

Extra files for add-ons

Applies to: iPhone/iPad, Android native

To keep the app small, some files that only a few add-ons use aren’t part of the app. Kioku downloads them when an add-on needs them:

Extra filesSizeFor add-ons that
Chinese word segmentation (jieba)5 MBsplit Chinese text into words
Code highlighting (Pygments)1 MBcolor source code
Text recognition languages (Tesseract)10 MBread text from images (OCR)
Speech voices (eSpeak NG)9 MBspeak with eSpeak
  • When you install an add-on that needs some, or start Kioku with one installed, Kioku asks whether to download them. Downloading runs in the background: keep using Kioku. If an add-on that loaded before the download still can’t find them, restart Kioku.
  • Tools › Add-ons › Extra Files… lists them: select an add-on first to see what it needs. Download, update or remove them there; removing frees the space until an add-on needs them again.
  • If you choose Not now, Kioku doesn’t ask again at start-up. It asks again when you install an add-on that needs them.

The files come from the Kioku repository on GitHub.

Tested

All load on iPhone and Android:

Add-onCodeResult
AnkiConnect2055492159works (HTTP API on 127.0.0.1:8765)
Review Heatmap1771074083works; slightly wider than a phone screen
Anki Simulator817108664opens
AnKing Note Types Easy Customization952691989works
Advanced Browser874215009loads
Fill the blanks1933645497loads
Colorful Tags / Hierarchical Tags594329229works
Customize Keyboard Shortcuts24411424loads
Edit Field During Review Cloze385888438works
Speed Focus Mode1046608507loads
True Retention613684242works
HyperTTS111623432works on Android
Color Confirmation1084228676works
Japanese Support3918629684Kanji Stats works; MeCab readings don’t
AnkiWebView Inspector31746032doesn’t work (needs Qt WebEngine)

Full results: docs/testing.md.

A broken add-on

If Kioku fails at start-up after installing an add-on:

  • Termux: use Safe mode on the error screen, then remove the add-on.
  • iPhone, iPad: delete the add-on’s folder in Files › Kioku › Anki2/addons21/ (Tools › Add-ons shows each add-on’s folder name).
  • Android, native: if Kioku still opens, disable the add-on in Tools › Add-ons. Otherwise open an issue on GitHub: reinstalling keeps the add-on.

Report add-ons that work or don’t on GitHub.

Kioku-only Features

Things Anki on a computer doesn’t do. All but links and gamepads are off until you turn them on:

FeatureVariantsWhere
Sync server on the phone: AnkiDroid, Kioku’s profiles and Anki on your computers sync with the phone instead of AnkiWebiPhone, Android native, Android TermuxPreferences › Advanced
AnkiDroid’s media: a profile uses AnkiDroid’s media folder, so big media is stored once; syncs when you switch apps (native only)Android native, Android TermuxPreferences › Advanced
Remote desktop: use the phone’s Anki from a computer’s web browser or VNC viewerAndroid TermuxSettings › Remote desktop
kioku:// links: other apps and Shortcuts add notes, sync and search, like AnkiMobile’s anki:// linksiPhone, Android nativealways on
Gamepads and controllers: study and move around with a Bluetooth or USB game controller; each button’s action can be changediPhone, Android nativePreferences › Advanced (on)

Sync server on the phone

Applies to: iPhone/iPad, Android native, Android Termux

Kioku adds an Advanced tab to Anki’s Preferences, with options for experienced users. Everything there is off until you turn it on, and each option explains its risks first.

Sync server on this phone

Kioku can run Anki’s own sync server (the one behind anki --syncserver) on the phone. Then the phone can be the sync server, with no AnkiWeb needed:

  • AnkiDroid on the same phone syncs with Kioku: Settings › Sync › Custom sync server › Sync URL http://127.0.0.1:8080/, then log in with the user name and password shown in Kioku.
  • Kioku’s own profiles sync with it: press Use for this profile.
  • Anki on your computers syncs with it over Tailscale (or your Wi-Fi): Preferences › Syncing › Self-hosted sync server.
AndroidiPhoneAndroid’s notification
Preferences, Advanced tab on Android: the sync server is running on port 8080, with its address, user name and passwordPreferences, Advanced tab on iPhone: the sync server is running on port 8080Android notification: Sync server running, listening on port 8080, with a Stop button
SettingMeaning
Listen on: This phone onlyonly apps on the phone can connect (default)
Listen on: Tailscalethe phone’s Tailscale address; your Tailscale devices can connect, encrypted by Tailscale
Listen on: All networksany device on the same Wi-Fi or VPN can connect. Plain HTTP: only on networks you trust
Port8080 by default; choose another if an app already uses it
User name, passworda password is made up when you first turn the server on. New makes another one; devices then log in again
Delete server dataremoves everything synced to the phone’s server; each device’s next sync is a full upload

Things to know:

  • The server keeps its own copy of everything synced to it (collection and media) in Kioku’s private storage. It needs that much free space.
  • A device that syncs with the phone no longer syncs with AnkiWeb.
  • The first time, choose Upload on the device that has your cards and Download on the others.
  • Two devices syncing at the same moment: one of them gets Anki’s “Only one copy of Anki can sync to your account at once” error. Nothing is lost; sync it again a moment later.
  • Android: while the server runs, a notification shows and Kioku keeps running in the background (its Stop action stops the server until Kioku starts again). Allow notifications when Android asks, or the notification stays hidden.
  • iPhone: iOS pauses apps in the background, so the server only answers while Kioku is open. It starts again by itself when you come back.

AnkiDroid’s media (Android)

Applies to: Android native, Android Termux

For large media collections on a phone with AnkiDroid: a Kioku profile can use AnkiDroid’s collection.media folder instead of its own, so the media is stored only once. The cards still come from the profile’s own collection, which syncs with AnkiDroid through the sync server above. Both apps can stay open.

This works only with AnkiDroid builds that keep their folder in shared storage, such as the GitHub “full” build (usually /storage/emulated/0/AnkiDroid). The Play Store build keeps its folder where no other app can read it: use the sync server alone instead.

Setting it up:

  1. Turn on the sync server and press Use for this profile.
  2. In AnkiDroid: Settings › Sync › Custom sync server (the address shown in Kioku), log in, and set Fetch media on sync to Never.
  3. Sync AnkiDroid first (Upload if it asks), then the Kioku profile.
  4. In Kioku: Preferences › Advanced › AnkiDroid’s folder › AnkiDroid’s media. Allow All files access when asked. Close Preferences: the profile opens again with AnkiDroid’s media.
AnkiDroid: Settings › SyncKioku: Preferences › Advanced
AnkiDroid's sync settings: logged in as kioku, Fetch media on sync set to Never, Custom sync server http://127.0.0.1:8080/Kioku's AnkiDroid folder settings: AnkiDroid's media chosen, with checks for All files access, AnkiDroid 2.25.3, collection.media, collection.anki2 and the sync server

The checks under the choices show what is missing, if anything: All files access (with a button that opens Android’s setting), the AnkiDroid version, the folder’s contents, and whether the profile syncs with the phone’s server.

What changes for that profile:

  • Media sync is turned off (Preferences › Syncing).
  • Media you add in Kioku goes straight into AnkiDroid’s folder.
  • Check Media won’t delete unused files unless you allow it: a file may belong to a card AnkiDroid hasn’t synced yet. Sync both apps first.
  • Restoring a whole collection (.colpkg) is turned off for the profile.
  • The profile’s own media folder is left as it was, and comes back if you switch back to “Kioku’s own collection”.

If AnkiDroid’s folder can’t be opened (no permission, folder moved), the profile opens with its own collection and Kioku says why.

Syncing when you switch between Kioku and AnkiDroid

Android native only. In the Termux variant, sync the Kioku profile by hand (or when Anki opens and closes) and AnkiDroid with its Sync button.

Anki syncs automatically when a profile opens and closes, but phone apps are rarely closed. So a Kioku profile that syncs with the phone’s server also syncs when you switch apps, as long as Automatically sync on profile open/close is on (Preferences › Syncing; the checks in the Advanced tab warn when it is off):

  • Leaving Kioku with changes: Kioku sends them to the server before Android shows the next app (a local sync takes about 60 ms; the first one after Kioku starts can take over a second, and then finishes in the background). Only a normal sync runs then, without media and without questions.
  • Coming back after more than 2 seconds: Kioku runs Anki’s own sync, which brings in AnkiDroid’s changes.
  • A sync that needs a full upload or download is never done in the background: Kioku asks when you are back, as Anki always does. A sync error is shown when you are back too.

AnkiDroid’s own automatic sync (Settings › Sync › Automatic synchronization) runs only when it starts or closes, and only if its last sync was more than 10 minutes ago. For a quick switch, tap AnkiDroid’s Sync button after opening it (to get Kioku’s changes) and before going back to Kioku (to send yours).

If both apps change the same card between two syncs, the later change wins, as with any Anki sync; review history from both is kept.

Why not open AnkiDroid’s collection directly?

The Advanced tab lists AnkiDroid’s collection (not available). Tapping it explains why instead of turning it on:

Kioku's popup: opening AnkiDroid's own collection isn't available because it can lose changes; use AnkiDroid's media and the sync server instead

Anki locks a collection while it is open, so that only one app can change it. But Anki’s automatic backups, in Kioku and in AnkiDroid, release that lock while the collection stays open: the backup reads the file through a second file handle, and closing that handle drops the app’s lock on the file. After a backup, both apps could have the collection open at once. That happened while testing, and AnkiDroid’s answers were lost. Neither app can tell from the outside that the lock is gone, so Kioku doesn’t offer it until Anki (in both apps) keeps its lock. Details: testing.md.

“AnkiDroid’s media” with the sync server above gets the same result safely: media exists once on the phone, and each app has its own small copy of the cards.

Remote desktop

Applies to: Android Termux

Use Kioku’s Anki from a computer: in a web browser, or in any VNC viewer, on a desktop-sized screen with a real mouse and keyboard. The phone does the work and keeps your collection; the computer only shows it.

The Remote pageWhile it is onIn a web browser
Remote desktop page: Turn on, Listen on (Tailscale, All networks, This phone only), screen sizeRemote session active: the web and VNC addresses, the password, Turn offAnki on the remote screen in a web browser through noVNC, with a taskbar

Settings › Remote desktop › Turn on. Anki closes on the phone (it saves first, as when it quits) and opens on the remote screen. The page then shows the addresses to open on the computer and the password. The phone shows Remote session active until you turn it off; Anki then moves back to the phone.

Connecting

FromOpen
a web browserhttp://<address>:6080/ (the page shows the full address), then enter the password
a VNC viewer (TigerVNC, RealVNC, macOS Screen Sharing, Remmina)<address>:5900, then the password

Where Kioku listens (choose it before turning it on):

Listen onWho can connect
Tailscale (default)your own devices on your Tailscale network, from anywhere. Tailscale encrypts the connection. The Tailscale app must be connected on the phone.
All networksany device on the same Wi-Fi or VPN. Not encrypted: VNC only scrambles the password check. Use it only on networks you trust.
This phone onlynothing outside the phone; for a USB cable with adb forward tcp:6080 tcp:6080 && adb forward tcp:5900 tcp:5900, then http://localhost:6080/vnc.html on the computer.

The password is made up when you first open the page; tap it for a new one. VNC uses at most 8 characters of a password, so it is 8 random letters and digits.

Screen sizes: 1280 × 800, 1600 × 900, 1920 × 1080 (default) and 2560 × 1440, or Custom: any width × height from 640 × 480 to 7680 × 4320, such as a tablet’s 2388 × 1668. The web viewer scales the screen to the browser window.

With the XFCE desktop, Settings › Display can change the resolution, up to the size chosen here; the viewer follows. Scale there doesn’t work on the remote screen (it has no hardware to scale with): the screen comes back as it was after a few seconds. For bigger text and buttons use Settings › Appearance › Settings › Window Scaling, or choose a smaller screen size here.

While it is on

  • Anki runs on the remote screen at 100% size, without the phone’s touch changes (on-screen keyboard, one-finger scrolling). For bigger text and buttons, change Anki’s Preferences › Appearance › User interface size there (up to 300%) and restart Anki from the taskbar: the remote screen keeps its own size, separate from the phone’s. Its windows have a taskbar, with an Anki button to open it again if you close it.
  • Tapping Anki on the phone shows the Remote page instead: Anki can be open in one place only.
  • Other apps on the phone’s desktop keep working on the phone.
  • The phone keeps the CPU and Wi-Fi awake (a wake lock and a Wi-Fi lock), and the notification says that the remote desktop is on. This uses battery: keep the phone charging for long sessions.
  • Run without battery limits (on the Remote page): Android otherwise stops the network of an app with the screen off after a while (Doze), which ends the session. Android asks once; the page shows whether it is allowed.

Turning it off

Turn off on the Remote page. Anki on the remote screen closes (it saves first) and opens on the phone again. If Anki doesn’t close because one of its windows is asking something (an unsaved card in Add, say), the session stays on so you can answer it on the computer; then turn it off again.

Power off in Settings also ends the remote session first.

If Kioku is stopped some other way (Android ends it, or the phone restarts), the remote session is gone too, and Anki opens on the phone the next time.

kioku:// Links

Applies to: iPhone and iPad, Android native

Other apps (Shortcuts, Tasker, dictionaries, a web page) can open a kioku:// link to add a note, sync or search. The actions and parameters are the same as AnkiMobile’s (AnkiMobile’s URL schemes), under kioku:// instead of anki://: to reuse an AnkiMobile shortcut, change anki:// to kioku://.

Add a note

kioku://x-callback-url/addnote?type=Basic&deck=Default&fldFront=front%20text&fldBack=back%20text
ParameterMeaning
typeNote type name. Left out: the one the Add screen would pick.
deckDeck name, subdecks with :: (Lang::Words). Left out: the one the Add screen would pick.
fld<Field>A field’s text, as HTML (fldFront for the field “Front”; a line break is <br>).
tagsTags, separated by spaces.
dupes=1Add the note even if its first field matches another note’s.
profileAdd only if this profile is open.
x-successA link to open once the note is added, such as the app you came from.

The note is added at once and Kioku shows “Added to …”. If something is wrong (no such deck, note type or field, an empty first field, a duplicate), Kioku says what and adds nothing.

A field that holds only a link to an image or sound file, such as fldFront=https://example.com/cat.jpg, is downloaded into the collection’s media and shown in the field. For a link without a file extension, add a made-up one at the end: …/getImage?id=12&fakePath=cat.jpg.

Encode spaces and special characters (%20 for a space; in Shortcuts, the URL Encode action). A field link inside the link must be encoded too.

Sync

kioku://x-callback-url/sync

Same as tapping Sync.

kioku://x-callback-url/search?query=deck:current%20is:due

Opens the Browse screen with this search.

Not supported

AnkiMobile’s infoForAdding (profile, deck and note type names for other apps) isn’t available.

Gamepads and Game Controllers

Applies to: iPhone and iPad, Android native

Study and move around Kioku with a Bluetooth or USB game controller: Xbox, PlayStation, Nintendo Switch Pro, 8BitDo and other controllers that the phone itself supports. Pair it in the system’s Bluetooth settings (or plug it in); Kioku says “… connected” and the buttons work at once.

Buttons are named by position, as on an Xbox controller: A is the bottom face button (PlayStation cross, Switch B), B the right one, X the left one, Y the top one.

Default buttons

ButtonWhile studyingEverywhere else
AQuestion: Show answer. Answer: GoodSelect: open the highlighted deck, study it, press a dialog’s button
BAnswer: AgainBack: deck overview → deck list; close a dialog or menu
XAnswer: Hard—
YAnswer: EasySync
D-pad, left stickUp and down scroll the cardMove: the highlight on the deck list (left and right collapse and expand a deck), the focus in a dialog, the item in a menu
Right stickScrollScroll
Left / right bumperUndo / Replay audioPrevious / next item (like Shift+Tab, Tab)
Menu (Start, Options, +)The review’s More menu—
View (Back, Select, Share, −)Back to the deck overviewBack

The d-pad and the left stick repeat while held. Again, Hard, Good and Easy use the answer keys set in Anki’s Preferences, so they follow your keyboard settings.

Change the controls

Preferences › Advanced › Gamepad › Controls… works like AnkiDroid’s Settings › Controls: a list of actions for Studying and one for Elsewhere, each with its buttons.

  • Tap an action, then Add Button…, and press the button on the controller. While studying, choose whether it works on the Question, the Answer or Both sides, so one button can do different things on each side. If another action has that button, Kioku says which; OK moves it.
  • Tap a button in the list to remove it. An action can have several buttons.
  • Add Keyboard Shortcut… makes an action from any keyboard shortcut, typed as Anki’s menus show it (Ctrl+Shift+D, *), so add-ons’ shortcuts work too.
  • Restore Defaults puts every button back.

The settings apply to every profile and are Kioku’s own: they are not in your collection and don’t sync. Turn the Gamepad checkbox off to give the controller back to the system and to web pages.

Limits

  • Pages with their own controls (the editor, deck options, statistics) take the controller only for Back; use touch for the rest.
  • iPhone and iPad: a message box with buttons is the system’s own alert and takes touch only. A drop-down list opens the system’s picker.
  • Add-ons that read the controller themselves, such as Contanki: turn Kioku’s gamepad off (Preferences › Advanced) to use them, so that a press doesn’t run both.

Troubleshooting

For problems inside Anki itself (a deck, a sync error message, card templates), see Anki: Troubleshooting.

Known issues

IssueVariantWorkaround
Exports and PDFs are in Android/data/…, hidden from most file managers on Android 11+Androidcopy over USB, or use AnkiWeb sync
Back while reviewing leaves the app instead of returning to the deck listAndroidtap Decks in the top bar
The card types editor (Cards…) is cramped in portraitiOS, Androidturn the phone
The sync conflict box (Upload/Download) has a large empty gapiOSit works; tap a button
Review Heatmap is slightly wider than the screeniOS, Androiddrag sideways
History button shows “History ▯” in AddAndroidcosmetic
Add-ons that start a program Kioku doesn’t bundle (mpv, osascript, …; bundled: FFmpeg, MeCab, KAKASI, Tesseract, eSpeak NG, LAME, cwebp)iOS, Androiduse the Termux variant or the Docker image

iOS = iPhone/iPad, Android = Android native, Termux = Android Termux.

iPhone, iPad

Kioku closes right after choosing the language (iPad, iOS 18)

Fixed in 0.2.2. Two causes: VoiceOver or another accessibility feature running, and iOS 18’s WebKit. Update to 0.2.2 or newer.

Kioku doesn’t open any more

A free Apple ID’s signature expires after 7 days. Refresh it in AltStore or SideStore, or install the .ipa again: your data is kept.

From TestFlight: the build expired (90 days after upload). Install the newer build in TestFlight, or get the link again from the signup form if there’s none. Your data is kept.

AltServer

“AltServer could not retrieve anisette data value “machineID”” (newer macOS, such as the macOS 27 betas): AltServer can’t get the device data Apple’s sign-in needs. Until AltStore fixes it:

“Failed to verify code signature … (The provisioning profile is banned.)”: Apple has temporarily blocked sideloading for that Apple ID. Wait, or use another Apple ID only for sideloading.

Android, native

No sync server notification

Allow Kioku’s notifications in Android’s settings (Apps › Kioku › Notifications). See Sync server.

Card audio or {{tts}} is silent

Check the media volume. For {{tts}}, install a voice for the card’s language in Android’s Settings › Text-to-speech.

Android, Termux

The first start takes long

Unpacking the runtime takes about a minute (longer on slow phones), after installing and after each update.

Start-up fails

Use the buttons on the error screen: Retry, Safe mode (Anki without add-ons), Repair runtime (decks kept), Share log. See Termux desktop.

A Linux app doesn’t scroll or select as expected

Switch Settings › Touch screen / Mouse pad. See Termux desktop.

Self-hosted server (Docker)

The page stays black or doesn’t connect

Browsers play the stream only from a secure page: open it through your reverse proxy’s https:// address (or http://localhost on the server itself), not http://<server address>:3000. The proxy must pass WebSockets. See HTTPS.

No sound

Click the page once (browsers wait for a click before playing sound), and check the speaker button in the side menu.

Anki says it can’t write its files

anki-config must belong to the PUID/PGID user, for example after copying a collection there: sudo chown -R 1000:1000 anki-config.

Anki was closed

It opens again by itself after a second. To change what runs, right-click the empty desktop.

What the container did

docker compose logs anki. Anki’s own log is in anki-config/Anki2/logs.

Reporting a bug

Open an issue on GitHub with:

  • the variant, Kioku version (Help › About) and phone model/OS version (Docker: the image tag and your browser);
  • what you did and what happened;
  • the log, if you can: iPhone, kioku.log in Files › Kioku; Android native, Android/data/io.ankidesk.kioku/files/kioku.log; Termux, Share log on the error screen.

FAQs

Is this the real Anki? Yes: Anki desktop’s own Python code and Rust core, unmodified, with a layer that fits its windows to a phone. Your collection is a normal Anki collection.

Why not AnkiDroid or AnkiMobile? Use them if they do what you need. Kioku is for desktop add-ons and the desktop’s own Browse, editors and tools on the go.

Can I use Kioku and AnkiDroid together? Yes. Sync both with AnkiWeb, or with the phone’s own sync server. On Android, a profile can also share AnkiDroid’s media folder.

Can Kioku open AnkiDroid’s collection directly? No: it could lose AnkiDroid’s changes. Why.

Does it cost anything? Is there an account? No. Kioku is free and open source, with no account, ads or tracking. AnkiWeb sync uses your own AnkiWeb account.

Where’s Kioku in the App Store or Play Store? It isn’t, and there’s no plan for the App Store. Install it from GitHub Releases; on iPhone and iPad, a TestFlight build is available: sign up.

Which Anki version is inside? Help › About shows it. Kioku 0.2.3 and later have Anki 26.09.3.

Can I use it on a computer? Yes, in a browser: the web version runs in the tab (experimental), and the Docker image runs Anki desktop on your server and shows it in any browser, phones included. On your own computer, Anki desktop itself is the better choice.

My collection is huge (gigabytes of media). Which one? On a phone, any app variant keeps it on the phone. To use one copy from several devices without syncing it to each, use the self-hosted server: only the screen travels to the browser.

Does it work on tablets? Yes: iPads and Android tablets, in portrait and landscape.

Is there an Intel/32-bit Android build? No: arm64 only. The Docker image runs on amd64 and arm64 servers.

Changes

All releases: GitHub Releases.

Next release

  • Termux app: Anki starts again inside the desktop. 0.2.9 left out a file Preferences › Advanced needs, so the desktop came up without Anki (issue #13). The Termux app no longer shows the Gamepad settings: its desktop gets no controller input.
  • iOS: add-ons that other apps connect to, such as AnkiConnect, can keep answering after you leave Kioku. Turn on Preferences › Advanced › Background › Keep running in the background (off by default). iOS pauses apps a few seconds after they leave the screen, so dictionary and reader apps couldn’t reach AnkiConnect and kept spinning. The option uses location updates to keep Kioku running, at the lowest accuracy and approximate by default. Kioku ignores the location: nothing is saved or sent. Only Kioku’s own location request works: add-ons and web pages that ask for location get nothing (Add-ons that other apps connect to, issue #21).
  • iOS, Android: pictures and sounds keep downloading after a sync with AnkiWeb when the connection drops. On iPhone, leaving Kioku or locking the screen during the download stopped it with “Connection timed out” (or an HttpError message): the cards were there, but most pictures, image occlusion ones included, were missing until the next manual sync. Kioku now tries again by itself, and again when you come back to it, until the download completes. While it runs, the Sync button shows how many files came down.
  • iOS: a sync keeps running for a short while after you leave Kioku, and the screen doesn’t lock while one runs.
  • iOS, Android: show and hide the browser’s columns with touch, in View › Columns. Anki offers them in the column headers’ context menu, which needs a right-click (issue #20).
  • iPhone: number fields, such as Custom Study’s “Increase today’s new card limit by”, get a Done button above the number pad. The pad has no Return key, so the keyboard couldn’t be closed and covered the OK button.

0.2.9

  • iOS, Android: gamepads and game controllers (Bluetooth or USB: Xbox, PlayStation, Switch Pro, 8BitDo…) study and move around Kioku. A shows the answer, then answers Good; B, X and Y answer Again, Hard and Easy; the d-pad moves through the deck list, dialogs and menus. Set each action’s buttons by pressing them, per card side, as in AnkiDroid, or turn it off, in Preferences › Advanced › Gamepad › Controls… (Gamepads and Controllers, issue #18).
  • iOS: the editor’s formatting buttons work on selected text: bold, italic, underline, superscript, subscript, text colour, highlight and remove formatting. MathJax and cloze keep the selected text (issue #17).
  • iOS: add-ons can record from the microphone, for example with AVAudioRecorder through rubicon-objc. iOS asks for access the first time; before, it closed Kioku (issue #19).
  • iOS: a field keeps its caret when it gets the focus back without a tap (Tab with a keyboard, back from a dialog); the caret went to the end.
  • Self-hosted server (Docker): FFmpeg is in the image, so add-ons that use ffmpeg, ffprobe or ffplay work without installing it (issue #15).
  • Self-hosted server (Docker): INSTALL_PACKAGES installs Debian packages that add-ons need when the container starts, such as INSTALL_PACKAGES: "imagemagick sox". A restart finds them installed and downloads nothing (issue #15).
  • Phones with a narrow screen (such as 720 px wide ones) or a larger interface size: the main screen fits the screen. The top bar, the deck list and the buttons under it were shifted right and cut off (issue #14).
  • Android phones with an older system WebView (before Chrome 105, such as Android 11’s built-in one without updates): the deck list fits the screen again; its Learn and Due columns ran off the right side.
  • iOS, Android: add-ons with a hidden page, such as Contanki, no longer leave a white box over the top left of the main window.
  • Phones: the top bar’s buttons wrap to a second row when their labels are too long for the screen (Russian, German). They ran off both sides.
  • iOS: no crash after shaking the device and choosing Undo. Shake to undo and the three-finger undo gestures are off; use Anki’s Undo (Edit menu or Cmd-Z).
  • iPad: no crash on a touch after using an Apple Pencil.
  • iPad (iPadOS 26): the iPad’s menu bar (swipe down from the top of the screen) has Anki’s menus, with their ⌘ shortcuts, instead of empty File, Edit, Format, View, Window and Help menus. Browse’s menus are there while Browse is open. Anki’s own menu row stays; with the iPad’s menu bar always shown, turn it off with View › Show Menu Row. Anki’s View › Full Screen is called Hide Toolbars on the iPad, next to the iPad’s own Window › Full Screen.
  • iOS, Android: kioku:// links let other apps and Shortcuts add notes, sync and search, with AnkiMobile’s actions and parameters (kioku:// links).

0.2.8

Anki 26.09.4.

  • Termux: Kioku 0.2.7 didn’t start (“the sip module implements ABI v13.0 to v13.12”): a Termux update of PyQt6 needed a newer sip module than the one in the app. The build now picks the sip module PyQt6 needs.
  • Android: turning the sync server on and off again quickly no longer closes the app.

0.2.7

  • Pictures and sounds attached with the paperclip or recorded with the microphone show in the field right away. They used to show only after opening the field’s HTML editor (<>).
  • Pictures copied in another app can be pasted into a field on Android, and pictures, sounds and videos can be dropped onto a field.
  • Anki Leaderboard’s table on the home screen scrolls sideways in its own box on phones, like the deck list. It used to make the whole home screen wider than the screen and zoom it out.
  • Card preview on phones shows the whole answer: an image occlusion card’s Toggle Masks button and Back Extra were cut off under the picture.
  • Kioku Web shows pictures whose file name contains # or % (they were missing, e.g. on image occlusion cards).
  • Android 14 and older: the edges of the Add, Edit and Browse windows no longer flash black when the keyboard opens or closes.
  • Tapping next to a field (just above or below it, or between two fields) moves to that field instead of closing the keyboard: on iPhone the keyboard used to pop up and go down again.
  • iPhone and iPad in dark mode: pages no longer flash white when they open (the deck list at start, Add, Browse).

0.2.6

Add-ons that start programs, read PDFs or import native packages now work on iOS and Android.

  • The apps include FFmpeg, MeCab, KAKASI, Tesseract (English, Japanese, Chinese, Korean), eSpeak NG, LAME and cwebp, the programs add-ons such as Japanese Support, AJT Media Converter and OCR add-ons start. An add-on’s own copy of one of them (made for Windows, macOS or Linux) is replaced by Kioku’s.
  • numpy, Pillow and cryptography for add-ons that import them.
  • PDF add-ons such as Incremento: PyQt6.QtPdf and PyMuPDF 1.28 are built in, and add-ons’ pdf.js readers can open local files (also Termux).
  • Chinese word segmentation (jieba), code highlighting (Pygments), Tesseract’s OCR languages and eSpeak NG’s voices are not in the app. Kioku offers to download them when an add-on needs them, and Tools › Add-ons › Extra Files… downloads, updates and removes them. Details
  • Smaller app despite all this: about 215 MB installed on iPhone, a 94 MB APK on Android.
  • On phone screens, add-on panels that open on the side go under the main view; several panels become tabs, and ▲ / ▼ expand a panel or split the screen again (also Termux).
  • Syncing with AnkiWeb keeps going when you leave the app, with a notification while it runs. Leaving during the first download used to fail it with a network error and leave the deck list empty (Android).
  • A sync error while switching profiles is now shown. It used to stay hidden and block the app until a restart (Android).
  • HTTPS (sync, downloads) no longer fails after Android frees storage by clearing app caches (Android).
  • Menus opened from a page (the review screen’s More) show where you tapped and close on a tap outside them (iOS, Android).
  • A hardware keyboard’s Space and Return turn cards over after a tap on the card (iOS).
  • Database writes from some add-ons no longer fail with “SQL statements in progress” (iOS).
  • The first-run language list shows the selected row in dark mode (Android).

Self-hosted server (Docker)

New: ghcr.io/krmanik/kioku-desktop, Anki desktop 26.09.3 on your server or NAS, used from any browser. Your collection, media and add-ons stay on the server; the browser only shows Anki’s screen. Guide.

0.2.5

  • Preferences › User interface size works (50–200%), and Preferences pages scroll instead of squeezing their rows (iOS, Android).
  • No black flash when the keyboard opens in Add and Browse; the Add window’s tags and buttons stay above the keyboard (Android).
  • Sync server on the phone and AnkiDroid’s media (Termux), like the native variants.
  • Remote desktop: a custom screen size from 640 × 480 to 7680 × 4320, and its own interface size (Termux).
  • Fixed a crash on a tap after a window or dialog closed (iOS).

0.2.4

  • Add-on pages fit the phone screen; the deck list no longer flickers from desktop to phone layout (iOS, Android).
  • Browse: add-on buttons next to the search box get their own row, and the sidebar edge is wider and easier to drag (iOS, Android).
  • The progress window has a Cancel button and shows as a small card (iOS, Android).
  • No more freezes at start or when opening Preferences or a menu while an accessibility service (a password manager, Switch Access) is on (Android).

0.2.3

Anki 26.09.3.

  • TestFlight builds for iPhone and iPad (sign up).
  • Full screen: swipe right to get Exit Full Screen (iOS, Android).
  • Add-on side panels and pop-ups fit the phone; tooltips fit its width (iOS, Android).
  • Anki’s update prompt points to Kioku’s releases.

0.2.2

Anki 26.08.1.

New:

  • Sync server on the phone (iOS, Android, Preferences › Advanced): AnkiDroid, Kioku’s profiles and Anki on your computers can sync with the phone instead of AnkiWeb. Guide.
  • AnkiDroid’s media (Android): a profile can use AnkiDroid’s media folder, and syncs when you switch between the apps. Guide.
  • Remote desktop (Termux): use the phone’s Anki from a computer’s web browser or VNC viewer. Guide.
  • {{tts}} text-to-speech with the phone’s voices (iOS, Android).
  • Statistics › Save PDF on iPhone (iOS).
  • Ogg/Opus card audio on iPhone (iOS).
  • The review screen’s Edit and More are in the Edit menu (iOS, Android).

Fixed:

  • Crash right after choosing the language on first start with VoiceOver or another accessibility feature on, and on iOS 18 (iOS).
  • The keyboard’s Enter key now submits Browse’s search, prompts and the login (Android).
  • Status and navigation bars disappeared after another app’s popup, such as the “Open with” chooser (Android).
  • Power off in the Termux desktop didn’t end the session (Termux).

iOS = iPhone/iPad, Android = Android native, Termux = Android Termux.

Earlier

See GitHub Releases.

Kioku privacy policy

Last updated: 19 November 2026

Kioku (the iOS, native Android and Termux apps, the web version and the Docker image from github.com/krmanik/kioku) does not collect, store or share any personal data. It has no analytics, no ads, no tracking and no account of its own.

Your data

Your collections, media, add-ons and settings stay on your device, in the app’s own storage (on iOS, Kioku’s folder in the Files app). The developer never receives them.

  • Web version: they stay in your browser’s storage on that device. The site is served by Cloudflare Workers, which stores nothing of yours. Its relay passes AnkiWeb sync (and the few services it allows for add-ons) through as an encrypted connection made in your browser, so the relay can’t read it.
  • Docker image: they stay on the server you run it on. The browser receives only the picture and sound of Anki’s screen, from your server.

Network connections

Kioku only connects to the internet when you use a feature that needs it:

  • AnkiWeb sync, when you sign in with your AnkiWeb account. Your login and collection go to AnkiWeb, run by Ankitects, under AnkiWeb’s terms and privacy policy.
  • Downloading add-ons and shared decks from AnkiWeb.
  • Content in your cards that points to the internet, such as images, audio, videos or fonts loaded by a card template.
  • Add-ons you install: they are third-party programs and may connect to their own services (for example text-to-speech). Check each add-on’s description.
  • Kioku’s sync server and remote desktop, only if you turn them on: they accept connections from the devices you choose (this phone, your Tailscale network or your Wi-Fi). Nothing is sent to the developer.

Location (iPhone, iPad)

Kioku asks for location access only if you turn on Preferences › Advanced › Background › Keep running in the background, which keeps add-ons such as AnkiConnect answering other apps after you leave Kioku. iOS keeps an app running in the background while it receives location updates; that is the only reason Kioku asks for them.

  • Kioku asks iOS for the lowest accuracy it offers (about 3 km, without GPS), and iOS grants only approximate location unless you turn Precise on yourself.
  • The locations iOS delivers are ignored: Kioku doesn’t read, save, show or send them.
  • No location data leaves your device, and the developer never receives any.
  • With the option off (the default), Kioku receives no location at all. Turning it off stops location use at once; to take back the permission, use the Settings app › Apps › Kioku › Location › Never.
  • Add-ons are third-party programs that run inside Kioku and share its permissions. Kioku lets only its own location request work: add-ons and web pages that ask for location get nothing. An add-on written to get around this could still read your approximate location while access is allowed, so install only add-ons you trust.

TestFlight

If you install Kioku through Apple’s TestFlight, Apple handles the beta under its own terms and privacy policy. Apple then shows the developer what TestFlight collects for every beta app: the name and email address you were invited with (if invited by email), your device model and iOS version, installs and sessions, crash reports, and any feedback or screenshots you send through TestFlight. Kioku itself still sends nothing. The TestFlight signup form (Google Forms) collects your Google account’s email address only to allow one signup per account, because TestFlight has a limited number of testers.

Children

Kioku does not knowingly collect information from anyone, including children.

Changes and contact

Changes to this policy are published on this page. Questions: open an issue.