Install on Windows
Funput is available on Microsoft Store. Install it for free, open it from Start, and receive updates through the Store. It runs in the system tray for Vietnamese typing, with no Input Source to add as on macOS or Linux.
A single portable .exe file is also available on GitHub Releases if you prefer to keep the app in a folder you can carry with you.
Requirements
| Operating system | Windows 10 version 1809 (build 17763) or newer · Windows 11 |
| Architecture | x86-64. Windows on ARM runs it under emulation, but there is no native build yet |
| External runtime | None — no WebView2, no .NET |
That is the Windows version where the Acrylic backdrop used by Funput's Control Center became available. Older Windows versions are not blocked from running the app, but they are untested and the Control Center loses its backdrop material.
The Mica backdrop is Windows 11 only. On Windows 10 the Settings window is drawn opaque — a deliberate choice so the window does not lag while being dragged or resized, not a bug.
Download
Microsoft Store (recommended)
Open Funput on Microsoft Store and choose Get or Install. If your browser asks to open the Microsoft Store app, continue there to finish installing.
Portable build
Get the portable build from GitHub Releases:
| File | Description |
|---|---|
Funput-<version>.exe | Portable app, single file |
Funput-<version>.exe.sha256 | SHA-256 checksum for integrity verification |
Verify SHA-256 (PowerShell):
Get-FileHash .\Funput-*.exe -Algorithm SHA256
Compare the output with the contents of the .sha256 file on the release page.
Install / first run
Install from Microsoft Store
- Open Funput on Microsoft Store and install the app.
- Choose Open in the Store or search for Funput in Start.
- Follow onboarding to pick an input method. The Funput icon appears in the system tray.
- Choose Telex, Telex+ or VNI and try typing in Notepad.
Quit any running portable build or other Vietnamese input method before opening the new build. To keep settings when switching builds, use Settings → Data → Export configuration, then import it in the new build.
Run the portable build
The folder, executable rename and SmartScreen instructions below apply only to the portable build.
- Download
Funput-*.exefrom GitHub Releases. - Put the file in a fixed folder, e.g.
%LOCALAPPDATA%\Programs\Funput\. - Double-click to run — the Funput f icon appears in the system tray (bottom-right of the screen).
- An Onboarding window walks you through picking an input method; after that you can type Vietnamese anywhere.
Do not leave the app in Downloads — it is easy to delete by accident when clearing out downloads, and your settings live next to the app, so they would go with it. %LOCALAPPDATA%\Programs\Funput\ is a good choice: no admin rights needed, and Funput can write its settings there.
On its first run, Funput-<version>.exe copies itself to Funput.exe in the same folder, relaunches from that copy, and then deletes the versioned file.
This is deliberate: launch-at-login and auto-update need a stable path that does not change with every release. From then on, you only ever run Funput.exe.
The portable build downloaded from GitHub may show a SmartScreen warning the first time. If you downloaded from the official GitHub Releases:
- Click More info
- Click Run anyway
Getting started
The default shortcut to turn Vietnamese on and off is Ctrl + ` (changeable in Settings to Ctrl Space or Alt Shift).
Try typing:
| Input method | Type this | You get |
|---|---|---|
| Telex | tieesng vieejt | tiếng việt |
| VNI | xin chao2 | xin chào |
Telex marks tones with letters: s acute, f grave, r hook, x tilde, j dot below — so chaof gives chào.
VNI marks tones with digits: 1 acute, 2 grave, 3 hook, 4 tilde, 5 dot below — so chao2 is what gives chào.
Funput also offers Telex+: plain Telex plus a leading w and the [ / ] shortcuts for ư and ơ.
Using the system tray
The Funput tray icon is the control hub:
| Action | What it does |
|---|---|
| Left click | Open / close the Control Center |
| Right click | Open the context menu |
The Control Center (left click) is a quick panel, so you rarely need full Settings:
- Turn Vietnamese typing on or off
- Switch input method — Telex · Telex+ · VNI
- Quick-toggle spell check, English restore, auto-capitalization
- See the current toggle shortcut and tone placement style
- Open full settings
The portable build’s right-click menu has four items. The Microsoft Store build omits Check for updates:
- Settings…
- Charset converter…
- Check for updates…
- Quit
The tray icon switches between colour and monochrome: colour means Vietnamese typing is on, monochrome means you are typing English. One glance tells you which mode you are in.
Configuration
Open Settings… from the tray menu. The window has six sections:
| Section | What you can change |
|---|---|
| Overview | Vietnamese on/off · input method · auto-disable when switching to a Japanese/Korean/Chinese keyboard · launch at login |
| Typing | Input method · tone placement (traditional hòa / modern hoà) · English restore · instant restore · spell check · auto-capitalization |
| Shortcuts | Vietnamese toggle key · key to flip the word you just typed (off by default) |
| Text expansion | Abbreviation table that expands as you type, with optional case-insensitive matching |
| Data | Export / import configuration · charset converter · import a UniKey abbreviation table |
| About | Version · check for updates · links |
Changes take effect immediately and persist across restarts.
Where settings are stored
In the portable build, configuration lives next to Funput.exe so the whole app can travel on a USB stick. It picks a location in this order:
| Order | Location | When it applies |
|---|---|---|
| 1 | %FUNPUT_CONFIG% | Only if you set this environment variable yourself |
| 2 | <folder containing Funput.exe>\settings.json | The usual case — when that folder is writable |
| 3 | %APPDATA%\Funput\settings.json | Fallback, when the app's folder is read-only |
Putting the app in C:\Program Files\Funput\ lands you in case 3, because that folder needs admin rights to write. Putting it in %LOCALAPPDATA%\Programs\Funput\ keeps settings alongside the app.
For the Microsoft Store build, Windows manages the install directory. Do not move or modify files in WindowsApps; use Settings → Data to export and import configuration.
Known limitations
Task Manager, Registry Editor, some installers and admin tools run at a higher privilege level than Funput, so Windows blocks it from sending keystrokes into those windows. This is an OS security boundary, not an app bug.
For the portable build: right-click Funput.exe → Run as administrator. Funput will then type into both normal and elevated apps.
- The portable build has no background update checks. Choose Check for updates… yourself.
- The Store build updates through Microsoft Store. Do not replace its executable manually.
- The portable build may show SmartScreen on the first run. Only download it from the official GitHub Releases page.
Updating
Microsoft Store build
Open Microsoft Store and check for Funput updates in its app management / Library section. The Store manages updates for this build; Settings → About displays Cập nhật qua Microsoft Store (Update through Microsoft Store), without GitHub download actions.
The update methods below apply to the portable build.
Portable in-app update
| Where | Action |
|---|---|
| System tray | Right-click the Funput icon → Check for updates… |
| Settings | Settings → About → Check for updates… |
When a newer version exists:
- The app reads the
funput-windows.jsonmanifest from GitHub Releases - Downloads the new
.exe - Verifies the Ed25519 signature (same public key as the macOS build)
- Replaces the running executable and relaunches — no sign-out required
Funput never checks for updates in the background — you have to choose Check for updates….
Portable manual update
- Download the new
Funput-<version>.exefrom GitHub Releases - Quit Funput (tray menu → Quit)
- Put the new file in the same folder as the old
Funput.exe, then double-click the new file - Funput replaces
Funput.exewith the new build and cleans up the versioned file
Uninstalling
Microsoft Store build
Quit Funput from the tray. Open Settings → Apps, find Funput in the installed apps list and choose Uninstall. Export your configuration from Settings → Data first if you want to keep it.
Portable build
The portable build has no uninstaller. Three things to clean up:
- Quit Funput from the tray menu, then delete the folder holding the app.
- Remove the launch-at-login entry, if you enabled it.
- Remove the fallback configuration under
%APPDATA%, if there is one.
Run this in PowerShell (adjust the first path to wherever you put the app):
Remove-Item -Recurse "$env:LOCALAPPDATA\Programs\Funput"
Remove-ItemProperty "HKCU:\Software\Microsoft\Windows\CurrentVersion\Run" -Name Funput -ErrorAction SilentlyContinue
Remove-Item -Recurse "$env:APPDATA\Funput" -ErrorAction SilentlyContinue
Deleting the app folder also deletes the settings.json inside it. To keep your configuration, go to Settings → Data → Export configuration before uninstalling.
Troubleshooting
SmartScreen blocks or warns
For the portable build, see Install / first run. Only download from the official GitHub Releases.
Typing does not work in apps running as Administrator
See Known limitations. For the portable build, run Funput via Run as administrator.
Funput-<version>.exe disappeared after I ran it
That is expected. Funput renamed it to Funput.exe in the same folder — see Install / first run.
VNI typing produces no tone marks
VNI marks tones with digits (chao2 → chào), not letters. If chaof is what you are used to, you are typing Telex — switch method in the Control Center or Settings → Typing.
Funput does not start with Windows
Enable Launch at login in Settings → Overview. For the Store build, also check Settings → Apps → Startup if Windows disabled startup. For the portable build, if you moved Funput.exe to a different folder, toggle the option off and on again so Funput records the new path.
The Funput icon is missing from the system tray
- Check the hidden icons area (the ^ arrow on the taskbar) — Windows usually hides new icons there.
- Open Funput from Start (Store build) or run
Funput.exeagain (portable build). If Funput is already running, the second launch simply opens the Settings window — a sign the app is alive and the icon is only hidden. - Restart Windows if the app crashed silently.
Settings are not being saved
The app's folder may be read-only. Check where settings.json actually lives using the table in Where settings are stored, or move the app to %LOCALAPPDATA%\Programs\Funput\.
The .exe looks corrupted
Compare the SHA-256 (see Download) and re-download if it does not match.