FAQ

Platform notes for macOS and Linux, Wayland hotkeys, and Ollama.

macOS

  • After copying the app to /Applications, you may need to clear quarantine:

    xattr -cr /Applications/typo.app

  • Enable Accessibility (and related permissions) for typo in System Settings so selection and paste automation work reliably.

Linux installation (AppImage)

For installation and auto-updates, we recommend the AppImage build:

# Move the downloaded AppImage to a permanent location
mv ~/Downloads/typo_*.AppImage ~/Applications/typo.appimage
# Make it executable
chmod +x ~/Applications/typo.appimage

Desktop entry

Create ~/.local/share/applications/typo.desktop (replace <$USER> with your username). A user-local path avoids sudo and scopes the launcher to your account:

[Desktop Entry]
Name=Typo
Comment=AI-powered text improvement tool
Exec=/home/<$USER>/Applications/typo.appimage --no-sandbox
Icon=typo
Type=Application
Categories=Utility;TextEditor;
Terminal=false

Application icon

Install the icon under your user icon theme (no sudo):

mkdir -p ~/.local/share/icons/hicolor/256x256/apps
curl -L -o ~/.local/share/icons/hicolor/256x256/apps/typo.png https://raw.githubusercontent.com/yuler/typo/main/resources/logo.png

If your desktop does not pick up Icon=typo, set Icon to the absolute path of that PNG in the .desktop file, or run gtk-update-icon-cache ~/.local/share/icons/hicolor.

Linux Wayland compatibility

Wayland restricts global hotkey listeners for security. Use a system shortcut instead of relying only on in-app hotkeys.

1. Add a custom shortcut

  1. Open Settings → Keyboard → Custom Shortcuts.
  2. Add a command: typo --selection (or the full path to your AppImage).
  3. Assign Ctrl + Shift + X (or your preferred binding).

For reliable selection capture and pasting on Wayland, consider ydotool for keyboard simulation. It is fast but needs a one-time system setup (based on the ydotool uinput discussion):

Add your user to the input group

sudo usermod -aG input $USER

Log out and back in (or reboot) so the new group membership applies.

Add a udev rule for uinput

echo 'KERNEL=="uinput", GROUP="input", MODE="0660", OPTIONS+="static_node=uinput"' | sudo tee /etc/udev/rules.d/80-uinput.rules > /dev/null
sudo udevadm control --reload-rules
sudo udevadm trigger

Autostart the ydotool daemon

Create ~/.config/autostart/ydotoold.desktop:

[Desktop Entry]
Type=Application
Name=ydotool daemon
Exec=/usr/bin/ydotoold

Adjust Exec if ydotoold is not installed as /usr/bin/ydotoold on your distro.

3. XWayland workaround (optional)

If selection capture fails in some Electron apps, try running them in X11 mode, e.g.:

code --ozone-platform=x11

Ollama

  • Ensure Ollama is running: ollama serve.
  • See the Ollama API documentation for request/response details and model management.