Installation

Bokuchi is available for Windows, macOS, and Linux. Download the latest version from the GitHub Releases page.

Download

Visit the Releases page and download the installer for your operating system.

Windows

• .exe — Standard installer (recommended)
• .msi — MSI installer

Run the downloaded installer and follow the on-screen instructions.

macOS

• .dmg — Disk image (Universal, works on both Intel and Apple Silicon)

1. Open the .dmg file
2. Drag Bokuchi to the Applications folder
3. Open Bokuchi from your Applications folder

Linux

• .deb — Debian/Ubuntu package
• .AppImage — Portable, runs on most distributions

For .deb:

sudo dpkg -i bokuchi_*.deb

For .AppImage:

chmod +x Bokuchi_*.AppImage
./Bokuchi_*.AppImage

Windows: SmartScreen Warning

When you download and run the Bokuchi installer on Windows, you may see a series of warnings from the browser and Microsoft Defender SmartScreen.

1. Browser download warning — Your browser may show a warning that the file is not commonly downloaded. Click the menu or More option to proceed.

   

2. Save the file — Select Save (or Keep) from the menu to save the installer to your computer.

   

3. SmartScreen confirmation — Microsoft Defender SmartScreen may show a final confirmation dialog. Click Keep to allow the file.

   

Note

This warning appears because Bokuchi is not signed with a commercial code-signing certificate. The app is open source and safe to use. The warning will only appear on the first installation.

After Installation

When you launch Bokuchi for the first time, you will see the empty state screen. From here you can create a new file with New File or open an existing file with Open File.

The default interface language is English. You can change it to any of the 14 supported languages in Settings > Interface > Language.

Next Steps

• Create your first document — A step-by-step walkthrough
• Learn the interface — Understand each part of the screen