Nexa Coffee icon

Nexa Coffee

v0.1.5

An ultra-lightweight tray timer that shows the remaining time and keeps your PC awake

User Guide Download GitHub

Available on every desktop OS

Install

Windows

Installer — silent install (recommended)

.\nexa-coffee-0.1.5-windows-setup.exe /S

Double-clicking the file downloaded from GitHub Releases opens the installation wizard; adding /S as shown above installs it silently. It installs to %LOCALAPPDATA%\Programs\NexaCoffee without administrator privileges, registers in the Start menu and the installed apps list, and supports 64-bit and 32-bit in one file. To also turn on Start at login, choose it in the wizard or use /S /AUTOSTART=1 (off by default). A running app is closed automatically when upgrading or uninstalling, and settings remain after uninstalling.

Chocolatey portable — one-line install (administrator)

choco install nexa-coffee-portable -y

Run this in an administrator PowerShell. 0.1.4 approved · 0.1.5 was submitted and is in moderation (checked 2026-11-07). On 64-bit Windows, it runs with the nexa-coffee-x64 command. Upgrade: choco upgrade nexa-coffee-portable -y · Uninstall: choco uninstall nexa-coffee-portable -y — a running app is closed automatically before upgrading or uninstalling.

Chocolatey — currently 0.1.3 (administrator)

choco install nexa-coffee -y

⚠️ The latest approved version is currently 0.1.3, which is the portable type. The first installer-type version (0.1.5) was submitted and is in moderation (checked 2026-11-07) — once approved, upgrading changes the install type. To stay portable, use nexa-coffee-portable above.

winget — installer (listing under review)

winget install SosomLab.NexaCoffee

⏳ It does not appear in search results yet because the first PR #436346 is waiting on author action (a manifest format update) (checked 2026-11-07). Until then, use the installer or Chocolatey.

winget — portable (listing under review)

winget install SosomLab.NexaCoffee.Portable

