Skip to content

Releases

PhoneDesk v0.1.3

Choose a tag to compare

@github-actions github-actions released this 18 Nov 20:06

Install

macOS (Apple silicon or Intel), in Terminal, no sudo:

curl -fsSL https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.sh | bash

Windows 10/11 (x64, experimental), in PowerShell:

irm https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.ps1 | iex

The 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 -- --purge after bash to 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

Choose a tag to compare

@github-actions github-actions released this 18 Nov 09:58

Install

macOS (Apple silicon or Intel), in Terminal, no sudo:

curl -fsSL https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.sh | bash

Windows 10/11 (x64, experimental), in PowerShell:

irm https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.ps1 | iex

The 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 -- --purge after bash to 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

Choose a tag to compare

@github-actions github-actions released this 18 Nov 07:47

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 | bash

Windows 10/11 (x64, experimental), in PowerShell:

irm https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.ps1 | iex

The 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 -- --purge after bash to 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

PhoneDesk v0.1.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 06:29

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 | bash

Windows 10/11 (x64, experimental), in PowerShell:

irm https://raw.githubusercontent.com/howznguyen/phonedesk/main/setup.ps1 | iex

The 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 -- --purge after bash to 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