ftop

A small, quiet system monitor for Apple Silicon Macs.
One floating glass panel that works at any size.

中文说明 · Download · Install

ftop replaces the terminal monitor you keep open in a spare tab with a native window you can leave anywhere on the desktop. It is for the moments when the machine is working hard — a local model running, an agent compiling, a long build — and you want to see at a glance what the cores, memory, and network are doing, and which app is responsible.

It shows the current state only: no history graphs, no disk panels.

Drag any edge. ftop picks the layout that fits and the window settles onto it, so nothing is ever clipped and no space is left empty. A small window keeps the essentials; a large one shows more, not bigger type.

Every figure is led by the same small round badge, and a badge with an arc is a gauge. The color says what it belongs to; there is almost no text to read.

A reading the hardware does not give is shown as unavailable, never as zero.

• Columns follow the readings. Each core eases to its new value and arrives as the next reading comes in, so the panel moves continuously instead of jumping once a second.
• A list that rests. A process takes its place the moment it becomes busy and leaves it slowly; two apps trading the lead by a point do not swap. A row that passes its neighbor slides; one that goes further turns over where it stands, so rows never fly across the list.
• Press a process. The row gives under the pointer and a card comes up beside it: CPU, memory, and the helper processes inside the app. In a large window two badges switch the ranking between CPU and memory.
• Nearly free when you are not looking. Hidden or fully covered, ftop stops reading everything except the one reading in the menu bar.

With Reduce Motion on in macOS, all of this becomes plain fades.

Right-click the panel or the menu bar number. One block holds everything: what to show, how the panel behaves, the colors, and under More the few settings that have a value.

The same settings are a plain text file, ~/.config/ftop/config.json5 (JSON with comments). The two stay in step, and a saved change applies at once.

Measured with scripts/perf.sh on a 14-core Apple Silicon Mac, updating once a second:

With system processes granted (below), the helper that lists them adds about 0.5%.

Requirements: an Apple Silicon Mac with macOS 15 or later.

From a release. Download Ftop-<version>-arm64.zip from the releases page, unpack it, and move Ftop.app to ~/Applications. Then link the command into a directory on your PATH:

mkdir -p ~/.local/bin && ln -sfn ~/Applications/Ftop.app/Contents/MacOS/ftop ~/.local/bin/ftop

The app is signed for local use only and is not notarized by Apple, so macOS blocks a copy downloaded with a browser. Clear the download mark once:

xattr -dr com.apple.quarantine ~/Applications/Ftop.app

From source. Needs Xcode (built and tested with Xcode 27).

git clone https://github.com/Nongfsq/ftop.git

cd ftop && scripts/bundle.sh && scripts/install.sh

This puts Ftop.app in ~/Applications and links ftop into ~/.local/bin.

On 0.1.0? That version cannot update itself. Install the latest release by hand once, as above; from 0.1.1 on ftop keeps itself up to date.

ftop            # open the panel
ftop toggle     # hide or show it
ftop quit       # close it
ftop doctor     # which readings are available on this Mac, and why not

• Drag the panel to move it; drag an edge to resize it.
• Move the pointer to the top edge for two buttons: pin (keep on top) and hide.
• The menu bar shows one reading, a glyph and its number: CPU by default, or memory, GPU, download, upload, or power (under More in the settings). Click it to show or hide the panel.
• Hover over a core, the memory bar, or the GPU for detail; click a process for its card.
• Right-click for the settings.

ftop looks for a newer release once a day and installs it: it downloads the release from this repository, checks it, replaces Ftop.app, and restarts the panel. Under More → Updates you can switch this to Tell me (the update is then offered there) or Never check (ftop never goes online). ftop update looks right now and ftop version prints what is installed.

An update never changes the helper that sudo ftop grant installed. If a new version needs a newer helper, ftop doctor says so and you grant again.

Without extra rights macOS only lets ftop see your own processes. To include system ones such as WindowServer, grant access once:

sudo ftop grant

This marks one small helper inside the app as setuid root. The helper takes no arguments, reads no environment, writes no files, and only prints the process table; its source is Sources/ftop-helper/main.swift.

• Apple Silicon only. Core grouping and per-core frequency rely on it.
• Per-core frequency and temperature come from private macOS interfaces (IOReport and the HID sensor services). They can change with a macOS update; a reading that is not available is shown as unavailable, never as zero. For the same reason ftop cannot be distributed through the Mac App Store.
• The interface is in English and Chinese.

scripts/check.sh is the gate: formatting, a warning-free build, and the tests. The pictures on this page are produced by ftop's own drawing code with sample readings (scripts/readme-media.sh) and set on a stand-in wallpaper; the real window uses the macOS glass material, so its background follows whatever is behind it. Product decisions are in docs/product/, the architecture in docs/architecture/, and the rules for coding agents in AGENTS.md.

ftop began as a fork of btop and was then rewritten from scratch; it shares no code with it.

Report a problem or make a suggestion through the forms on the issues page; a report needs the output of ftop doctor. Pull requests from outside the project are not accepted. The rules are in CONTRIBUTING.md.

ftop is free and open source. If it earns a place on your desktop, you can buy me a coffee.

MIT