Fix Touchpad Gestures Not Working on Wayland in Ubuntu 24.04

You move the pointer normally, two-finger scrolling may still work, but the familiar three-finger swipe no longer opens Activities or switches workspaces. On Ubuntu 24.04, that symptom is often misdiagnosed as “Wayland gestures being disabled.” In the standard GNOME desktop, there is no separate master switch for the built-in three-finger system gestures. The useful question is where the gesture stops: at the session, the touchpad settings, libinput, GNOME Shell, or the hardware itself.

This guide starts with checks that are fast and reversible, then moves toward input diagnostics. Ubuntu 24.04 LTS uses GNOME on Wayland by default on supported systems, and GNOME documents three-finger swipes for opening the Activities overview and switching workspaces. The underlying libinput stack can report swipe and pinch events on supported touchpads. Those two facts give us a clean troubleshooting path: confirm Wayland, confirm the touchpad is active, test the stock GNOME gesture, then verify whether libinput receives multi-finger events.

1. Confirm that you are actually in a Wayland session

Open Terminal and run:

echo $XDG_SESSION_TYPE

The expected result is wayland. If the command prints x11, you are troubleshooting a different input path. Ubuntu can still offer an Xorg session, and gesture behavior there is not identical to the native GNOME Wayland experience.

If you are on Xorg and want the default Wayland session, log out. On the sign-in screen, select your account, open the session chooser, and choose Ubuntu rather than Ubuntu on Xorg when those options are available. Hardware, graphics drivers, remote desktop sessions, or administrator policy can affect which sessions are offered, so do not force a missing option without checking why it is unavailable.

GNOME’s official gesture behavior is documented in GNOME Help: Use gestures on touchpads and touchscreens.

2. Make sure the touchpad itself is enabled

Open Settings > Mouse & Touchpad. Confirm that the touchpad is enabled. Also test two-finger scrolling and basic tapping. GNOME’s settings panel exposes touchpad controls only when the desktop recognizes a touchpad, so a missing Touchpad section is a meaningful clue rather than a cosmetic problem.

อย่าเสียเวลาไปกับการมองหาตัวเลือก "ท่าทางสัมผัสสามนิ้ว" ในแผงการตั้งค่าของ Ubuntu 24.04 ท่าทางสัมผัสของระบบ GNOME Shell นั้นโดยปกติแล้วจะไม่มีสวิตช์เปิด/ปิดเฉพาะในส่วนนั้น หากการเลื่อนเคอร์เซอร์ด้วยนิ้วและการเลื่อนด้วยสองนิ้วใช้งานได้ แต่ท่าทางสัมผัสสามนิ้วใช้งานไม่ได้ ให้ลองทดสอบในขั้นตอนต่อไป

สำหรับรายละเอียดเกี่ยวกับการควบคุมทัชแพด โปรดดูที่GNOME Help: คลิก ลาก หรือเลื่อนด้วยทัชแพด

3. ทดสอบท่าทางสัมผัสมาตรฐานของ GNOME ไม่ใช่ท่าทางสัมผัสเฉพาะของแอป

ใช้สามนิ้วปัดขึ้นบนทัชแพด GNOME จะเปิดภาพรวมกิจกรรม การปัดขึ้นอีกครั้งจะเปิดมุมมองแอปพลิเคชัน การปัดสามนิ้วไปทางซ้ายหรือขวาจะสลับพื้นที่ทำงาน นี่คือการทดสอบพื้นฐานที่ดีที่สุด เพราะเป็นการใช้ท่าทางสัมผัสของ GNOME Shell ไม่ใช่ฟีเจอร์จาก Firefox, ส่วนขยายเบราว์เซอร์, ส่วนเสริมเดสก์ท็อป หรือโปรแกรมจัดการท่าทางสัมผัสจากภายนอก

การซูมด้วยการบีบนิ้วนั้นแตกต่างออกไป libinput สามารถจดจำท่าทางการบีบนิ้วได้ แต่การซูมเนื้อหาด้วยการบีบนิ้วนั้นขึ้นอยู่กับแอปพลิเคชันและชุดเครื่องมือ การปัดนิ้วสามนิ้วที่ใช้งานได้ในพื้นที่ทำงานควบคู่กับการบีบนิ้วที่ใช้งานไม่ได้ในแอปพลิเคชันหนึ่ง มักจะชี้ไปที่แอปพลิเคชันนั้น ไม่ใช่ Wayland โดยรวม

4. ตรวจสอบว่า libinput ตรวจพบทัชแพดหรือไม่

