Skip to content

Instantly share code, notes, and snippets.

@wey-gu
Last active October 8, 2025 08:48
Show Gist options
  • Save wey-gu/0996ef17742dc5002eccea9391b62e9f to your computer and use it in GitHub Desktop.
Save wey-gu/0996ef17742dc5002eccea9391b62e9f to your computer and use it in GitHub Desktop.
Macbook 12' (2015, 2016, 2017) Omarchy Linux Installation Notes

This gist is a note for:

  • Macbook 12' 2015: Macbook8,1
  • Macbook 12' 2016: Macbook9,1
  • Macbook 12' 2017: Macbook10,1

Follwing https://learn.omacom.io/2/the-omarchy-manual/97/mac-support is needed.

Table of Contents

Configurations

Screen Resolution

A reference in hyprland monitor conf.

.config/hypr/monitors.conf

env = GDK_SCALE,1.75
monitor=,preferred,auto,1.6

Key remap

  • Make CapsLock as Ctrl
  • Switch Ctrl(⌃) and Super(⌘) to maintain your muscle memory

To do that, append the kb_options value with comma as spliter in input conf files of hyprland.

.config/hypr/input.conf

  kb_options = compose:caps,caps:ctrl_modifier,ctrl:swap_lwin_lctl

Issues and Mitigation

issue 1: Keyboard not working in login phase

  1. Make sure the driver is already in the system:

ref: https://wiki.archlinux.org/title/Laptop/Apple#MacBook9,1_Early_2016

sudo pacman -Syu
sudo pacman -S dkms
yay -S macbook12-spi-driver-dkms 

2. Tell mkinitcpio to pack the needed modules early

Edit /etc/mkinitcpio.conf from

MODULES=(btrfs)

to

MODULES=(btrfs applespi intel_lpss_pci spi_pxa2xx_platform)

(The two helper modules are required because applespi sits on top of them.)

  1. Rebuild the initramfs
sudo mkinitcpio -P

issue 2: NVMe Not Wake From Sleep

ref:

Just create a systemd service that performs echo 0 > /sys/bus/pci/devices/0000\:01\:00.0/d3cold_allowed

Following the first ref will do the job!

issue 3: Audio

The audio didnt work perfectly.

  • If you need the 3.5mm interface to work with your headphone only, it's out of box working
  • If you need speaker work, install https://github.com/leifliddy/macbook12-audio-driver, while this will break your headphone, but, if you are using a dongle && a USB headphone, it works... NOTE: after install it, you cannot undo it clearly to have headphone working again...
@wey-gu
Copy link
Author

wey-gu commented Sep 26, 2025

update:

@wey-gu
Copy link
Author

wey-gu commented Sep 28, 2025

hints:

@wey-gu
Copy link
Author

wey-gu commented Oct 1, 2025

Enable two-finger right click && disable click while typing

Edit .config/hypr/input.conf

touchpad {

    # Use two-finger clicks for right-click instead of lower-right corner
    clickfinger_behavior = true

    disable_while_typing = true
  }

@e-minguez
Copy link

Note that installing the macbook12-audio-driver doesn't solve the "no audio after suspend" issue leifliddy/macbook12-audio-driver#18 (unless you use s2idle instead of suspend, but that makes the battery to drain after a couple hours)

@wey-gu
Copy link
Author

wey-gu commented Oct 3, 2025

Note that installing the macbook12-audio-driver doesn't solve the "no audio after suspend" issue leifliddy/macbook12-audio-driver#18 (unless you use s2idle instead of suspend, but that makes the battery to drain after a couple hours)

Thanks! Good to know that!

I wiped and clean install without it actually now as I prefer the 3.5mm hp to be working.

@e-minguez
Copy link

Just in case, I have the keyboard brightness shortcuts documented here https://gist.github.com/e-minguez/8b61afd87cc5a83e61d69793f469098b

@e-minguez
Copy link

And s2idle as:

$ cat /etc/systemd/sleep.conf.d/freeze.conf
[Sleep]
SuspendState=freeze

@wey-gu
Copy link
Author

wey-gu commented Oct 8, 2025

@e-minguez you are amazing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment