Show HN：掃描QR碼，透過uvx ptn在手機上取得終端機

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

To see all available qualifiers, see our documentation.

Quick n' dirty web terminal tunneling your phone & pc

License

Uh oh!

There was an error while loading. Please reload this page.

lyehe/porterminal

Folders and files

Latest commit

History

Repository files navigation

1. uvx ptn
2. Scan the QR
3. Access your terminal from your phone

Why

I wanted to vibe code from bed.

ngrok requires registration and the free tier sucks. Cloudflare Quick Tunnel works great but is hard to use directly on the phone. Termius requires complicated setup: port forwarding, firewall rules, key management... Tried Claude Code web, but it can't access my local hardware and environment. Also tried Happy, but it's too bulky and updates lag behind.

So I built something simpler: run a command, scan a QR, start typing.

Features

Install

One-line install (uv + ptn):

Requires Python 3.12+ and cloudflared (auto-installed if missing).

Usage

Configuration

Run ptn --init to create a starter config, or create ptn.yaml manually:

Config is searched in order: $PORTERMINAL_CONFIG_PATH, ./ptn.yaml, ./.ptn/ptn.yaml, ~/.ptn/ptn.yaml.

Security

Warning: The URL is the only authentication. Anyone with the link has full terminal access.

Contributing

Issues and PRs welcome.

License

AGPL-3.0

About

Quick n' dirty web terminal tunneling your phone & pc

Resources

License

Contributing

Security policy

Uh oh!

There was an error while loading. Please reload this page.

Stars

Watchers

Forks

Releases

  15

Packages

  0

Contributors

  3

Languages

Footer

Footer navigation