Lychee is a small floating system monitor for macOS. Its always-on-top ball opens an information panel when you hover over it. The app is built with .NET 8 and Avalonia UI.
Attention! This project is currently still in testing. There may some issues with its use. Welcome PR.
- Date and time, refreshed every second
- Network upload and download speeds
- Public IP and approximate location, with alerts for IP changes, failed lookups, and recovery
- CPU usage and memory usage
- Network latency to several public endpoints
- Built-in floating ball designs, plus custom PNG, JPEG, BMP, and animated GIF images
- Resizable information panel
- Panel appearance settings for background opacity, background and text colors, and system font, with preview and reset; the precise color picker offers an HSV spectrum, RGB sliders, and Hex input
- Optional per-module toggles, pinning, and edge snapping
- Menu bar controls for showing the panel, opening settings, and quitting
- Hover over the ball to open the panel; move away to collapse it.
- Drag the ball to move it between screen locations. The panel flips to stay beside the ball.
- Double-click the ball or use the pin button to keep the panel open.
- Drag the expanded panel's outer edge or corner to resize it.
- Open Settings from the panel or menu bar to change modules, alerts, ball design, and panel appearance.
- Quit from the panel or menu bar.
- macOS 11 or later, Apple Silicon or Intel
- .NET SDK 8.0 or later
git clone https://github.com/Qinging-wu/Lychee4MacOS.git
cd Lychee4MacOS
dotnet runThe ball appears near the right edge of the screen. Lychee adds a menu bar icon and hides its Dock icon. There is currently no .app bundle or downloadable installer.
Build:
dotnet build -c ReleasePublish a self-contained executable for Apple Silicon or Intel:
dotnet publish -c Release -r osx-arm64 --self-contained true
dotnet publish -c Release -r osx-x64 --self-contained trueThe published executable can be run from a terminal. These commands do not create a macOS .app bundle.
- Frame Performance (FPS), the bouncing ball, and audio level/spectrum monitoring from the Windows version are not included.
- Memory usage is estimated from macOS memory counters; its figures may differ from Activity Monitor, and swap is not shown separately.
- System notifications use AppleScript. macOS may ask you to allow notifications from Script Editor.
- Some exclusive full-screen apps may cover the floating ball.
- Retina and multi-display positioning still needs broader testing on physical Macs. Please include your display arrangement when reporting positioning issues.
Settings and logs are stored under:
~/Library/Application Support/Lychee/
Settings are saved in settings.json; the rotating application log is in logs/lychee.log.
Special thanks to Icyjerry for PR #1, which improved ball dragging, panel placement, and the menu bar icon.
Bug reports and pull requests are welcome. Please read the contributing guide, Code of Conduct, and security policy.
MIT. See LICENSE.