Install

Etonym runs on Windows 10 and 11 (64-bit) only.

Download and run the installer

1. Download Etonym_<version>_x64-setup.exe from the download page.
2. Run it. Etonym installs for your Windows account only, so it does not need administrator rights.
3. Read the license agreement and choose I Agree.
4. Keep the install folder, %LOCALAPPDATA%\Etonym, or choose Browse… to pick another. Etonym needs about 10 MB.
5. On the last screen, Run Etonym and Create desktop shortcut are both on. Turn off what you do not want, then choose Finish.

The installer always adds Etonym to the Start menu.

If Windows SmartScreen warns you

The installer is not code-signed yet, so Windows may show a SmartScreen warning for a new app. Choose More info, then Run anyway.

If you start the installer from another program, such as PowerShell, Windows may show an Open File - Security Warning instead. Choose Run.

To make sure the file is the one we published, check its SHA-256 first.

Check the installer

The download page and each release note list the installer’s SHA-256. In PowerShell, in the folder where you saved the file, run:

Get-FileHash .\Etonym_*_x64-setup.exe -Algorithm SHA256

The output must match the published value. If it does not, delete the file and download it again.

Open Etonym from Explorer

The installer adds Open with Etonym to the right-click menu of folders and .md files, and adds Etonym to the Open with list for .md. It does not make itself the default app. See Open from Explorer.

Updates

Etonym looks for a new version when it starts and then once a day.

• When the check at start-up finds a version, Etonym asks right away: Install now or Later.
• When the daily check finds one, Etonym does not interrupt you. An Update to button with the version appears at the right end of the path line above the note.

When you install an update, Etonym saves your notes first, then downloads the update, verifies its signature, installs it and restarts. An update whose signature does not match is not installed. If anything fails, Etonym tells you and tries again later.

The update check downloads a small public file that describes the latest version, and Etonym compares the versions on your PC. The request names no note, file, account or device. Like any web request, it shows your IP address to the server that hosts the updates, currently GitHub.

To turn it off, open Settings (Ctrl+,), go to About, and switch off Check for updates.

Uninstall

Uninstall Etonym from the apps list in Windows settings (Settings → Apps). This also removes the Open with Etonym menu items. Your notes are not touched: they are files in your own folders.

The first screen of the uninstaller has a Delete the application data checkbox, which is off. If you leave it off, Etonym’s settings, folder list and logs stay in the Windows app data folders (%APPDATA%\app.etonym and %LOCALAPPDATA%\app.etonym), so a later install starts where you left off. Turn it on to remove them too.