FAQ
Data and storage
Where is my project data stored?
On your own PC. Scripts, character settings and world-building are all ordinary, human-readable Markdown + YAML files, and you can open them as-is in Notepad or Obsidian. Your work is never locked into a proprietary format.
What happens to my data if Kakiniwa development stops?
Nothing is lost. The Desktop edition works fully offline, so it keeps running, and your data is plain text files that you can open in any other editor at any time. If circumstances ever force development to end, the plan is to release the source code (open-source it).
Can I make backups?
Scripts automatically keep a version history. You can also make an incremental backup of a whole project (a ZIP including assets) from within the app.
Getting started
I see “Windows protected your PC”
Kakiniwa is developed by an individual and is not code-signed (signing would require the developer to publish their real name). When the message appears, click “More info” → “Run anyway” to launch it. On Mac, right-click → “Open” the first time only.
“A virus was detected” appears when I download
This is a false positive from Microsoft’s security features (Windows Security / Edge). Because Kakiniwa is not code-signed, right after a new version is released it can be mistaken for a virus by machine-learning detection. The installer contains no virus: with every release we confirm on VirusTotal that other antivirus engines find no problem, and if a false positive occurs we ask Microsoft to lift it (it is usually resolved within a few days). The steps to deal with it are collected on the Download page.
A black window (command line) appears
Detailed logging for troubleshooting had been turned on automatically by mistake. If you restarted your computer while Kakiniwa was open, Kakiniwa wrongly assumed it had “crashed” and switched this logging on. The black window is produced by that logging feature (a known issue with a component called WebView2); the text shown in it is not a sign of a problem and does not affect your scripts or project data. Fixed in v0.9.2.
If it is already showing, turn off Settings → “Diagnostics” → “Keep detailed logs” and restart Kakiniwa, and it will go away (it also disappears on its own after 14 days). In versions before v0.9.2, closing the black window directly makes Kakiniwa restart, so please leave it open rather than closing it.
What are the system requirements?
Supports Windows 10 / 11 (64-bit) and Mac (both Intel and Apple Silicon). The download is light at about 39 MB (about 96 MB for Mac) and no internet connection is needed. Windows also has a portable version that needs no installation (just unzip and launch). For how to choose and how to install, see the Download page.
Is it free?
The Desktop edition is free and ad-free, forever. Only the features that use servers are planned to be paid in the official release (the fees go toward running costs and keeping development going). See Pricing and editions for details.
Features
How far does the YMM4 integration go?
Dialogue can be exported as a script for YMM4 (txt / csv / tsv), and specifications for expressions, SFX, backgrounds and duration can be exported as a direction sheet. There is also a dedicated plugin that places dialogue, voices, character portraits, expressions, positions, backgrounds, BGM and SFX on the timeline in one go (beta). For the latest scope of support, see Status.
The YMM4 plugin I got from BOOTH has no .ymme file, and YMM4 no longer starts
The contents of the distributed file were wrong (it contained a dll and a txt instead of a .ymme). It has since been replaced with the correct .ymme, so please download it again from BOOTH. If a dll you placed manually is still there, YMM4 will keep failing to start, so delete it first, then double-click the .ymme to install.
Does it support VOICEVOX?
Yes, for previewing while you write (it connects to VOICEVOX on your own PC; local only). CeVIO AI and VOICEVOX-compatible software such as AivisSpeech and COEIROINK also work, and you can adjust speed and pitch per character when previewing. Yukkuri voices (AquesTalk) are supported as well (specify the one you installed in Settings). It does not generate audio files in bulk; the idea is that final voices are made on the YMM4 side (Status).
Can I use Yukkuri voices (AquesTalk)?
Yes. However, it is not bundled with Kakiniwa, so please get it from AQUEST’s website. On Windows, just choose the zip in “Quick setup” in Kakiniwa’s settings and it is set up for you. On Mac, open the dmg and specify the location of the library inside it in Settings. In both cases, both AquesTalk and AquesTalk10 can be used (CeVIO AI is Windows only). Note that the Mac version has not been tested because there is no development environment for it (if it doesn’t play sound, please contact us). If you use the voices you create commercially, you need a usage license from AQUEST.
Can AI write my script?
Yes. We distribute an AI-oriented notation manual that summarizes Kakiniwa’s script notation. Paste it into ChatGPT, Claude or similar and ask, and you get back a script in a form you can paste straight into Kakiniwa. There is no feature yet for using AI inside the app, but our plans going forward are described on Status.
Can I use it commercially?
Yes. All rights to what you create with Kakiniwa, such as scripts and settings, belong to you. You are free to use them in monetized videos and publications (Terms of Use · Privacy · Notation Based on the Act on Specified Commercial Transactions).
I heard anonymous statistics are sent
To help us find bugs, we may send anonymous launch statistics. They consist of a random ID, the app version, the OS type and the CPU type (64-bit / Arm), plus device specs (number of CPU cores, CPU model, amount of memory, OS version, GPU model and manufacturer), usage (number of launches, time used, number of speaker switches, number of crashes; counts only), and, if you are trying a launch option for troubleshooting, the kind of option. We also record your country (only the country name, estimated from where the connection comes from; your IP address is not stored) and your display language and OS language (without region). This is used to investigate the causes of slowness and to decide what level of hardware to build for and which languages to translate into. Your name, contact details, the content of your projects and where they are saved are not sent. Model names are recorded after stripping clock speeds and device identifiers. You can turn this off in Settings (see the Privacy Policy for details).
Connected features (Remote and Cloud)
What is the difference between Remote and Cloud?
Official Remote = your home PC stays the main machine, and you edit from a phone or another device while away by connecting the devices directly to each other (free to use right now; your home PC must be turned on). Cloud edition = your projects are kept on a server so you can open them even when your PC is off (in preparation). Both are used by logging in with the same account.
Does my project data pass through a server with Remote?
As a rule, no. The server is used only to help the devices find each other (signaling), and your project data itself is exchanged over an encrypted direct connection between devices. On connections where a direct link isn’t possible, traffic may go through a relay server, still encrypted, but your content is never stored on a server in a readable form.
Can I use it from another device on the same network (LAN)?
We had once planned LAN access as a “lite version of official Remote,” but dropped it for security reasons (it is hard to protect traffic within a LAN) and maintenance reasons. Please use official Remote from other devices. It works the same way whether you are at home or away.
Could other people see my projects?
Only devices linked to your account can connect to Remote. You can also switch sharing on or off for each project.
Support and community
Is there a place to ask questions or get advice?
Yes. The official community (Discord), run by volunteer users, is the place to ask how to use Kakiniwa, get advice on making your work, and swap information about YMM4 integration. Join from the community page.
Where do I send bug reports and feature requests?
We accept them through either the community (Discord) or the contact form. For anything that needs an individual reply, such as matters about your account or payments, please use the form.
Will AI read the contents of my inquiry?
Yes. To respond faster and more accurately, we may use AI to organize inquiries and draft replies (for images you attach, AI also reads their content to help organize the inquiry). This automated processing normally runs on AI from Anthropic (servers in the US and elsewhere overseas). SAKURA internet (servers in Japan) is used as a backup when Anthropic cannot be reached, and for reading attached images and searching our help documents. We also use AI (such as Anthropic Claude and OpenAI GPT) to assist with development and support work, so part of the content may be processed when the developer handles your inquiry. In every case, personal information such as email addresses is automatically masked before being passed to AI, and the final reply and decisions are made by a person (the developer). See the Privacy Policy for details.
← Back to top Status (what it can and can’t do) → Public beta: testers wanted →