← Apps

Nexa Coffee 아이콘

Nexa Coffee

v0.1.2

남은 시간을 보여 주며 PC가 잠들지 않게 하는 초경량 트레이 타이머

사용 설명서 다운로드 GitHub

모든 데스크톱 OS에서 사용할 수 있어요

설치

Windows

Chocolatey — 한 줄 설치 (관리자 권한)

choco install nexa-coffee -y

관리자 권한 PowerShell에서 실행하세요. 64비트 Windows에서는 nexa-coffee-x64 명령으로 실행됩니다. 업그레이드: choco upgrade nexa-coffee -y · 제거: choco uninstall nexa-coffee -y — 업그레이드·제거 전에 실행 중인 앱을 자동으로 종료합니다.

winget (등록 심사 중)

winget install SosomLab.NexaCoffee

⏳ winget-pkgs 등록 심사가 끝나기 전까지는 검색되지 않습니다. 그동안은 Chocolatey나 zip을 쓰세요.

  1. 또는 GitHub Releases에서 nexa-coffee-<버전>-windows-x64.zip(32비트는 -windows-x86.zip)을 내려받아 원하는 폴더에 풉니다.
  2. nexa-coffee-x64.exe를 실행하면 트레이에 아이콘이 나타납니다. SmartScreen 경고가 뜨면 추가 정보 → 실행을 누르세요.
  3. 로그인 시 자동 실행: Win+R → shell:startup 폴더에 exe 바로가기를 넣습니다.
  4. Windows 11은 새 아이콘을 숨김 영역(^)에 넣습니다. 설정 → 개인 설정 → 작업 표시줄 → 기타 시스템 트레이 아이콘에서 켜 두세요.

시스템 요구사항: Windows 10 이상(x64·x86). 설치 과정 없는 포터블 exe라 종료 후 파일을 지우면 제거됩니다(설정은 %APPDATA%\nexa-coffee). 코드 서명은 없습니다. 자세한 사용법은 사용 설명서를 참고하세요.

macOS

Homebrew — 한 줄 설치 (권장)

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

서명 없는 앱이라 Cask가 설치 직후 격리 표시(com.apple.quarantine)를 떼어 바로 실행됩니다. 업그레이드: brew upgrade --cask nexa-coffee · 제거: brew uninstall --zap --cask nexa-coffee(설정 포함).

  1. 또는 GitHub Releases에서 nexa-coffee-<버전>-macos-universal.zip을 내려받아 풉니다.
  2. 터미널에서 xattr -dr com.apple.quarantine "Nexa Coffee.app"을 실행한 뒤 응용 프로그램 폴더로 옮겨 실행합니다.
  3. 로그인 시 자동 실행: 시스템 설정 → 일반 → 로그인 항목에 Nexa Coffee.app을 추가합니다.

macOS 11 Big Sur 이상 · Intel·Apple Silicon 유니버설. 메뉴바에만 표시되고 Dock 아이콘은 없습니다. 덮개를 닫으면 macOS가 강제로 잠재우므로 Nexa Coffee로는 막을 수 없습니다.

Linux

APT 저장소 (Debian · Ubuntu)

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
sudo apt update
sudo apt install nexa-coffee

저장소를 한 번 등록하면 sudo apt upgrade로 갱신됩니다. 제거: sudo apt remove nexa-coffee.

DNF 저장소 (Fedora · RHEL 계열)

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

처음 설치할 때 서명 키 가져오기를 물으면 pkg.sosomlab.com의 지문과 같은지 확인하고 승인하세요.

Homebrew (Linux)

brew install kiros33/tap/nexa-coffee-portable

tar.gz — 내 계정에만 설치

./install.sh --autostart

Releases의 nexa-coffee-<버전>-linux-x64.tar.gz를 풀고 실행합니다. ~/.local에 설치되며 --autostart를 붙이면 로그인 시 자동 실행됩니다. 제거: ./uninstall.sh(설정 ~/.config/nexa-coffee는 남김).

x86_64 전용 정적 실행 파일. 트레이 호스트가 필요합니다 — KDE Plasma는 기본, GNOME은 AppIndicator 확장을 켜야 아이콘이 보입니다. "사용자 지정…" 입력 창에는 yad·zenity·kdialog 중 하나가 필요합니다. Linux에서는 덮개를 닫아도 잠들지 않게 막습니다.

메뉴에서 시간을 고르면 그동안 화면보호기·화면 꺼짐·절전을 막고, 트레이 아이콘에 남은 시간을 숫자와 링으로 보여 줍니다. Windows 실행 파일 약 30KB, 외부 라이브러리 없이 Windows·macOS·Linux에서 같은 모습으로 동작합니다.

주요 기능

소개

Nexa Coffee는 정해 둔 시간 동안 PC가 잠들지 않게 하는 트레이(메뉴바) 타이머입니다. 무제한·12시간·6시간·2시간·1시간·30분 중에서 고르거나 일·시간·분을 직접 입력하면, 그동안 화면보호기·화면 꺼짐·절전·최대 절전 진입을 막고 시간이 다 되면 스스로 풀고 대기 상태로 돌아갑니다. 전원 설정을 바꾸지 않고 긴 다운로드나 빌드, 발표 중에만 잠깐 깨워 둘 때 쓰는 도구입니다.