Ubuntu มีlibinput-toolsแพ็กเกจสำหรับการวินิจฉัยข้อมูลขาเข้า หากlibinputคำสั่งนี้ยังไม่ได้ติดตั้ง ให้เพิ่มโดยใช้คำสั่ง:

sudo apt update
sudo apt install libinput-tools

จากนั้นแสดงรายการอุปกรณ์:

sudo libinput list-devices

ค้นหาบล็อกสำหรับทัชแพดของคุณ ชื่อรุ่น โหนดเหตุการณ์ ขนาด และการกำหนดค่าจะแตกต่างกันไปตามแล็ปท็อป สิ่งสำคัญคือ libinput จะต้องแสดงรายการอุปกรณ์นั้นเป็นทัชแพดและแสดงความสามารถที่คาดหวังไว้ แพ็กเกจ Ubuntu 24.04 มีเอกสารอยู่ในแคตตาล็อกแพ็กเกจ Ubuntu Nobleและคำสั่งนั้นก็มีอธิบายไว้ในหน้าคู่มือ libinput ของ Ubuntu

หากไม่มีทัชแพดในระบบlibinput list-devicesปัญหานี้ไม่ได้เกี่ยวข้องกับท่าทางสัมผัสของ GNOME อีกต่อไปแล้ว ตรวจสอบว่าอุปกรณ์ปรากฏในเฟิร์มแวร์/การตั้งค่า BIOS หรือไม่ ตรวจสอบว่าตัวสลับทัชแพดฮาร์ดแวร์ทำงานอยู่หรือไม่ และเคอร์เนลมองเห็นอุปกรณ์หลังจากรีบูตหรือไม่ จำเป็นต้องแก้ไขปัญหาเฉพาะของเคอร์เนล, I2C-HID หรือเฟิร์มแวร์ในแล็ปท็อปแต่ละรุ่นก่อนที่ GNOME จะสามารถรับท่าทางสัมผัสได้

5. สังเกตเหตุการณ์ท่าทางดิบๆ

การทดสอบที่ให้ข้อมูลมากที่สุดคือการตรวจสอบว่าไลบรารี libinput ส่งเหตุการณ์ท่าทางขณะที่คุณขยับสามนิ้วหรือไม่ เรียกใช้คำสั่ง:

sudo libinput debug-events

จากนั้นให้ปัดนิ้วสามนิ้ว บนฮาร์ดแวร์ที่รองรับ คุณจะเห็นบรรทัดเหตุการณ์ท่าทาง เช่น การเริ่มต้นการปัด การอัปเดต และการสิ้นสุด โหนดเหตุการณ์ เวลา การเปลี่ยนแปลง และรูปแบบอาจแตกต่างกันไป คำสั่งนี้มักต้องการสิทธิ์ระดับรูท เนื่องจากอ่านค่า/dev/input/event*จากอุปกรณ์โดยตรง

หน้าคู่มือการใช้งาน อย่างเป็นทางการของ Ubuntu สำหรับ libinput-debug-eventsอธิบายว่าเครื่องมือนี้เป็นตัวช่วยในการดีบัก และเตือนว่ารูปแบบเอาต์พุตอาจเปลี่ยนแปลงได้เอกสารประกอบการใช้งานท่าทางสัมผัส ของ libinput เอง อธิบายวิธีการสร้างท่าทางสัมผัสแบบปัดและแบบบีบ

หากมีการแสดงเหตุการณ์การใช้ท่าทาง: แสดงว่าฮาร์ดแวร์และส่วนของ libinput ทำงานได้ถูกต้อง ขั้นตอนต่อไปคือการตรวจสอบ GNOME Shell, ส่วนขยาย, สถานะเซสชัน และการอัปเดตหากไม่มีการแสดงเหตุการณ์การใช้ท่าทางหลายนิ้ว:ให้ทดสอบอีกครั้งโดยแยกนิ้วออกจากกันอย่างชัดเจน หากมีการแสดงเหตุการณ์ตัวชี้พื้นฐาน แต่ไม่เคยมีการแสดงท่าทางสามนิ้ว แสดงว่าทัชแพดอาจขาดความสามารถในการสัมผัสหลายนิ้วที่จำเป็น หรืออาจมีปัญหาเกี่ยวกับเคอร์เนล/เฟิร์มแวร์ที่ทำให้ไม่สามารถรายงานการสัมผัสได้เพียงพอ

6. ติดตั้งการอัปเดตล่าสุดของ Ubuntu 24.04

ก่อนที่จะเปลี่ยนไดรเวอร์หรือแก้ไขไฟล์การกำหนดค่าระดับต่ำ โปรดอัปเดตแพ็กเกจ 24.04 ที่ติดตั้งไว้ให้เป็นเวอร์ชันล่าสุด:

