Closed beta · Feedback welcome

The warmth of PTT, reborn on the modern desktop

uPtt turns PTT mail into real conversations: waterballs, presence and quoted replies, all in one window. It talks to ptt.cc directly. No relay server, and your data stays on your computer.

Download free
  • macOS · Windows · Python 3.12+
  • GPL-3.0 open source
  • Code-signed via SignPath
Scroll
01 How it works

How uPtt turns PTT mail into a conversation

In a PTT mailbox, every message looks the same

Each one is a single line titled 你收到使用 uPtt 傳送的訊息, “you received a message sent with uPtt”. To read one you open it; to answer you write a whole new letter.

uPtt reads every one for you, in the background

Every 5 seconds it polls the mailbox, recognises uPtt’s format, restores the embedded [uPtt-ts] timestamp, then deletes the delivered message from PTT so the mailbox stays clean.

And they become a real conversation

Grouped by sender, ordered by time, with unread counts by each contact. Regular PTT mail is never deleted; it stays in PTT untouched.

02 Messages

Three kinds of message, one interface

Messages reach you on PTT in different ways. uPtt recognises each kind, shows it the way that suits it, and handles it as safely as it can.

In the PTT mailboxraw
作者 catmayor
標題 你收到使用 uPtt 傳送的訊息
時間 Sun Oct  4 21:00:12 2026
────────────────────────────────────────
[re:@you|I got uPtt, my PTT mail is a chat now]
No way, what does it look like?
====================
[uPtt-ts:2026-10-04T21:00:09+08:00]
parsed · saved to SQLite · removed from PTT
@you I got uPtt, my PTT mail is a chat nowNo way, what does it look like?
03 Features

Easy as any messenger,
PTT at heart

No more memorising telnet keystrokes. Every tile below is live, so go ahead and try it.

Contacts

Pin, drag, block. Sorted your way

Keep the people who matter at the top. Pinned and regular chats sort independently; right-click to close, delete local history, or block.

  • diner_kai Midnight Diner◆ pinned
  • catmayor Cat Mayor◆ pinned
  • bcboss Banqiao Boss

↕ Drag to reorder (keyboard: focus, then ↑ ↓)

Presence

See who’s online at a glance

A dedicated query session keeps it fresh. When it can’t tell, it shows a grey “unknown” instead of guessing.

catmayoronline
bcbossoffline
csnerd87unknown
⌘K Search

Search messages and contacts

Hit ⌘K / Ctrl+K anywhere and jump straight to the conversation.

ramen
  • Ramen this weekend?diner_kai
  • Queued an hour for that ramencatmayor
Notifications

Close the window, miss nothing

uPtt keeps receiving from the system tray, and new messages pop up as desktop notifications when it’s in the background.

catmayorCool, installing it now
diner_kaiRamen this weekend?
★MoonCake waterballAre you watching the game too?
Multi-account

Several PTT accounts, fully separate

Chats, settings and contacts are isolated per account at the database level, so switching never mixes them up.

WwonderslabNnight_owl
WHERE account_id = 'wonderslab'
Themes

Graphite, Bone, Kraft

Same palettes as the app. Click one and this site switches too.

Quoted replies

Always clear what you’re replying to

Right-click any message to quote it, with a preview above the input. It still reads fine for someone opening the mail in plain PTT.

Queued an hour for that ramen
@catmayor Queued an hour for that ramenWorth it?
04 Architecture

Two sessions,
never waiting

With one PTT account, uPtt keeps two sessions open: one for sending and receiving, one for presence lookups. However slow a lookup gets, your messages never wait on it.

  • Main session Logs in, polls mail and waterballs every 5 seconds, sends messages.
  • Query session Starts 10 seconds after the main login and takes the user lookups that can block for seconds. It never kicks the main session when it reconnects.
  • Shared reconnect throttle If both drop at once, they reconnect in turn at least 5 seconds apart, avoiding PTT’s “logging in too often”.
Architecture: the uPtt UI talks to ptt.cc through a PTTWorker main session and a QueryWorker query session. KICK_OTHER_SESSION = TRUE KICK_ON_RECONNECT = FALSE QT SIGNAL / SLOT uPtt UIQt main thread PTTWorkermain · messages QueryWorkerquery · presence ptt.ccPTT BBStelnet / ws throttle 5s
05 Security & privacy

Your conversations live only on your computer. No relay server. No sign-up. No tracking.

  • 01

    Local SQLite

    History and settings live in a database on your machine, with accounts fully isolated by account_id.

  • 02

    Two connections, that’s all

    Straight to PTT’s own server, ptt.cc, plus the GitHub API to check for new versions.

  • 03

    Code signing

    Releases are signed by SignPath.io and verified by the SignPath Foundation, so you know the download hasn’t been tampered with.

  • 04

    Leak-proof CI

    TruffleHog secret scanning, Bandit static analysis, pip-audit, and canary tests that catch any password leak.

While using uPtt, don’t delete mailbox contents by hand from another PTT client.

uPtt syncs by mail order, so manual deletions can cause sync errors or the wrong mail being removed. uPtt only ever deletes messages in its own format; if you’re still worried, turn on mailbox backup to external email in PTT’s settings.

06 Shortcuts

Hands stay on the keyboard

⌘KSearch messages & contacts
⌘NNew chat
⌘IProfile
⌘,Settings
⌘WClose current chat
⇧↵New line (↵ sends)

// Press K, N, I, W or comma on this page to try them.

07 Download

Start chatting

Free and open source. Download it and sign in with your PTT account.

macOS

.app · zip archive

Windows

Installer · zip archive

Every version and changelog lives on GitHub Releases. Preview builds: pip install --pre uPtt

08 Developers

Help make it
better

uPtt is built with Python 3.12 and PySide6 (Qt 6), and talks to PTT through PyPtt. Bug reports, ideas and pull requests are all welcome.

~/uPtt-app — zsh
# get the source
❯ git clone https://github.com/uPtt-messenger/uPtt-app.git
❯ cd uPtt-app

# install and run (--debug turns on logging)
❯ pip install -r requirements.txt
❯ python src/run_app.py --debug

# run the tests
❯ pip install -r requirements-dev.txt
❯ pytest
✓ passed