{"id":13908538,"url":"https://github.com/wimpysworld/umpc-ubuntu","last_synced_at":"2025-04-06T16:13:08.146Z","repository":{"id":39650384,"uuid":"152872527","full_name":"wimpysworld/umpc-ubuntu","owner":"wimpysworld","description":"Scripts for UMPCs such as GPD Pocket, Pocket 2, MicroPC \u0026 TopJoy Falcon","archived":false,"fork":false,"pushed_at":"2024-07-06T19:58:29.000Z","size":714,"stargazers_count":230,"open_issues_count":10,"forks_count":53,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-03-30T13:10:01.940Z","etag":null,"topics":["falcon","gpd","hacktoberfest","linux","m","micropc","netbook","p2max","pocket","pocket2","pocket3","topjoy","ubuntu","umpc","winmax"],"latest_commit_sha":null,"homepage":"https://ubuntu-mate.org/gpd-pocket/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wimpysworld.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"flexiondotorg","patreon":"wimpysworld","custom":"https://wimpysworld.io/tip"}},"created_at":"2018-10-13T13:03:20.000Z","updated_at":"2025-03-25T23:13:18.000Z","dependencies_parsed_at":"2022-08-09T15:08:46.108Z","dependency_job_id":"fadeba3f-476d-40fe-ad4b-bfe74abbf32f","html_url":"https://github.com/wimpysworld/umpc-ubuntu","commit_stats":{"total_commits":167,"total_committers":10,"mean_commits":16.7,"dds":0.07784431137724546,"last_synced_commit":"ca4c945217b45136b63264e1629af5b2b5f08373"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wimpysworld%2Fumpc-ubuntu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wimpysworld%2Fumpc-ubuntu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wimpysworld%2Fumpc-ubuntu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wimpysworld%2Fumpc-ubuntu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wimpysworld","download_url":"https://codeload.github.com/wimpysworld/umpc-ubuntu/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247509236,"owners_count":20950232,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["falcon","gpd","hacktoberfest","linux","m","micropc","netbook","p2max","pocket","pocket2","pocket3","topjoy","ubuntu","umpc","winmax"],"created_at":"2024-08-06T23:02:48.336Z","updated_at":"2025-04-06T16:13:08.125Z","avatar_url":"https://github.com/wimpysworld.png","language":"Shell","funding_links":["https://github.com/sponsors/flexiondotorg","https://patreon.com/wimpysworld","https://wimpysworld.io/tip"],"categories":["HarmonyOS"],"sub_categories":["Windows Manager"],"readme":"# UMPC hardware configuration for Ubuntu\n\nHere are a couple of scripts for Ultra Mobile PCs (UMPC) such as the\n[GPD Pocket](https://gpd.hk/gpdpocket), [GPD Pocket 2](https://gpd.hk/gpdpocket2),\n[GPD Pocket 3](https://gpd.hk/gpdpocket3), [GPD MicroPC](https://gpd.hk/gpdmicropc),\n[GPD WIN 2](https://gpd.hk/gdpwin2), [GPD P2 Max](https://www.gpd.hk/gpdp2max),\n[GPD WIN Max](https://gpd.hk/gpdwinmax) and [Topjoy Falcon](https://www.kickstarter.com/projects/440069565/falcon-worlds-first-8-inch-2-in-1-laptop)\nfor Ubuntu users.\n\n  * `umpc-ubuntu.sh`: install the required hardware configuration on a running Ubuntu install.\n  * `umpc-ubuntu-respin.sh`: modify an existing Ubuntu .iso image with UMPC specific hardware configuration.\n\nUltra Mobile PCs (UMPC) have had something of a resurgence in recent years\nthanks to very successful crowd funding campaigns for netbook style laptops\nfeaturing a high resolution touch displays housed in an aluminium alloy\nbody. These scripts for UMPC devices are based on the excellent work by\n[Hans de Goede](https://hansdegoede.livejournal.com/), [nexus511](https://apt.nexus511.net/),\n[stockmind](https://github.com/stockmind/gpd-pocket-ubuntu-respin) and many\nothers.\n\n![GPD Pockets](gpd-pockets.jpg \"The GPD Pocket \u0026 GPD Pocket 2 running Ubuntu MATE 18.10\")\n\n## Pre-configured images\n\nThe Ubuntu MATE team offers bespoke images for the\n[GPD Pocket](https://gpd.hk/gpdpocket),\n[GPD Pocket 2](https://gpd.hk/gpdpocket2),\n[GPD Pocket 3](https://gpd.hk/gpdpocket3),\n[GPD WIN 2](https://gpd.hk/gdpwin2),\n[GPD MicroPC](https://gpd.hk/gpdmicropc),\n[GPD P2 Max](https://www.gpd.hk/gpdp2max),\n[GPD WIN Max](https://gpd.hk/gpdwinmax) and\n[Topjoy Falcon](https://www.kickstarter.com/projects/440069565/falcon-worlds-first-8-inch-2-in-1-laptop)\nthat include the hardware specific tweaks to get these devices working\n*\"out of the box\"* without any faffing about. Some models of the OneMix\nYoga devices are also supported.\n\n  * \u003chttps://ubuntu-mate.org/download/\u003e\n\n## What works\n\nThe [Ubuntu MATE images for the UMPCs](https://ubuntu-mate.org/umpcs/) add the following tweaks:\n\n  * Enable **frame buffer, Plymouth and Xorg display rotation**.\n    * Supports `modesetting` *and* `xorg-video-intel` display drivers.\n  * Enable **TearFree rendering by default**.\n  * Enable touch screen rotation for Xorg and Wayland.\n  * Enable **scroll wheel emulation** for Xorg.\n    * While holding down the **right track point button** on the Pocket, Pocket 2 \u0026 Topjoy Falcon.\n    * While holding down the **centre track point button** on the MicroPC \u0026 Pocket 3.\n  * Enable double size console (tty) font resolution for high resolution devices.\n  * Enable **fractional scaling** for 1920x1200 displays. *(MATE Desktop only)*\n    * Results in an effective resolution of 1280x800 to make the display panels easily readable.\n    * Simple to toggle on/off if you want to restore full resolution.\n  * GPD Pocket:\n    * BRMC4356 WiFi firmware enabled by default.\n    * Fan control kernel module enabled by default.\n  * GPD Pocket 3 \u0026 TopJoy Falcon:\n    * **Accelerometer support for automatic screen rotation**.\n  * GPD WIN Max:\n    *  Features a custom, persistent, EDID.\n\n## Known Issues\n\n### The GRUB menu is rotated 90 degrees\n\nThe workaround is to tilt your head. Issue affects:\n\n  * GPD Pocket\n  * GPD Pocket 3\n  * GPD MicroPC\n  * GPD WIN 2\n  * GPD WIN Max\n  * TopJoy Falcon\n\n### Boot splash is rotated 90 degrees\n\nThe workaround is to tilt your head. Issue affects:\n\n  * GPD WIN Max\n\n### Touch coordinates incorrect when external HDMI monitor is connected\n\nWhen a HDMI display is connected, the touch coordinates on the internal display are incorrect. Issue affects:\n\n  * GPD Pocket 3\n\n## The Scripts\n\nThese scripts have been tested on [Ubuntu MATE](https://ubuntu-mate.org) 20.04.1.\nAll Ubuntu flavours should work although if you use Wayland your mileage may vary.\n\n### umpc-ubuntu.sh\n\nInstall one of the Ubuntu 20.04 (or newer) flavours on a supported UMPC\ndevice and run the following to inject the required hardware configuration.\n\n```bash\ngit clone https://github.com/wimpysworld/umpc-ubuntu.git\ncd umpc-ubuntu\n```\n\nEdit `./umpc-ubuntu.sh` and change `UMPC=\"gpd-pocket3\"` at the top of the script\nto match your computer, supported options are: `gpd-pocket`, `gpd-pocket2`,\n`gpd-pocket3`, `gpd-p2-max`, `gpd-micropc`, `gpd-win2`, `gpd-win-max` or `topjoy-falcon`.\n\nThen run the script to enable the configuration tweaks.\n\n```bash\nsudo ./umpc-ubuntu.sh enable\n```\n\n### umpc-ubuntu-respin.sh\n\n```bash\ngit clone https://github.com/wimpysworld/umpc-ubuntu.git\ncd umpc-ubuntu\n```\n\n  * Download an .iso image for one of the Ubuntu MATE 20.04 (or newer) or one of the other Ubuntu flavours.\n\n```bash\nsudo ./umpc-ubuntu-respin.sh -d gpd-pocket ubuntu-mate-20.04.3-desktop-amd64.iso\nsudo ./umpc-ubuntu-respin.sh -d gpd-pocket2 ubuntu-mate-20.04.3-desktop-amd64.iso\nsudo ./umpc-ubuntu-respin.sh -d gpd-pocket3 ubuntu-mate-21.10-desktop-amd64.iso\nsudo ./umpc-ubuntu-respin.sh -d gpd-micropc ubuntu-mate-20.04.3-desktop-amd64.iso\nsudo ./umpc-ubuntu-respin.sh -d gpd-p2-max ubuntu-mate-20.04.3-desktop-amd64.iso\nsudo ./umpc-ubuntu-respin.sh -d gpd-win2 ubuntu-mate-20.04.3-desktop-amd64.iso\nsudo ./umpc-ubuntu-respin.sh -d gpd-win-max ubuntu-mate-20.04.3-desktop-amd64.iso\nsudo ./umpc-ubuntu-respin.sh -d topjoy-falcon ubuntu-mate-20.04.3-desktop-amd64.iso\n```\n\nA new .iso will be created that includes the additional hardware tweaks required\nby the selected UMPC device.\n\n## Accessing boot menus \u0026 BIOS\n\nSwitch the device on, immediately hold/tap the corresponding key(s).\n\n|      Device      |      BIOS    |  Boot  Menu  |\n|   -------------  | ------------ | ------------ |\n| GPD Pocket       |    `Del`     | `Fn` + `F7`  |\n| GPD Pocket 2     | `Fn` + `F12` | `Fn` + `F12` |\n| GPD Pocket 3     | `Fn` + `F7`  | `Fn` + `F7`  |\n| GPD WIN 2(!)     |    `Del`     |    `Del`     |\n| GPD WIN 3(!)     |    `Del`     |    `Del`     |\n| GPD MicroPC      |    `Del`     | `Fn` + `F7`  |\n| GPD P2 Max       | `Fn` + `F7`  | `Fn` + `F7`  |\n| GPD WIN Max      |     `F7`     |     `F7`     |\n| OneMix Yoga 2    | `Fn` + `F7`  | `Fn` + `F7`  |\n| TopJoy Falcon    | `Fn` + `F2`  | `Fn` + `F12` |\n\n  * **GPD WIN 2/3(!)**: Boot it by holding `Del` (Fn+Backspace), navigate to *Save \u0026 Exit* and choose the storage device you want to boot from under *Boot Override*\n\n## Device matrix\n\nPlease help complete this table by running the following commands from an Ubuntu Live image:\n\n```\nxrandr --query\nxinput\n```\n\n|      Device      |    Monitor   | Resolution | Rotation |              Keyboard/Mouse               |          Touch Screen         | Kernel Req | Ubuntu Req |    Common     |\n|   -------------  | ------------ | ---------- | -------- | ----------------------------------------- | ----------------------------- | ---------- | ---------- | ------------- |\n| GPD Pocket       | DSI-1 / DSI1 | 1200x1920  | Right    | SINO WEALTH Gaming Keyboard               | Goodix Capacitive TouchScreen | \u003e= 4.14    | \u003e= 18.04.2 | gpd-pocket    |\n| GPD Pocket 2     | eDP-1 / eDP1 | 1200x1920  | Right    | HAILUCK CO.,LTD USB KEYBOARD Mouse        | Goodix Capacitive TouchScreen | \u003e= 4.18    | \u003e= 18.04.2 | gpd-pocket2   |\n| GPD Pocket 3     | DSI-1 / DSI1 | 1200x1920  | Right    | HAILUCK CO.,LTD USB KEYBOARD Mouse        | GXTP7380:00 27C6:0113         | \u003e= 5.15    | \u003e= 22.04   | gpd-pocket3   |\n| GPD WIN 2        | eDP-1 / eDP1 | 720x1280   | Right    | HK-ZYYK-US-A1-02-00 USB Keyboard Mouse    | Goodix Capacitive TouchScreen | \u003e= 4.18    | \u003e= 19.04   | gpd-win2      |\n| GPD WIN 3        | DSI-1 / DSI1 | 720x1280   | Right    |                                           | Goodix Capacitive TouchScreen | \u003e= 5.15    | \u003e= 22.04   | gpd-win3      |\n| GPD MicroPC      | DSI-1 / DSI1 | 720x1280   | Right    | AMR-4630-XXX-0- 0-1023 USB KEYBOARD Mouse | n/a                           | \u003e= 5.2     | \u003e= 19.10   | gpd-micropc   |\n| GPD P2 Max       | eDP-1 / eDP1 | 2560x1600  | n/a      | HAILUCK CO.,LTD USB KEYBOARD Mouse        | Goodix Capacitive TouchScreen |            |            | gpd-p2-max    |\n| GPD WIN Max      | eDP-1 / eDP1 | 800x1280   | Right    | HTIX5288:00 093A:0255 Mouse               | Goodix Capacitive TouchScreen | \u003e= 5.4     | \u003e= 20.04.1 | gpd-win-max   |\n| OneMix Yoga      |              | 1200x1920  | Right    | HAILUCK CO.,LTD USB KEYBOARD Mouse        | Goodix Capacitive TouchScreen | \u003e= 4.18    | \u003e= 18.04.2 |               |\n| OneMix Yoga 1s   | eDP-1 / eDP1 | 1200x1920  | Right    | HAILUCK CO.,LTD USB KEYBOARD Mouse        | Goodix Capacitive TouchScreen | \u003e= 4.18    | \u003e= 18.04.2 | gpd-pocket2   |\n| OneMix Yoga 2    | eDP-1 / eDP1 | 1200x1920  | Right    | HAILUCK CO.,LTD USB KEYBOARD Mouse        | Goodix Capacitive TouchScreen | \u003e= 4.18    | \u003e= 18.04.2 | gpd-pocket2   |\n| TopJoy Falcon    | DSI-1 / DSI1 | 1200x1920  | Right    | HAILUCK CO.,LTD USB KEYBOARD Mouse        | Goodix Capacitive TouchScreen | \u003e= 4.18    | \u003e= 18.04.2 | topjoy-falcon |\n| Chuwi Minibook X | DSI-1 / DSI1 | 1200x1920  | Right    | SIPODEV USB Composite Device Mouse        |                               |            |            |               |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwimpysworld%2Fumpc-ubuntu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwimpysworld%2Fumpc-ubuntu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwimpysworld%2Fumpc-ubuntu/lists"}