sudo apt update
sudo apt upgrade

รีบูตเครื่องหากการอัปเดตติดตั้งเคอร์เนลใหม่ ชุดกราฟิก หรือส่วนประกอบอื่นๆ ที่ต้องรีสตาร์ท การจัดการท่าทางสัมผัสเกี่ยวข้องกับหลายระดับ ตั้งแต่ไดรเวอร์อินพุตของเคอร์เนล libinput Mutter/GNOME Shell และแอปพลิเคชัน ดังนั้นข้อบกพร่องที่แก้ไขแล้วอาจยังคงปรากฏให้เห็นในเครื่องที่ยังไม่ได้อัปเดต

หลีกเลี่ยงการดาวน์โหลดแพ็กเกจ Synaptics ที่ไม่น่าเชื่อถือ หรือคัดลอกส่วนการตั้งค่า Xorg เก่าๆ จากบทช่วยสอนที่เขียนขึ้นสำหรับ Ubuntu เวอร์ชันเก่าๆ ภายใต้เซสชัน Wayland GNOME มาตรฐาน ไลบรารีอินพุตที่เกี่ยวข้องคือ libinput และไฟล์การตั้งค่าเฉพาะ Xorg ไม่ใช่วิธีที่เชื่อถือได้ในการแก้ไขปัญหาการใช้งานท่าทางสัมผัสของ GNOME Shell

7. ปิดใช้งานส่วนขยาย GNOME Shell ชั่วคราว

หากlibinput debug-eventsแสดงการปัดสามนิ้วอย่างชัดเจน แต่ GNOME ไม่ตอบสนองใดๆ ให้ปิดใช้งานส่วนขยาย GNOME Shell ของบุคคลที่สามชั่วคราวแล้วทดสอบอีกครั้ง ส่วนขยายอาจเปลี่ยนแปลงพฤติกรรมของพื้นที่ทำงาน การจัดการหน้าต่าง พฤติกรรมภาพรวม หรือการจัดการท่าทางสัมผัส ใช้แอปส่วนขยายหากคุณติดตั้งไว้ หรือแสดงรายการส่วนขยายที่เปิดใช้งานโดยใช้คำสั่ง:

gnome-extensions list --enabled

ปิดใช้งานส่วนขยายที่น่าสงสัยทีละรายการโดยใช้คำสั่ง:

gnome-extensions disable EXTENSION_UUID

แทนที่EXTENSION_UUIDด้วยตัวระบุที่ได้จากคำสั่ง list การออกจากระบบแล้วเข้าสู่ระบบใหม่หลังจากเปลี่ยนส่วนขยาย Shell จะช่วยให้แน่ใจได้ว่าคุณกำลังทดสอบในเซสชันที่สะอาด

ขั้นตอนนี้เป็นการวินิจฉัยปัญหา ไม่ใช่คำแนะนำให้ใช้งานโดยไม่มีส่วนขยายอย่างถาวร เมื่อคุณระบุส่วนขยายที่ก่อให้เกิดปัญหาได้แล้ว ให้ทำการอัปเดต ปรับการตั้งค่า หรือปิดใช้งานเฉพาะส่วนขยายนั้น

8. กลับเข้าสู่เซสชัน Wayland ที่สะอาด แล้วทดสอบอีกครั้ง

ออกจากระบบ เลือกเซสชัน Ubuntu Wayland ปกติเมื่อเข้าสู่ระบบ และทำการทดสอบท่าทางสัมผัสมาตรฐานซ้ำอีกครั้งก่อนที่จะเปิดแอปพลิเคชันต่างๆ อีกครั้ง การทำเช่นนี้จะล้างสถานะชั่วคราวของ GNOME Shell และทำให้ตรวจสอบได้ง่ายขึ้นว่าส่วนขยายหรือกระบวนการเฉพาะเซสชันนั้นเกี่ยวข้องหรือไม่

หากระบบกลับไปที่ Xorg เสมอแม้ว่าคุณจะเลือก Ubuntu แล้ว ให้ตรวจสอบสาเหตุแทนที่จะสันนิษฐานว่าทัชแพดมีปัญหา ความเข้ากันได้ของไดรเวอร์กราฟิก การกำหนดค่าการเข้าถึงระยะไกล หรือนโยบายภายในเครื่องอาจเปลี่ยนแปลงเซสชันที่ใช้งานได้

เหตุใดการติดตั้ง Touchegg จึงมักไม่ใช่วิธีแก้ปัญหาแรกบน Wayland

