Diterjemahkan dari bahasa Inggris; bahasa Inggris menjadi acuan untuk harga dan ketentuan.

Getting started

PaperWM.spoon di macOS: instal dan atur dasarnya

PaperWM.spoon adalah plugin pengelola jendela tiling yang dapat digulir dan gratis untuk Hammerspoon di macOS. Untuk mengaturnya, instal Hammerspoon, kloning repositori PaperWM.spoon ke folder Spoons milik Hammerspoon, muat dan jalankan Spoon dari init.lua, lalu berikan izin yang diminta macOS. Perintah di bawah ini mengikuti README proyek, diperiksa pada 2026-11-12.

4 menit baca ·

Fakta utama

  • PaperWM.spoon adalah Spoon Hammerspoon, bukan aplikasi Mac yang berdiri sendiri.
  • README-nya menyediakan perintah kloning dan contoh konfigurasi Lua.
  • README meminta Anda mengubah dua pengaturan Mission Control: menonaktifkan penataan ulang Space otomatis dan mengaktifkan Spaces terpisah untuk layar.
  • Ini cocok jika Anda menginginkan pengaturan berbasis Lua yang dapat dikonfigurasi; orang yang lebih suka menghindari pemeliharaan konfigurasi Hammerspoon mungkin memilih alat lain.

Instal Hammerspoon terlebih dahulu

Unduh Hammerspoon dari situs resminya, diperiksa pada 2026-11-12. Buka sekali dan ikuti perintah izin macOS. Hammerspoon menjalankan skrip otomasi, jadi tinjau apa yang Anda pasang dan kode yang Anda pilih untuk dimuat. README proyek PaperWM.spoon menjelaskan plugin dan pengaturannya. Kami belum menguji langkah-langkah ini pada setiap versi macOS.

README resmi PaperWM.spoon, diperiksa pada 2026-11-12, memberikan perintah instalasi ini:

``bash git clone https://github.com/mogenson/PaperWM.spoon ~/.hammerspoon/Spoons/PaperWM.spoon ``

Jalankan di Terminal. Perintah ini mengkloning repositori ke folder Spoons yang digunakan Hammerspoon. Jika Anda memakai direktori konfigurasi Hammerspoon kustom, sesuaikan tujuannya agar cocok.

Atur opsi Mission Control

README mengarahkan Anda ke Preferensi Sistem → Desktop & Dock dan bagian Mission Control. Di macOS terkini, buka Pengaturan Sistem → Desktop & Dock, lalu gulir ke Mission Control. Matikan Atur ulang Space secara otomatis berdasarkan penggunaan terbaru dan aktifkan Tampilan memiliki Spaces terpisah. Penulisan dan letak pengaturan ini dapat berbeda di setiap versi macOS. README mencantumkan opsi ini sebagai bagian dari pengaturannya.

Ini adalah pilihan untuk seluruh sistem yang memengaruhi cara macOS menangani Spaces. Putuskan apakah pilihan tersebut sesuai dengan pengaturan Anda sebelum mengubahnya. Jika Anda menggunakan beberapa layar, pastikan perilaku Space-nya sesuai dengan yang Anda inginkan.

Muat dan jalankan Spoon

Buka file konfigurasi Hammerspoon di ~/.hammerspoon/init.lua. Tambahkan baris Lua berikut:

``lua PaperWM = hs.loadSpoon("PaperWM") PaperWM:bindHotkeys(PaperWM.default_hotkeys) PaperWM:start() ``

Simpan file. Dari ikon Hammerspoon di bilah menu, pilih Reload Config. Baris pertama memuat Spoon, baris kedua mendaftarkan keybinding bawaan yang didokumentasikan, dan baris ketiga mulai mengelola jendela. README proyek juga menunjukkan jalur SpoonInstall dan contoh binding kustom. Mulailah dengan default-nya sebelum mengubah tombol agar Anda dapat memastikan pengaturannya berhasil dimuat.

Untuk menghentikan PaperWM.spoon, panggil PaperWM:stop() melalui konsol atau konfigurasi Hammerspoon. Jika saat startup muncul pesan Spoon tidak ditemukan, pastikan folder kloningnya bernama PaperWM.spoon dan berada di dalam folder Spoons yang digunakan Hammerspoon. Periksa konsol Hammerspoon untuk kesalahan Lua sebelum mengubah beberapa pengaturan sekaligus.

Periksa binding dan lakukan satu perubahan

README PaperWM.spoon, diperiksa pada 2026-11-12, mendokumentasikan default untuk fokus dengan Option–Command–panah, menukar dengan Option–Command–Shift–panah, dan menggilir lebar dengan Option–Command–R. README juga menunjukkan binding untuk mengambang, Spaces, dan pengubahan ukuran jendela. Jika sebuah pintasan berbenturan dengan aplikasi lain, ubah tabel Lua, muat ulang konfigurasi, dan periksa konsol Hammerspoon jika plugin berhenti merespons.

Konfigurasi Spoon sendiri dapat menyaring aplikasi dan menyesuaikan rasio jendela. README menunjukkan window_filter dan window_ratios sebagai titik konfigurasi. Ubah hanya pengaturan yang dapat Anda temukan dalam dokumentasi, lalu uji satu jendela aplikasi biasa dan satu aplikasi yang ingin Anda kecualikan. Para pengelola juga mencatat bahwa macOS membatasi pemindahan jendela sepenuhnya ke luar layar, sehingga jendela tiling di tepi mungkin tetap terlihat sebagian.

Ini adalah rangkaian alat berbasis Lua. Cocok bagi orang yang nyaman membaca file konfigurasi dan menginginkan fleksibilitas Hammerspoon. Orang yang lebih suka aplikasi mandiri dan jendela pengaturan mungkin merasa pengaturan ini memberatkan untuk dipelihara. Instruksi pengaturan di README adalah acuan resmi untuk PaperWM.spoon; periksa repositorinya sebelum mengikutinya, karena proyek open source dapat berubah.

README PaperWM.spoon menyatakan “Inspired by PaperWM” dan menautkan ke proyek PaperWM, diperiksa pada 2026-11-12. Kedua proyek memiliki implementasi dan petunjuk pengaturan yang terpisah.

Kami yang membuat SlidePane, aplikasi macOS untuk orang yang ingin mengatur tata letak jendela tanpa memelihara skrip Lua. Aplikasi ini mungkin cocok jika Anda lebih suka pengaturan aplikasi dan kontrol pintasan bawaan; PaperWM.spoon lebih cocok jika Anda menginginkan model skrip Hammerspoon. Lihat Instal SlidePane dan mulai uji coba gratis untuk pengaturan aplikasi.

Pautan terkait

Artikel Niri untuk Mac membandingkan alur kerja bergulir lainnya. Pintasan dan tata letak keyboard menjelaskan cara meninjau pintasan aplikasi.