vi7 / keyboard-layouts

Custom keyboard layouts for macOS and related tooling

Custom keyboard layouts for macOS

Кастомные раскладки клавиатуры для macOS

Table of contents

• Usage
• Layouts description
• Development

Usage

1. Copy layout bundle from layouts to ~/Library/Keyboard\ Layouts on your macOS. Example:

   cp -r layouts/ru_antiwar.bundle ~/Library/Keyboard\ Layouts/

2. Reboot macOS
3. Go to  > System Preferences > Keyboard > Input Sources, click + under the list of input sources New layout will be available there:

Layouts description

• layouts/ru_antiwar.bundle - Russian language layout with Anti-war flag of protestors - for those who hate looking at tricolor flag on their menu bar / Русская расскладка с правильным флагом для тех, кому не хочется видеть триколор в своём менюбаре

Development

1. Generate iconset bundle if you plan to use custom icon for your keyboard layout. Use scripts/create_icns.sh for this purpose.
2. Use Ukulele to create keyboard layout, add icon and save it as bundle (More details are here)
3. Created bundle could be used to add new Input source on your macOS. See Usage for the details