คำแนะนำทั่วไปคือให้ติดตั้ง daemon สำหรับการควบคุมท่าทางสัมผัสทันที ซึ่งอาจมีประโยชน์สำหรับการกระทำแบบกำหนดเองในบางสภาพแวดล้อม แต่ไม่ใช่ทางออกแรกที่ถูกต้องเมื่อท่าทางสัมผัสในตัวของ GNOME ล้มเหลวในเซสชัน Wayland GNOME Shell ได้ใช้งานท่าทางสัมผัสสามนิ้วของระบบอยู่แล้ว การเพิ่มเลเยอร์ท่าทางสัมผัสอีกชั้นก่อนที่จะตรวจสอบว่า libinput มองเห็นอะไร อาจทำให้การวินิจฉัยยากขึ้นและอาจก่อให้เกิดความขัดแย้งกับท่าทางสัมผัสที่สงวนไว้ของระบบ

หลักเกณฑ์การออกแบบส่วนติดต่อผู้ใช้ของ GNOME ระบุว่า ท่าทางสัมผัสด้วยสามและสี่นิ้วนั้นสงวนไว้สำหรับการใช้งานของระบบ นั่นคือเหตุผลที่พฤติกรรมการใช้ท่าทางสัมผัสในระดับแอปพลิเคชันไม่สามารถใช้แทนกันได้กับท่าทางสัมผัสในพื้นที่ทำงานของเดสก์ ท็อป โปรด ดู หลักเกณฑ์เกี่ยวกับตัวชี้และระบบสัมผัสของ GNOME

จะตรวจสอบได้อย่างไรว่าปัญหาได้รับการแก้ไขแล้วจริง ๆ

อย่าหยุดแค่เพียง “เคอร์เซอร์เคลื่อนที่” การซ่อมแซมที่ประสบความสำเร็จควรผ่านการตรวจสอบอิสระหลายขั้นตอน:

• echo $XDG_SESSION_TYPEส่งwaylandคืน
• ส่วนของทัชแพดมีอยู่ในเมนูการตั้งค่า และการทำงานของทัชแพดก็เป็นไปตามปกติ
• การปัดนิ้วสามนิ้วขึ้นจะเปิดหน้าต่างกิจกรรม
• การปัดนิ้วสามนิ้วไปทางซ้ายหรือขวาจะสลับพื้นที่ทำงาน
• sudo libinput debug-eventsแสดงเหตุการณ์การใช้ท่าทางหลายนิ้วที่สอดคล้องกัน
• ท่าทางสัมผัสเหล่านี้ยังคงใช้งานได้แม้หลังจากออกจากระบบหรือรีบูตเครื่องแล้ว

หากการทดสอบ libinput สำเร็จ แต่ท่าทางสัมผัสของ GNOME ยังคงล้มเหลวหลังจากอัปเดต ทดสอบส่วนขยาย และเข้าสู่ระบบ Wayland ใหม่ แสดงว่าคุณได้จำกัดปัญหาให้แคบลงเหลือเพียงปัญหาในระดับเซสชันเดสก์ท็อปหรือคอมโพสิเตอร์แล้ว ในขั้นตอนนี้ ให้รวบรวมเวอร์ชัน Ubuntu เวอร์ชันเคอร์เนลuname -rเวอร์ชัน GNOME Shell gnome-shell --versionรุ่นทัชแพดlibinput list-devicesและคำอธิบายสั้น ๆ ว่าท่าทางสัมผัสมาตรฐานใดล้มเหลว หลักฐานเหล่านั้นมีประโยชน์มากกว่าการติดตั้งไดรเวอร์ใหม่โดยไม่รู้ข้อมูลอะไรเลยสำหรับการรายงานข้อบกพร่อง

หาก libinput ไม่รายงานการใช้งานท่าทางสัมผัสสามนิ้ว ให้เน้นที่ความสามารถของฮาร์ดแวร์ เฟิร์มแวร์ และการรองรับเคอร์เนล หากมีเพียงแอปพลิเคชันเดียวที่ท่าทางสัมผัสแบบบีบหรือการนำทางล้มเหลว ในขณะที่ท่าทางสัมผัสในพื้นที่ทำงานของ GNOME ทำงานได้ ให้แก้ไขปัญหาแอปพลิเคชันนั้นแยกต่างหาก ความแตกต่างนี้เป็นกุญแจสำคัญในการแก้ไขปัญหาท่าทางสัมผัสของทัชแพดบน Ubuntu 24.04 โดยไม่ทำให้ปัญหาการป้อนข้อมูลเล็กๆ กลายเป็นปัญหาการกำหนดค่าระบบที่ใหญ่ขึ้น