Documentation
Everything Edgepad does, and how.
Install, pair, use the control surface and fix what goes wrong. Looking for the wire protocol, the architecture or the quality gate? That is the developer documentation.
Start here
What Edgepad is
It is for the times the laptop is across the room rather than under your hands: plugged into a television, docked on a desk you are not sitting at, parked somewhere a mouse dongle will not reach.
The alternatives are a remote app that only sends media keys, or a remote-desktop app that streams the whole screen and wants an account and a network round trip to change the volume. Edgepad is neither. The phone and the laptop pair once, the way a headset does, and after that they talk directly: no account, no service in between that can be slow or down.
The cost of the default link is Bluetooth's own. Both ends need it, and it does not reach another room or the internet. Wi-Fi and USB connections are optional, off until you turn them on in the laptop's menu, and the phone's half of them has not been tried on real devices yet.
What it does
Corner rulers
Each corner holds a dial drawn as a ruler that wraps the bend. Slide along it, clockwise to raise. Volume, brightness, media scrub, zoom, app switcher, refresh rate, scroll, desktops, browser tabs or the Devices dial; Surface settings pick what each corner does, how long the rulers are and how tall. Split corners gives each corner two dials, eight in all.
Trackpad
Everything between the corners moves the laptop's pointer. One finger moves and clicks, two scroll and pinch, three and four fingers do whatever you assign them.
Media
The track, the app playing it and where it is, with previous, play/pause and next. Drag the three pieces anywhere on the surface.
Keyboard
A full on-screen keyboard whose modifiers work held or tapped. It opens sideways, and its text size is a setting.
Gamepad
A real virtual Xbox controller on the laptop, with analog sticks and triggers, where the ViGEmBus driver is installed; the same pad falls back to sending keys where it is not. Every control is yours to place, bind, size and label, and layouts are kept one per game.
Shapes
Press and hold on the trackpad until it ticks, then draw without lifting. The stroke is matched against the shapes drawn in Settings, and the one it matches runs a laptop action, a macro, or the pad's own focus or lock.
Macro buttons
Fifteen slots the laptop names with an app, a document, a folder or a URL each, in its tray or menu-bar menu (a text file on Linux); the phone sends the slot number and never what it opens. The screen shows 2 to 10 at a time and the rest sit on pages you slide to. Press and hold a button to drag it into the order you want, or add one from the phone by picking from the laptop's apps.
Controls
One button on the surface opens a grid of the keyboard, the gamepad, macros, annotate and capture. A laptop shows only what it can do, and the grid can be rearranged like the macro deck.
Share clipboard
Text and images copied on the laptop arrive on the phone at once. Android lets Edgepad read the clipboard only while it is on screen, so to send a copy from the phone, go back to Edgepad after copying.
Several laptops
The phone stays connected to every laptop you connect, and you choose which one you control from System settings or the Devices dial. Stay connected keeps the link in a notification while Edgepad is minimized.
Annotate and sign
Controls > Annotate turns the phone into an absolute pen for the laptop screen: a pen, a highlighter, a line, an arrow, a rectangle and an ellipse in eight colours. Sign is the same pad as a signature, saved as a transparent PNG.
Capture
Buttons for a region, the whole screen and a recording press the laptop's own screenshot shortcut, with a trackpad under them to drag out the region.
Security levels and a PIN
Level 2 also asks each phone for a six-digit PIN the first time, level 3 on every connection, on the phone's own keypad. It is set on the laptop, and five wrong answers lock a phone out for 30 seconds, then longer.
Live state
The dials show the laptop's real volume, mute, brightness and playback position, and follow changes made on the laptop itself.
Start here
Download and install
- Download Edgepad-4.2.1.exe (opens in a new tab). It is a single self-contained file; nothing else needs installing, and the laptop does not need .NET.
- Run it. It is not code-signed, so SmartScreen asks first: choose More info, then Run anyway.
- It lives in the system tray. The menu, top to bottom: whether a phone is connected, Update available when there is one, a row for anything that needs your attention (such as Allow through Windows Firewall…), then Wi-Fi and USB connections, Share clipboard, Start with Windows, Macros…, Security…, Documentation, Open log and Quit Edgepad.
Running a newer Edgepad-4.2.1.exe asks the running copy to quit and takes its place, so an update takes over cleanly. Starting the same version twice shows “Edgepad is already running” and the second copy exits.
Pairing and first connection
- For Bluetooth, pair the phone with the laptop once in the laptop's own settings: Windows Settings > Bluetooth & devices, macOS System Settings > Bluetooth, or your Linux desktop's Bluetooth settings. Confirm the code on both sides when the OS shows it. Edgepad adds nothing to that step. Wi-Fi and USB use their own one-time pairing code instead (see below).
- Keep Edgepad running in the laptop's tray, or on a Mac in the menu bar. It must already be running before the phone tries to connect: there is no discovery or retry on the laptop side.
- Open Edgepad on the phone and tap the laptop. The first time, the laptop asks Trust NAME? (NAME is the phone); choose Trust there. Every paired phone is asked about once, and each one you trust is remembered. To forget phones, open Security… in the tray or menu-bar menu: it lists the trusted phones, each with Forget, and has Forget all…. One phone drives the laptop at a time: a trusted phone that connects takes over from the connected one, and the phone it replaced is refused for 30 seconds before it can reconnect with Retry.
- The phone remembers the laptop and reconnects when the app opens. If the link drops after a completed handshake, the phone retries up to ten times, two seconds apart, and says so; a Stop trying button ends it sooner. Disconnecting on purpose does not retry. The phone stays connected to every laptop you connect and you choose which one you control; with Stay connected on, a notification holds the link, and keeps retrying with “Reconnecting to NAME…”, while Edgepad is minimized. Share clipboard and Stay connected are asked about on first run and stay off until you choose.
Wi-Fi and USB connections
Optional, off until you turn them on. The phone's half of Wi-Fi and USB has not been tried on real phones yet, so expect rough edges.
- On the laptop, turn on Wi-Fi and USB connections in the tray menu (on a Mac, Wi-Fi connections; USB is not supported there). On first run the laptop asks Let phones find this laptop?: choose Allow.
- On Windows, allow the firewall prompt, or choose Allow through Windows Firewall… in the menu once. Edgepad listens on port 47321.
- For Wi-Fi, put both on the same network. For USB, connect the cable and turn on USB tethering on the phone. Then open Edgepad on the phone, pick the laptop under Devices, and allow Nearby devices if asked. If the laptop is not listed, use Add by address and type its address (
192.168.1.20, or with a port if it is not 47321). - The phone shows a six-digit pairing code. Type it into the laptop's pairing window (“Type the pairing code shown on the phone:”) before it expires, then tap Yes, paired on the phone if the laptop said the code matched. After that the laptop is remembered.
Start here
Using it
The control surface
| Where | Touch | The laptop does |
|---|---|---|
| A corner ruler | slide | Turns that dial. Clockwise raises. |
| A corner ruler | tap | The dial's action: mute, play/pause, task view, reset zoom. |
| Anywhere else, one finger | move / tap / hold still, then move | Pointer / left click / drag. |
| Two fingers | drag | Scroll, both axes. |
| Two fingers | pinch | Zoom (Ctrl+wheel). |
| Two fingers | tap | Right click. |
| Three or four fingers | tap, swipe up, down, left, right | Whatever Settings assigns. Ten slots in all. |
| Anywhere else, two fingers | hold still until it ticks, then draw | The action or macro bound to the shape drawn. An unrecognised stroke does nothing. |
| Top centre | tap one of the four buttons | Settings, Type text, the lock, Controls (keyboard, gamepad, macros, annotate, capture), left to right. The lock stays on the phone. |
| Back | — | Leaves the surface. The link stays up. |
Default three- and four-finger gestures
Swapped from Windows' own defaults on purpose. Every one of these is changed under Surface settings > Gestures.
| Fingers | Gesture | The laptop does |
|---|---|---|
| Three | left / right | Previous / next virtual desktop |
| Three | up | Task view |
| Three | down | Show the desktop |
| Three | tap | Search |
| Four | left / right | Walk the app switcher. Alt stays held while the fingers are down |
| Four | tap | Notifications |
The corner dials
A dial is a ruler lying along the screen's edge, bending round the corner along the display's own rounding. The finger slides the ruler under a fixed indicator; clockwise raises the value everywhere, like turning a knob. Sliding past a small slop arms it — there is no hold — the ticks lengthen while armed, and one haptic tick fires per notch that passes. A tap without a slide runs the dial's action instead.
Eleven kinds compete for four places: volume, brightness, media scrub, zoom, app switcher, refresh rate, scroll, horizontal scroll, desktops, browser tabs and the Devices dial. A corner may also hold nothing. With Split corners on, in Surface settings > Corners, each corner takes a dial on each of the two edges it joins, eight places in all. The dial a corner already held stays on its side edge, any place can take any dial, and turning it off brings the four single dials back as they were. A dial shows the laptop's real value from STATE frames, and dragging sends absolute SET frames.
Focusing and locking the pad
The third of the four top buttons is the lock. One tap hides the dials and the media and leaves the trackpad. A second tap inside the double-tap window locks the trackpad instead and puts the dials and the media back, so the phone can sit in a pocket or under a palm and answer only its rulers. Any later tap returns the whole surface. A locked pad keeps the lock button drawn in the full ink, because a surface that silently swallows every touch reads as a crash rather than as a mode.
The mode lives in the view: it is neither stored nor offered as a setting, since a phone that came back up silently locked would read as broken.
Shapes
Press one finger on the trackpad, hold it still until it ticks, then draw without lifting. On lift the stroke is matched against the shapes drawn under Surface settings > Shapes, and the one it matches runs: a laptop action, a macro slot, or the pad's own focus or lock. A stroke that matches nothing does nothing, which is the right answer — the alternative is the nearest binding firing on a scrawl.
Shape mode will not arm while dragging, and stops the moment a second finger lands, so scroll, pinch and the three- and four-finger swipes are untouched. A phone with no shapes drawn behaves exactly as it did before there were any.
Macro buttons
Fifteen slots, named from the laptop's tray or menu-bar menu, or on Linux from a text file. Fifteen is what one frame can name — fifteen names at sixteen bytes with fourteen separators is 254 of the 255 bytes a TEXT frame carries — so a full grid always arrives labelled rather than trailing off into blank buttons. A macro saved in the Windows or Mac editor while the phone is connected appears at once.
The screen shows 2 to 10 macros at a time, set with Macros on screen in the macro settings (10 by default). The laptop's other macros, up to its 15, continue on further pages that you reach by sliding a finger sideways; every page has the same grid, and dots under it show which page you are on. Macros live in Controls.
Press and hold a button to lift it, and the others slide out of its way as you drag it to a new place within its own page; let go and it settles. A tap still runs it, there is no separate edit mode, and TalkBack offers Move earlier and Move later on each. The order is kept on the phone, and a button still runs the same macro wherever it is placed. The buttons sit straight on the background with the press and focus feedback kept, and a last row with fewer buttons than the rest sits under the middle of them.
The macro settings can list the laptop's apps to pick from, on Windows, Linux and the Mac, so a macro can be added from the phone.
Share clipboard
Text and images copied on the laptop arrive on the phone at once. Android lets Edgepad read the clipboard only while it is on screen, so to send a copy from the phone, go back to Edgepad after copying and it goes then; tapping Edgepad's notification does the same. Copying on the phone and pasting on the laptop without returning to Edgepad cannot work.
Since Android 10 only the app on screen can read the clipboard, so a copy made in another app reaches the laptop when you switch back to Edgepad. A Share to Edgepad option in the share sheet sends text or an image straight to the active laptop.
A large photo is sent smaller, and a password manager's copy is never sent. Only the laptop you are controlling shares, and the phone and the laptop each have a switch.
Security levels and the PIN
Set from the laptop's tray or menu-bar menu under Security…, never from the phone. Level 1, the default, is the Trust NAME? question and nothing else. Level 2 also asks each phone for a six-digit PIN the first time it connects, and level 3 asks on every connection.
The phone asks on its own keypad, so no keyboard app sees the digits. It never stores the PIN, and the screen cannot be captured. A wrong answer shows the attempts left; after five wrong answers the laptop refuses that phone for 30 seconds, doubling with each further five, up to an hour. The counters are kept in memory, so quitting the laptop app resets them, and changing the PIN or the level makes every phone enter the PIN again.
A forgotten PIN can only be reset on the laptop, with Reset PIN and forget phones…, which removes the PIN, goes back to level 1 and forgets every trusted phone, so each one is asked Trust NAME? again. A six-digit PIN is only a million values, so what stops guessing is the lock-out. It does not protect against someone who can copy the laptop's settings file, and the laptop stores only a salted hash of the PIN.
Controls, annotate, sign and capture
Controls on the surface opens a grid of Keyboard, Gamepad, Capture and Annotate. A laptop shows only what it can do, so a phone shows no Annotate tile when the laptop does not offer it, and no Capture tile when it cannot capture. Back from the keyboard, the gamepad and Capture returns to Controls.
Annotate draws on the laptop's primary display, with the phone as an absolute pen: a touch lands at the same place on the laptop. It has a pen, a highlighter, a line, an arrow, a rectangle and an ellipse in eight colours or any colour you pick, at the width and opacity you set, plus Undo and Clear. The Sign switch turns the same pad into a signature: nothing shows on the laptop, only the pen is offered, and Save signature copies a transparent PNG to the clipboard and saves it as signature-yyyyMMdd-HHmmss.png in an Edgepad folder in Pictures, never over an earlier one. Annotate works on Windows, on the Mac and on Linux; on Linux it is best effort and in testing.
Capture presses the laptop's own screenshot or recording shortcut, and has a trackpad under its buttons to drag out the region. With Save to: Phone, the laptop sends what it just captured to the phone, unverified on real laptops.
| Laptop | Region | Whole screen | Recording |
|---|---|---|---|
| Windows | Win+Shift+S | PrtScn | Win+Shift+R (needs a recent Snipping Tool; unverified) |
| Mac | Cmd+Shift+4 | Cmd+Shift+3 | Cmd+Shift+5 |
| Linux | Ctrl+Shift+Alt+R on GNOME, Meta+Alt+R on KDE (unverified) |
Start here
Settings
Each screen has its own settings behind its own gear, and a feature's settings live only there. Since 4.0.0 the old single settings hub is split that way.
Surface settings
From the surface's gear: Corners and Split corners, Gestures (pointer and scroll speed, natural scrolling, the three- and four-finger map and the on-screen hints), Shapes (draw one, bind it, delete it), Dial feel (slide sensitivity — shared or per dial kind — dial length and height, haptic ticks, snapping to round numbers, with a live preview), Media layout and Background (a control colour, a colour, gradient or image behind the surface, and a grid, dots or checker over it).
Keyboard, gamepad and macros
Each has its own gear and holds everything about its own control: the keyboard's text size, the gamepad's canvas and layout library, how many macros show on a page, whether a macro button shows its icon alone or its icon and label, and adding a macro from the laptop's apps.
System settings
From the Devices screen's gear or the last row of Surface settings, and only what applies everywhere: the laptop, theme, upright or sideways, Stay connected, the guide and updates. The guide opens on the first run and again from here.
The theme is the system's own per-app night mode, set through UiModeManager.setApplicationNightMode, so Edgepad stores no preference of its own for it. Media-piece positions are stored as fractions of the surface's width and height, so a layout made in portrait keeps its shape in landscape.
Orientation is a toggle — upright or sideways — not free rotation. Since 4.0.0 it applies to every screen except the keyboard, the gamepad and the gamepad's editor, which are sideways whatever it says. From 3.0.0 until then it spoke only for the control surface and the two canvases that stand in for it, the media layout editor and the shape canvas; every other screen followed the phone.
Where the laptop keeps things
%APPDATA%\Edgepad\trusted-phone.txt the trusted phones' Bluetooth addresses, one per line
%LOCALAPPDATA%\Edgepad\edgepad.log connections, refusals, dropped frames,
and input batches Windows refused
~/Library/Application Support/Edgepad/trusted-phone.txt the same, on a Mac
~/Library/Logs/Edgepad/edgepad.log the log, on a Mac
~/.config/edgepad/trusted-phone.txt the same, on Linux
~/.local/share/Edgepad/edgepad.log the log, on LinuxThe log is also in the tray menu, under Open log.
Start here
Troubleshooting
| The phone says | What it means, and what to do |
|---|---|
| The laptop hung up before the handshake. | Look at the laptop: answer Trust if it asks about this phone, and update Edgepad there if it is older than the phone's app. If another phone just took over the laptop, try again in 30 seconds. |
| The laptop did not take the connection. | Check that Edgepad is running on the laptop and that its Bluetooth, or its Wi-Fi and USB connections, are on. If a Bluetooth laptop still fails, remove the pairing on both the phone and the laptop, then pair them again. |
| The laptop took the connection and never answered. | Check that Edgepad is running there, then try again. |
| The laptop did not recognise this phone. | Choose Pair again on the phone to pair with a new code. |
| A device answered as this laptop but could not prove it. | Check that the phone is on the right network. |
| Pairing did not finish. | The code was not typed on the laptop in time, or not correctly. Tap the laptop to try again with a new code. |
| The laptop is pairing another phone, or has paused pairing. | It pauses after wrong codes. Try again in a few minutes. |
| Too many wrong PINs. | Wait for the time shown; the lock-out starts at 30 seconds and grows. A forgotten PIN is reset on the laptop, in Security…. |
| That laptop is no longer paired with this phone. | Pair it again in the phone's Bluetooth settings. |
| No laptops found. | Open Edgepad on the laptop, on the same Wi-Fi, or connect by USB and turn on USB tethering. Or turn Bluetooth on and pair it. |
Both halves from one release
If the laptop is older, the phone says “Edgepad on LAPTOP is older than this app. Update Edgepad on the laptop.” If the phone is older it says “This app is older than Edgepad on LAPTOP. Update this app in System settings > Updates.” The laptop's menu names the older half the same way. Both halves must come from the same release.
The gamepad says keyboard mode
The laptop has no virtual controller, so the pad sends keyboard keys instead. On Windows, install ViGEmBus (see Windows above); the gamepad screen says which of three reasons it was. The Mac and Linux apps have no virtual controller.
Input does nothing on a Mac
Choose Allow Edgepad to control this Mac… in the menu-bar menu and enable Edgepad in the pane that opens. After every update macOS treats Edgepad as a new app, so grant it again, then quit and reopen Edgepad.
Remove Edgepad
- Windows: turn off Start with Windows, choose Quit Edgepad, then delete the .exe. Settings stay in
%APPDATA%\Edgepaduntil you delete that folder. - Mac: turn off Start at login, quit Edgepad from the menu bar and delete
Edgepad.app. - Linux:
sudo ./install.sh --uninstall. Settings stay in~/.config/edgepad. - Phone: uninstall Edgepad like any app.
Forget one laptop, or phones
On the phone, Forget on a laptop removes it from the list and deletes its pairing code; Android's own Bluetooth pairing stays, so remove that in Bluetooth settings too. On the laptop, Security… lists the trusted phones, each with Forget, and has Forget all….
Reference
Design decisions
Reference
Known limits
No latency figure has ever been measured
unverifiedThe app carries a live round-trip readout built from PING/PONG, and no number from real hardware has been reported. Nothing in this project writes a latency figure down until one has been.
The feel constants are first guesses
unverifiedPointer gain, scroll units per dp, zoom and switch step sizes in TrackpadRecognizer; base units per dp, units per step and the haptic notch size in Dial; the ruler sizes and hit depths in ControlSurface; the stick dead zone in PadAxis. They are tuned by feel rather than measured, so expect to adjust the sensitivity settings to taste.
No real stroke has been scored against the shape thresholds
unverifiedMIN_SCORE and MIN_MARGIN in Shapes decide how close is close enough and by how much the best match must beat the runner-up before it fires. Both are unmeasured guesses, like every other feel constant here, and they are the two numbers worth tuning if shapes fire too readily or not readily enough.
ViGEmBus is archived and unmaintained
acceptedThe virtual controller is a third-party signed kernel driver its author archived in November 2023; it receives no updates. It remains signed and installs and works today, and nothing about Edgepad can change that. Edgepad neither ships it nor installs it, works without it, and says on the gamepad screen which of the two modes it is in. A Windows release that stopped accepting the driver would take the controller with it and leave keyboard mode.
A ViGEmBus installed mid-session is not noticed until you reconnect
acceptedThe driver is looked for once per connection and the answer kept, because the phone sends PAD_ATTACH whenever the gamepad screen opens and retrying an absent driver would be a probe and a log line per press. The cost is one reconnect after an install you are already watching.
A gamepad layout saved by 2.x is refused, not migrated
acceptedA 2.x layout has no controller bindings in it to migrate, so migrating would be a lie; the first built-in layout — now a real controller — takes its place. Dragged positions are lost, once. The old single-layout key is still read once on update, so an arrangement already in the 3.0 encoding becomes the first entry in the library rather than being dropped with it.
Overlay mode is not built
not builtA mode that draws only the dials over whatever is on screen, kept alive by a foreground service, is planned and does not exist. In overlay mode nothing can be claimed back from Android's own gestures, so corner drags may be stolen by the assistant gesture or the notification shade.
No keyboard-backlight dial
not builtIt was asked for. Windows has no general API for a laptop keyboard backlight: it goes through the maker's own driver and utility. Windows Dynamic Lighting covers only compliant RGB devices, and whether any given laptop's keyboard is one has not been checked. Left open rather than guessed at.
Android's back gesture wins some of the edge
acceptedBack-gesture exclusion is requested for every dial, but Android honours at most 200dp per vertical edge and the bottom cannot be claimed at all. With some layouts parts of a ruler will lose to the back gesture under gesture navigation. Immersive mode may soften it; untested.
Seeking depends on the player
acceptedMedia position is read from Windows' system media transport controls and seeking uses TryChangePlaybackPositionAsync, which is dropped where the player does not allow it. Browsers vary by site.
A background browser tab keeps the browser's name
acceptedOnly the front tab titles the window, so a stream playing in a background tab is reported as the browser. A packaged app is matched by its own id instead.
SendInput cannot reach elevated windows
acceptedAn elevated window, a UAC prompt or the secure desktop silently refuses injected input. That is Windows protecting them. The refusals are counted and logged once per session.
Edgepad.exe is not code-signed
acceptedSmartScreen warns on every download. Acceptable for a small audience; it is the largest drop-off point if traffic is ever driven at it.
The Mac app is ad hoc signed and not notarised
acceptedThe project has no Apple Developer ID, so macOS refuses the app on first launch until you choose Open Anyway, and treats every new version as a different app, so the input-control permission has to be granted again after each update. Check the zip against SHA256SUMS.txt.
The Mac app has not been run on a real Mac
acceptedIt has been compiled and unit-tested in CI. Nothing that touches Bluetooth, input injection, audio or the display has been exercised on hardware, and it has no now playing, level readout or virtual controller yet.
The Linux app has not been seen working on a Linux laptop
unverifiedIt is built and unit-tested in CI. Nothing that touches BlueZ, uinput, the sound server, the tray or the annotation overlay has been seen working on a Linux laptop. The shortcuts behind task view, show desktop, search, notifications and switching desktops are chosen per desktop for GNOME and KDE and were written from memory, a desktop that is neither drops them, and on Wayland annotate is best effort because the compositor may ignore the overlay's always-on-top request. docs/LINUX.md lists every unverified item.
Artifact sizes
acceptedEdgepad.exe is about 58.5 MB as a compressed single file, down from roughly 143 MB uncompressed. Edgepad.apk is about 2.3 MB with R8 off, mostly the Kotlin standard library. Follow-ups, not defects.
Not goals
No account, no server, no telemetry, and no web deployment: Edgepad ships as native apps from GitHub Releases and there is nothing to host. The default Bluetooth link does not reach another room or the internet, and it is not meant to; the optional Wi-Fi link stays on the local network.
Reference
Version history
4.0.0
2026-10-31A Linux app, a shared clipboard, several laptops at once, and a laptop that can ask for a PIN. The wire protocol moves to version 5. The Linux tray app joins Windows and the Mac, on a shared core. The clipboard carries text and images from the laptop to the phone at once; to send one from the phone, go back to Edgepad after copying. The phone stays connected to every laptop you connect and stays connected while minimized. Wi-Fi and USB connections are optional on Windows, Linux and the Mac, paired once with a six-digit code and unverified on real devices. Security levels 1 to 3 add a six-digit PIN asked on the phone's own keypad, with a lock-out after wrong answers. Controls opens the keyboard, the gamepad, macros, Annotate and Capture; Annotate makes the phone an absolute pen for the laptop screen, Sign saves a signature as a transparent PNG, and Capture asks the laptop for its own screenshot or recording tool and can save it to the phone. Split corners gives each corner two dials. The macro deck can be rearranged, has pages, and drops the card behind each button; macros can be added from the phone, and the Mac gets a macro list. Mac and Linux are still in testing.
3.0.0
2026-09-24The gamepad becomes a real controller. The laptop plugs in a virtual Xbox pad through ViGEmBus and copies each PAD_STATE frame onto its report, so sticks and triggers are analog and a game that only reads controllers can be played from the phone; a laptop without the driver falls back to sending keys and says so rather than being quietly dead. Every control on the pad is yours to add, bind, size, label and delete, and layouts are a library kept one per game. Shapes drawn on the trackpad run an action or a macro. A fifth top button focuses the pad or locks it. Settings regroups by the thing each row configures, and Orientation stops speaking for the whole app. The macro grid sizes itself and wraps. The decorative edge rulers are gone. The wire protocol moves to version 4, its first move since 0.6.0.
2.0.0
2026-09-17Macro buttons — the phone can launch things on the laptop, by slot number. A refresh-rate dial. An on-screen readout on the laptop when a level is set from the phone. Pointer and scroll speed become settings. Per-dial-kind sensitivity. Two-finger gestures become fixed rather than assignable. Three security claims corrected. The wire protocol stayed at version 3.
1.0.0
2026-09-16The first stable release. Behaviour unchanged from 0.10.0; what changed is the promise around it. The wire protocol settles at version 3 and from here only moves in a major release, and the repository is arranged for someone other than its author to work in. Several duplicated pieces — both layout editors' canvas, the gamepad's shape rules, the surface's three buttons, Perimeter's four corners, the extended-key table — were reduced to one each.
0.10.0
2026-09-15The phone app is redesigned. A five-page guide, shown one page at a time or all on one scrolling page. JetBrains Mono bundled and used for every piece of text. Settings pages of their own for Corners, Dial feel and Background & pattern. Layout editors that fill the screen so what is laid out has the surface's proportions.
0.6.0
earlierProtocol version 3: TEXT kind 3 carries text to type, which is what the phone's keyboard screen sends.
0.3.0
earlierProtocol version 2: TEXT kind 2 carries the timeline, and a version mismatch is refused with the laptop's own version so the phone can name which side is old. The rulers become slide-along rather than turned round a corner point.
0.1.0
earlierProtocol version 1: HELLO through STATE. The first release.
Reference
Licence and credits
- The phone app's icons are Edgepad's own, drawn for it. The desktop apps' icons are Lucide (opens in a new tab), ISC licence; the few that came from Feather are MIT. The desktop apps draw Lucide's own paths, and the licence text ships inside the exe beside the icons. The APK also carries it as
assets/licenses/Lucide-LICENSE.txt, because the app logo's music note is still Lucide's. - The typeface is Lato (opens in a new tab), by Łukasz Dziedzic, SIL Open Font License 1.1. Both apps bundle it, and its licence ships inside the APK as
assets/licenses/Lato-OFL.txtand inside the exe beside the fonts. This site also sets code in JetBrains Mono (opens in a new tab), under the same licence. - The media players' logos — Spotify, Netflix, YouTube and the rest — are trademarks of their owners. The phone shows one only to say which app is playing on the laptop; that implies no endorsement by, or affiliation with, any of them. The SVG files were supplied by the maintainer and are drawn as supplied.
- The Mac app has no third-party dependencies. The Windows laptop app depends on NAudio (for volume, MIT),
System.Management(for WMI brightness) and Nefarius.ViGEm.Client (opens in a new tab) (the client for the virtual controller, MIT), and nothing else. The phone app depends on AndroidSVG (opens in a new tab) (to draw the mark and the logos, Apache 2.0), and on JUnit for its tests only. - The Linux app depends on Avalonia (opens in a new tab), Avalonia.Desktop and Avalonia.Themes.Fluent (all 12.1.4, for the tray and the windows, MIT) and Tmds.DBus.Protocol (0.94.1, for D-Bus, which BlueZ speaks, MIT). Avalonia in turn brings SkiaSharp (3.119.4) and HarfBuzzSharp (8.3.1.3) with their Linux native libraries, all MIT, which are bundled into the app; those packages' own THIRD-PARTY-NOTICES.txt lists the code compiled into the native libraries (Skia, HarfBuzz, FreeType, libpng, zlib and others) under its own licences. Each licence was read from the package's own nuspec.
- The virtual controller itself is ViGEmBus (opens in a new tab), BSD 3-Clause licence, by Benjamin Höglinger-Stelzer. It is a separate install and is not distributed with Edgepad.