TypePTonUS

A minimal setup for typing Portuguese accents using the US keyboard layout, powered by AutoKey.

Table of Contents

• TypePTonUS
  • Table of Contents
  • Introduction
  • Quickstart
    • 1. Clone Repository
    • 2. Install AutoKey (if not installed)
    • 3. Apply Config
    • 4. Restart AutoKey
  • Requirements
  • Troubleshooting

Introduction

TypePTonUS enables typing accented characters like á, é, ç, ã, â and others using a US keyboard layout - without needing to switch to the US-International layout.

It focuses only on what's essential: typing Portuguese naturally and directly, with no dead keys, no extra keystrokes, and no interference on regular typing.

Quickstart

1. Clone Repository

git clone https://github.com/lfelipediniz/TypePTonUS.git
cd TypePTonUS

2. Install AutoKey (if not installed)

sudo apt update
sudo apt install autokey-gtk

3. Apply Config

./install_autokey_config.sh

4. Restart AutoKey

autokey-gtk &

Requirements

• AutoKey (GTK version)
• Linux with US Keyboard Layout active

Troubleshooting

• AutoKey must be running to apply the abbreviations
• Some apps may block simulated key input (try using in a text editor)
• All shortcuts can be edited in the AutoKey GUI

---

No dead keys, no hassle - just accents that work 🇧🇷🇺🇸