Skip to content

About

A Mac Keyboard Layout for latin american keyboards

Topics

Resources

Stars

256 stars

Watchers

7 watching

Forks

Latest commit

 

History

34 Commits

Folders and files

Repository files navigation

Latam-Keyboard

macOS keyboard layouts for Latin American keyboards.

Apple's own Latin American layout doesn't match many of these keyboards. For example, < and > often end up on the wrong key on external keyboards. These layouts follow the labels on the keys, keep the layout's own characters for shortcuts like Cmd++, and tell macOS they're for Latin American Spanish.

Keyboard Viewer showing the Latin American - B layout

Install

Install with Homebrew:

brew install --cask neosergio/tap/latam-keyboard

Homebrew will ask for your password, because the layouts are installed for all users in /Library/Keyboard Layouts.

Log out and back in, then go to System Settings > Keyboard > Input Sources > Edit > +. The layouts are listed under Spanish, or you can search for "Latin American". Because they're marked as Latin American Spanish, apps like Word use Spanish spelling while you type with them.

The Latin American layouts listed under Spanish in the add input source dialog

To update to a new version:

brew upgrade --cask latam-keyboard

Upgrading from version 1.0.x

Version 1.1.0 changed how the layouts are packaged, and macOS sees them as new layouts. After brew upgrade, remove the old Latin American layouts from System Settings > Keyboard > Input Sources, log out and back in, and add them again.

Upgrading from a manual install

Earlier versions of this README said to copy the files into ~/Library/Keyboard Layouts by hand. If you did that, remove those copies before or after installing with Homebrew, so that each layout shows up only once:

rm ~/Library/Keyboard\ Layouts/Latam_*

Uninstall

  1. Remove the layout from System Settings > Keyboard > Input Sources.
  2. Run brew uninstall --cask latam-keyboard.
  3. Log out and back in.

Which layout to choose

There are several versions. Try them and choose the one that works for you. The main difference between them is which key types < and which types |. To see what each key types, choose Show Keyboard Viewer from the input menu in the menu bar.

  • Type A: frequently used with external keyboards. < is next to the left Shift key, and | is below Esc.

    An external USB keyboard with Latin American labels

  • Type B: frequently used with built-in Mac keyboards. | is next to the left Shift key, and < is below Esc.

    A MacBook built-in keyboard with Spanish labels

  • Type C: for some gaming keyboards. It types the same as Type B, except that with Shift those two keys give > and ° the other way around, to match how those keyboards are labeled.

  • Type D (deprecated, will be removed in version 1.2.0): it was added because Command shortcuts like Cmd++ didn't work in the other layouts. That was fixed in version 1.0.3, and Type D now types the same as Type A except with Option. If you use Type D, switch to Type A.

Caps Lock only changes letters, including Ñ. The other keys keep their characters:

Keyboard Viewer with Caps Lock on, showing capital letters and Ñ

The icon

The icon of Types A, B, C and D is a black continent with a thin white outline, so it stays visible over any menu bar color. That matters since macOS 26, where the menu bar is transparent and its color depends on your wallpaper, not on light or dark mode.

Light wallpaper Dark wallpaper
The layout icon in a light menu bar The layout icon in a dark menu bar

It also shows up in the badge next to the text cursor when you switch layouts:

The input source badge next to the text cursor, with the Latin American layout selected

Types A, B and C also come in a White version with a fixed white icon, from before this icon existed. You don't need them anymore, and they'll be removed in version 1.2.0.

Contribute

Feel free to contribute, adapt or improve these layouts and share them with the community.

Before sending a pull request, run tests/run.sh. It checks every layout through macOS itself, including what the keys type, without needing a Latin American keyboard or a logout. You need Xcode or the Command Line Tools.

About

A Mac Keyboard Layout for latin american keyboards

Topics

Resources

Stars

256 stars

Watchers

7 watching

Forks

Releases

Packages

Contributors

Languages