⏳ Under review as a new package (0.1.4 PR #454127 · 0.1.5 PR #474187 · checked 2026-11-07). Once listed, it runs with the nexa-coffee command.

  1. To use the portable build directly, download nexa-coffee-<version>-windows-x64-portable.zip from GitHub Releases (-windows-x86-portable.zip for 32-bit) and extract it to a folder of your choice. Starting with v0.1.4, the file name includes -portable.
  2. Run nexa-coffee-x64.exe and an icon appears in the tray. If a SmartScreen warning appears, click More info → Run anyway.
  3. To launch automatically at login, check Start at login in the tray menu. If you moved the portable exe, turn it off and on again.
  4. Windows 11 puts new icons in the hidden overflow area (^). Turn it on under Settings → Personalization → Taskbar → Other system tray icons.

System requirements: Windows 10 or later (x64·x86). Remove the installer version through the Settings app or the uninstaller. To remove the portable build, turn off Start at login, quit the app, and delete the files (settings are in %APPDATA%\nexa-coffee). There is no code signing. Channel status (checked 2026-11-07): ✅ Chocolatey nexa-coffee-portable 0.1.4 (0.1.5 in moderation), ⚠️ Chocolatey nexa-coffee 0.1.3 (portable type · installer-type 0.1.5 in moderation), ⏳ both winget packages not yet listed. Homebrew · APT · DNF have the latest 0.1.5. For detailed instructions, see the User Guide.

macOS

Homebrew — one-line install (recommended)

brew install --cask kiros33/tap/nexa-coffee

Because the app is unsigned, the Cask removes the quarantine flag (com.apple.quarantine) right after installation, so it launches right away. Upgrade: brew upgrade --cask nexa-coffee · Uninstall: brew uninstall --zap --cask nexa-coffee (including settings).

  1. Alternatively, download nexa-coffee-<version>-macos-universal.zip from GitHub Releases and extract it.
  2. In Terminal, run xattr -dr com.apple.quarantine "Nexa Coffee.app", then move the app to the Applications folder and launch it.
  3. To launch automatically at login, check Start at login in the menu bar menu. macOS 13 or later shows a "Background item added" notification, which is normal.

macOS 11 Big Sur or later · universal for Intel and Apple Silicon. It appears only in the menu bar, with no Dock icon. Closing the lid makes macOS force sleep, so Nexa Coffee cannot prevent it.

Linux

Register the APT repository — Debian · Ubuntu (first time only)

sudo curl -fsSLo /usr/share/keyrings/sosomlab-archive-keyring.gpg https://pkg.sosomlab.com/sosomlab-archive-keyring.gpg
sudo curl -fsSLo /etc/apt/sources.list.d/sosomlab.sources https://pkg.sosomlab.com/apt/sosomlab.sources

Registers the SosomLab signed package repository (pkg.sosomlab.com). Skip this if you already registered it for another SosomLab app.

Install with APT

sudo apt update && sudo apt install nexa-coffee

After this, sudo apt upgrade keeps it updated. Uninstall: sudo apt remove nexa-coffee.

Register the DNF repository — Fedora · RHEL family (first time only)

sudo curl -fsSLo /etc/yum.repos.d/sosomlab.repo https://pkg.sosomlab.com/rpm/sosomlab.repo

Skip this if you already registered it for another SosomLab app.

Install with DNF

sudo dnf install nexa-coffee

When the first installation asks whether to import the signing key, check that the fingerprint matches the one on pkg.sosomlab.com before accepting.

Homebrew (Linux)

brew install kiros33/tap/nexa-coffee-portable

tar.gz — install for your account only

./install.sh --autostart

Extract nexa-coffee-<version>-linux-x64.tar.gz from Releases and run this. It installs under ~/.local, and adding --autostart launches the app automatically at login. Uninstall: ./uninstall.sh (keeps the settings in ~/.config/nexa-coffee).

A static executable for x86_64 only. A tray host is required — KDE Plasma has one by default, and on GNOME the AppIndicator extension must be enabled for the icon to appear. The "Custom…" input window requires one of yad, zenity, or kdialog. On Linux, it keeps the PC from sleeping even when you close the lid. To launch automatically at login, use Start at login in the tray menu. apt remove and dnf remove cannot delete ~/.config/autostart/nexa-coffee.desktop, so turn it off in the menu before removing the app (it is harmless if left behind).

Pick a duration from the menu, and for that time it prevents the screen saver, display turn-off, and sleep, while the tray icon shows the remaining time as a number and a ring. The Windows executable is about 32KB, and it works the same way on Windows, macOS, and Linux with no external libraries.

Key Features

About

Nexa Coffee is a tray (menu bar) timer that keeps your PC awake for a set period. Choose Unlimited, 12 hours, 6 hours, 2 hours, 1 hour, or 30 minutes, or enter days, hours, and minutes yourself. For that time it prevents the screen saver, display turn-off, sleep, and hibernation, and when the time is up it releases this on its own and returns to idle. It is a tool for keeping the PC awake for a while during long downloads, builds, or presentations, without changing your power settings.

The tray icon is the timer. A thick arc shrinks in proportion to the remaining time, and the number in the center changes color by unit — purple for days, green for hours, orange for minutes, red for seconds, and a blue infinity symbol for Unlimited. The top line of the menu shows the exact remaining time in the format 0 days 12 hours 50 minutes 3 seconds, updated every second.

It follows an ultra-lightweight principle. Written in pure C (with a single Objective-C file on macOS only), it uses no frameworks or external libraries. On Windows it does not even link the C runtime, so the executable is about 32KB; on Linux it is a single static executable that implements D-Bus directly without libdbus, so it works regardless of the distribution. The icon is drawn by its own integer-only rasterizer, producing the same pixels on all three OSes.

The input window and About window are launched as separate processes only when needed, so their memory goes away when you close them. Checking "Start at login" in the menu launches the app automatically when you log in, and combined with the Auto-start on launch option, it can keep the PC awake for a saved duration every time you log in. The menu supports four languages: English, Korean, Japanese, and Chinese. Choosing "System" in the Language menu follows the OS display language.

On Windows, you can choose between an installer that needs no administrator privileges and a portable zip, and you can also install with Chocolatey. On macOS, Homebrew takes a single command, and on Linux, so do the SosomLab APT and DNF repositories and Homebrew; you can also download tar.gz, deb, or rpm files directly from GitHub Releases. The winget listing is under review. Closing the lid can be blocked only on Linux; on Windows and macOS, the OS power policy takes precedence. There is no code signing yet. It is MIT licensed and free for anyone to use.

Release Notes

v0.1.5 2026-11-07 Fix for a locked Mac waking its screen all night · safer handling of external input (10 fixes).

Fixed

  • macOS: a locked Mac turned its screen on and off all night — If you locked the Mac while a timer was running, the darkened screen came back on every 30 seconds, and each time another lock screen window piled up, so by morning WindowServer was using a lot of CPU and the mouse was sluggish. The screen is no longer woken while it is locked, off, or switched to another user.
  • Sleep prevention itself is unchanged — the system still does not sleep while locked, and screen saver blocking resumes when you unlock. If many windows have already piled up, log out and back in or restart after updating to clear them. Windows and Linux did not have this problem.

Security

  • 10 fixes in code that reads external input — settings files, input dialog results, the command line, and Linux D-Bus messages. On Linux, a malformed D-Bus message from another program in the same session could hang the app or make it read outside memory; length, string termination, and nesting depth are now all checked, and bad messages are dropped. On every OS, truncated settings files or very long numbers are handled safely. No path is reachable over the network; only input with the same user's privileges is affected.

Distribution

  • 0.1.5 available on Homebrew · APT · DNF (checked 2026-11-07). Chocolatey nexa-coffee (first installer-type release) and nexa-coffee-portable 0.1.5 were submitted and are in moderation; the approved versions are currently 0.1.3 (portable type) and 0.1.4. For winget, the portable 0.1.5 PR #474187 was just opened, and the installer's first PR #436346 is waiting on author action.
v0.1.4 2026-10-17 Windows distribution split into installer and portable. The app itself is the same as v0.1.3.

Changed

  • Portable zip renamed — nexa-coffee-<version>-windows-x64-portable.zip · -windows-x86-portable.zip. The executable names inside are unchanged.
  • Packages split — The installer is handled by winget SosomLab.NexaCoffee · Chocolatey nexa-coffee, and portable by the new packages winget SosomLab.NexaCoffee.Portable · Chocolatey nexa-coffee-portable.
  • ⚠️ If you used Chocolatey nexa-coffee — Through 0.1.3 this package is portable. Upgrading once an installer-type version is published changes the install type, so if you want to stay portable, run choco uninstall nexa-coffee and then choco install nexa-coffee-portable.

Distribution

  • Chocolatey nexa-coffee-portable 0.1.4 approved (2026-10-20) · 0.1.4 available on Homebrew, APT, and DNF. Chocolatey nexa-coffee is approved through 0.1.3, the installer-type 0.1.4 has not been published yet, and both winget packages are under listing review.
v0.1.3 2026-10-17 "Start at login" tray menu item (3 OSes) · Windows installer · "System" in the Language menu.

Added

  • "Start at login" tray menu item (Windows · macOS · Linux) — When checked, the app launches automatically at login. The state is read directly from the OS setting, so an entry turned on by the installer or install.sh --autostart also shows as checked. Windows uses the registry Run value, macOS a user LaunchAgent, and Linux ~/.config/autostart.
  • Windows installer nexa-coffee-<version>-windows-setup.exe — Installs to %LOCALAPPDATA%\Programs\NexaCoffee without administrator privileges and supports 64-bit and 32-bit in one file. You can choose Start at login in the wizard (off by default). Silent install is /S, and to turn it on as well, /S /AUTOSTART=1. A running app is closed automatically when upgrading or uninstalling, and settings remain after uninstalling.
  • Language ▸ "System (English)" — The OS display language appears at the top of the Language menu, and choosing it clears the saved language and follows the OS language. Previously, once you chose a language, there was no way back to the OS language.

Improved

  • OS language changes apply right away — On Windows and macOS, changing the OS language takes effect immediately in the "System" state. On Linux, you need to relaunch the app.

Notes

  • On Linux, apt remove and dnf remove cannot delete ~/.config/autostart/nexa-coffee.desktop — turn it off in the menu before removing the app, or delete the file yourself (it is harmless if left behind).
  • macOS 13 or later shows a "Background item added" notification when you turn on Start at login (this is normal).
v0.1.2 2026-09-26 Fixed a Linux crash when the tray host restarted · launch at login on Linux · handling of display scale changes on Windows.

Fixed

  • Linux: crash when the tray host started later than the app — Occurred when auto-launching right after login, restarting GNOME Shell, or enabling the AppIndicator extension later. The app now registers its icon again when the host appears or restarts.
  • Linux: app not appearing in the app list after installation — install.sh now writes the executable path as an absolute path and refreshes the existing icon cache if there is one.
  • Windows: tray icon stayed at the old size when the display scale was changed while idle — The icon is now redrawn at the current scale when the scale or display changes.

Improved

  • Linux: sharper numbers in the GNOME panel — A 16px icon is now sent as well, so it is not blurred by downscaling.
  • Linux: launch at login — Register with ./install.sh --autostart; ./uninstall.sh removes it as well.

Distribution

  • Linux .deb and .rpm added, plus APT and DNF repository (pkg.sosomlab.com) registration (2026-10-09) — sudo apt install nexa-coffee / sudo dnf install nexa-coffee. The program itself is still v0.1.2.
  • Chocolatey nexa-coffee 0.1.2 approved. The winget listing is under review.
v0.1.1 2026-09-17 Version information added to the Windows executable — mitigates antivirus false positives.

Improved

  • Version information (file properties) added to the Windows executable — Mitigates the issue where the 32-bit zip of v0.1.0 was falsely flagged (Trojan:Win32/Tecabans.STV!cl) by Microsoft Defender's cloud scan. No functional changes.
v0.1.0 2026-09-13 First public release — a sleep prevention tray timer for 3 OSes that shows the remaining time.

Added

  • Sleep prevention timer — Unlimited · 12 hours · 6 hours · 2 hours · 1 hour · 30 minutes · Custom (days, hours, minutes). While running, it prevents the screen saver, display turn-off, sleep, and hibernation, and releases automatically when the time is up.
  • Remaining-time icon — An arc proportional to the remaining time and a number colored by unit (days purple · hours green · minutes orange · seconds red · Unlimited blue ∞). Drawn pixel-identically on all three OSes.
  • Remaining time on the top line of the menu, updated every second · Auto-start on launch · Language selection (English, Korean, Japanese, Chinese) · About window · duplicate-instance prevention.
  • Installation channels — GitHub Releases (Windows x64 and x86 zip, macOS universal zip, Linux x64 tar.gz), Homebrew, Chocolatey.