Repository navigation
Releases
PhoneDesk v0.1.3
Install
macOS (Apple silicon or Intel), in Terminal, no sudo:
curl -fsSL https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.sh | bashWindows 10/11 (x64, experimental), in PowerShell:
irm https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.ps1 | iexThe installer downloads the right file below, checks it against SHA256SUMS, installs it for your user, starts
PhoneDesk and prints the phone URL, a pairing PIN and a QR code. Open the URL on a phone on the same Wi-Fi (or scan
the QR with the Camera app), and add the page to the home screen.
- Update: run the same command again. Your layout, paired phones and settings are kept.
- Uninstall:
curl -fsSL https://raw.githubusercontent.com/howznguyen/phonedesk/main/uninstall.sh | bash
(Windows:irm https://raw.githubusercontent.com/howznguyen/phonedesk/main/uninstall.ps1 | iex). Your data is kept;
on macOS add-s -- --purgeafterbashto delete it too. - Manage your panel:
http://localhost:7420/manage/on the computer.
Files
| File | For |
|---|---|
phonedesk-darwin-arm64.gz / phonedesk-darwin-arm64 |
macOS on Apple silicon (M1 and later) |
phonedesk-darwin-x64.gz / phonedesk-darwin-x64 |
macOS on Intel |
phonedesk-windows-x64.exe.gz / phonedesk-windows-x64.exe |
Windows 10/11 x64 |
SHA256SUMS |
Checksums of every file |
The .gz files are the same programs compressed (about a third of the size); the installers use them. To install by
hand: download the file for your machine, check it with shasum -a 256 -c SHA256SUMS --ignore-missing, unpack it with
gunzip, make it executable (chmod +x) and run it. The macOS binaries are signed ad hoc, not notarized: a file
downloaded in a browser needs xattr -d com.apple.quarantine <file> first.
Full guide: README · Tiếng Việt: README.vi
Full Changelog: v0.1.2...v0.1.3
PhoneDesk v0.1.2
Install
macOS (Apple silicon or Intel), in Terminal, no sudo:
curl -fsSL https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.sh | bashWindows 10/11 (x64, experimental), in PowerShell:
irm https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.ps1 | iexThe installer downloads the right file below, checks it against SHA256SUMS, installs it for your user, starts
PhoneDesk and prints the phone URL, a pairing PIN and a QR code. Open the URL on a phone on the same Wi-Fi (or scan
the QR with the Camera app), and add the page to the home screen.
- Update: run the same command again. Your layout, paired phones and settings are kept.
- Uninstall:
curl -fsSL https://raw.githubusercontent.com/howznguyen/phonedesk/main/uninstall.sh | bash
(Windows:irm https://raw.githubusercontent.com/howznguyen/phonedesk/main/uninstall.ps1 | iex). Your data is kept;
on macOS add-s -- --purgeafterbashto delete it too. - Manage your panel:
http://localhost:7420/manage/on the computer.
Files
| File | For |
|---|---|
phonedesk-darwin-arm64.gz / phonedesk-darwin-arm64 |
macOS on Apple silicon (M1 and later) |
phonedesk-darwin-x64.gz / phonedesk-darwin-x64 |
macOS on Intel |
phonedesk-windows-x64.exe.gz / phonedesk-windows-x64.exe |
Windows 10/11 x64 |
SHA256SUMS |
Checksums of every file |
The .gz files are the same programs compressed (about a third of the size); the installers use them. To install by
hand: download the file for your machine, check it with shasum -a 256 -c SHA256SUMS --ignore-missing, unpack it with
gunzip, make it executable (chmod +x) and run it. The macOS binaries are signed ad hoc, not notarized: a file
downloaded in a browser needs xattr -d com.apple.quarantine <file> first.
Full guide: README · Tiếng Việt: README.vi
Full Changelog: v0.1.1...v0.1.2
PhoneDesk v0.1.1
What's new in 0.1.1
- OpenCode: sessions from its local database, usage limits on OpenCode 2.x with Go, and an opt-in plugin to answer permission prompts and questions from the phone.
- Grok (Grok Build): sessions, and an opt-in hook that shows on the phone when Grok is waiting for you. Grok does not let hooks approve, so the phone notifies only. PhoneDesk's Claude Code hooks now ignore Grok's calls.
- Faster, clearer installs: the installers show the download size and a progress bar, resume a stalled download, and fetch compressed files (about 3 times smaller).
- Swiping: page swipes go the right way on Chrome for Android and when the screen is rotated; lists scroll along the panel's own axis.
Known issue (Windows): tiles that type text can produce wrong characters. Opening apps, shortcuts, media and volume work.
Install
macOS (Apple silicon or Intel), in Terminal, no sudo:
curl -fsSL https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.sh | bashWindows 10/11 (x64, experimental), in PowerShell:
irm https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.ps1 | iexThe installer downloads the right file below, checks it against SHA256SUMS, installs it for your user, starts
PhoneDesk and prints the phone URL, a pairing PIN and a QR code. Open the URL on a phone on the same Wi-Fi (or scan
the QR with the Camera app), and add the page to the home screen.
- Update: run the same command again. Your layout, paired phones and settings are kept.
- Uninstall:
curl -fsSL https://raw.githubusercontent.com/howznguyen/phonedesk/main/uninstall.sh | bash
(Windows:irm https://raw.githubusercontent.com/howznguyen/phonedesk/main/uninstall.ps1 | iex). Your data is kept;
on macOS add-s -- --purgeafterbashto delete it too. - Manage your panel:
http://localhost:7420/manage/on the computer.
Files
| File | For |
|---|---|
phonedesk-darwin-arm64.gz / phonedesk-darwin-arm64 |
macOS on Apple silicon (M1 and later) |
phonedesk-darwin-x64.gz / phonedesk-darwin-x64 |
macOS on Intel |
phonedesk-windows-x64.exe.gz / phonedesk-windows-x64.exe |
Windows 10/11 x64 |
SHA256SUMS |
Checksums of every file |
The .gz files are the same programs compressed (about a third of the size); the installers use them. To install by
hand: download the file for your machine, check it with shasum -a 256 -c SHA256SUMS --ignore-missing, unpack it with
gunzip, make it executable (chmod +x) and run it. The macOS binaries are signed ad hoc, not notarized: a file
downloaded in a browser needs xattr -d com.apple.quarantine <file> first.
PhoneDesk v0.1.0
PhoneDesk 0.1.0
First public release. Please install v0.1.1 or later: it downloads faster and shows a progress bar.
Install
macOS (Apple silicon or Intel), in Terminal, no sudo:
curl -fsSL https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.sh | bashWindows 10/11 (x64, experimental), in PowerShell:
irm https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.ps1 | iexThe installer downloads the right file below, checks it against SHA256SUMS, installs it for your user, starts
PhoneDesk and prints the phone URL, a pairing PIN and a QR code. Open the URL on a phone on the same Wi-Fi (or scan
the QR with the Camera app), and add the page to the home screen.
- Update: run the same command again. Your layout, paired phones and settings are kept.
- Uninstall:
curl -fsSL https://raw.githubusercontent.com/howznguyen/phonedesk/main/uninstall.sh | bash
(Windows:irm https://raw.githubusercontent.com/howznguyen/phonedesk/main/uninstall.ps1 | iex). Your data is kept;
on macOS add-s -- --purgeafterbashto delete it too. - Manage your panel:
http://localhost:7420/manage/on the computer.
Files
| File | For |
|---|---|
phonedesk-darwin-arm64.gz / phonedesk-darwin-arm64 |
macOS on Apple silicon (M1 and later) |
phonedesk-darwin-x64.gz / phonedesk-darwin-x64 |
macOS on Intel |
phonedesk-windows-x64.exe.gz / phonedesk-windows-x64.exe |
Windows 10/11 x64 |
SHA256SUMS |
Checksums of every file |
The .gz files are the same programs compressed (about a third of the size); the installers use them. To install by
hand: download the file for your machine, check it with shasum -a 256 -c SHA256SUMS --ignore-missing, unpack it with
gunzip, make it executable (chmod +x) and run it. The macOS binaries are signed ad hoc, not notarized: a file
downloaded in a browser needs xattr -d com.apple.quarantine <file> first.