트레이 아이콘이 곧 타이머입니다. 남은 비율만큼 굵은 호가 줄어들고, 가운데 숫자는 단위마다 색이 다릅니다 — 일은 보라, 시간은 초록, 분은 주황, 초는 빨강, 무제한은 파란 무한대 기호. 메뉴 맨 윗줄에는 0일 12시간 50분 3초 형식의 정확한 남은 시간이 1초마다 갱신됩니다.

초경량 원칙을 따릅니다. 순수 C(macOS만 Objective-C 한 파일)로 작성해 프레임워크와 외부 라이브러리를 쓰지 않습니다. Windows는 C 런타임조차 링크하지 않아 실행 파일이 약 30KB이고, Linux는 libdbus 없이 D-Bus를 직접 구현한 정적 실행 파일 하나라 배포판에 상관없이 동작합니다. 아이콘은 정수 연산만 쓰는 자체 래스터라이저가 그려 세 OS에서 같은 픽셀이 나옵니다.

입력 창과 정보 화면은 필요할 때만 별도 프로세스로 띄워, 창을 닫으면 그 메모리가 함께 사라집니다. 실행 시 자동 시작 옵션으로 앱이 켜질 때 저장해 둔 시간만큼 바로 깨워 둘 수 있고, 메뉴는 English·한국어·日本語·中文 네 언어를 지원합니다.

설치는 Chocolatey(Windows), Homebrew(macOS·Linux), SosomLab APT·DNF 저장소(Linux)로 한 줄 명령이면 되고, GitHub Releases에서 zip·tar.gz·deb·rpm을 직접 받을 수도 있습니다. winget은 등록 심사 중입니다. 덮개 닫힘은 Linux에서만 막을 수 있고, Windows·macOS에서는 OS 전원 정책이 우선합니다. 코드 서명은 아직 없습니다. MIT 라이선스로 누구나 무료로 사용할 수 있습니다.

릴리스 노트

v0.1.2 2026-09-26 Linux 트레이 호스트 재시작 시 비정상 종료 수정 · Linux 로그인 자동 실행 · Windows 배율 변경 대응.

수정

  • Linux: 트레이 호스트가 앱보다 늦게 뜨면 비정상 종료되던 문제 — 로그인 직후 자동 실행, GNOME 셸 재시작, AppIndicator 확장을 나중에 켤 때 발생했습니다. 이제 호스트가 나타나거나 다시 시작되면 아이콘을 다시 등록합니다.
  • Linux: 설치 후 앱 목록에 보이지 않던 문제 — install.sh가 실행 경로를 절대 경로로 쓰고, 기존 아이콘 캐시가 있으면 갱신합니다.
  • Windows: 대기 중 화면 배율을 바꾸면 트레이 아이콘이 옛 크기로 남던 문제 — 배율·디스플레이가 바뀌면 현재 배율로 다시 그립니다.

개선

  • Linux: GNOME 패널에서 숫자가 또렷해짐 — 16px 아이콘을 함께 보내 축소로 흐려지지 않습니다.
  • Linux: 로그인 시 자동 실행 — ./install.sh --autostart로 등록, ./uninstall.sh가 함께 지웁니다.

배포

  • Linux .deb·.rpm 추가 + APT·DNF 저장소(pkg.sosomlab.com) 등록(2026-10-09) — sudo apt install nexa-coffee / sudo dnf install nexa-coffee. 프로그램 자체는 v0.1.2 그대로입니다.
  • Chocolatey nexa-coffee 0.1.2 승인. winget은 등록 심사 중입니다.

GitHub 릴리스에서 보기 →

v0.1.1 2026-09-17 Windows 실행 파일에 버전 정보 추가 — 백신 오탐 완화.

개선

  • Windows 실행 파일에 버전 정보(파일 속성) 추가 — v0.1.0의 32비트 zip이 Microsoft Defender 클라우드 검사에서 오탐(Trojan:Win32/Tecabans.STV!cl)되던 문제를 완화했습니다. 기능 변경은 없습니다.

GitHub 릴리스에서 보기 →

v0.1.0 2026-09-13 첫 공개 — 남은 시간을 보여 주는 3-OS 절전 방지 트레이 타이머.

추가

  • 절전 방지 타이머 — 무제한·12시간·6시간·2시간·1시간·30분·사용자 지정(일·시간·분). 동작 중 화면보호기·화면 꺼짐·절전·최대 절전을 막고 끝나면 자동으로 풉니다.
  • 남은 시간 아이콘 — 남은 비율만큼의 호와 단위별 색 숫자(일 보라·시간 초록·분 주황·초 빨강·무제한 파랑 ∞). 세 OS에서 같은 픽셀로 그립니다.
  • 메뉴 맨 윗줄 남은 시간 1초 갱신 · 실행 시 자동 시작 · 언어 선택(English·한국어·日本語·中文) · 정보 화면 · 중복 실행 방지.
  • 설치 채널 — GitHub Releases(Windows x64·x86 zip, macOS 유니버설 zip, Linux x64 tar.gz), Homebrew, Chocolatey.

GitHub 릴리스에서 보기 →

약관 및 정책

문의: kiros33@sosomlab.com