SwiftBar

누가 어떤 용도로 쓰는가

SwiftBar는 필요한 정보를 짧은 제목으로 표시하고 클릭했을 때 상세 내용과 작업 메뉴를 보여 주는 도구다. 명령줄 작업에 익숙한 개발자·운영자에게 특히 적합하지만, 기존 플러그인이나 macOS 단축어로 시작할 수도 있다. 표시할 데이터를 가져오는 기능은 각 플러그인이 담당하므로, 원하는 항목의 데이터 출처와 실행 조건을 함께 확인해야 한다. [공식 README](https://github.com/swiftbar/SwiftBar)

설치와 첫 메뉴 만들기

공식 GitHub Releases에서 안정판을 받아 앱을 실행하거나, Homebrew를 사용하는 환경에서는 공식 안내의 brew install swiftbar 경로를 이용한다. 첫 실행에서는 플러그인 전용 폴더를 지정한다.

처음에는 Get Plugins에서 단순한 플러그인을 고르거나, 날짜를 출력하는 스크립트를 date.1m.sh 같은 이름으로 넣어 1분마다 갱신되는지 확인하는 방식이 좋다. 폴더 안의 파일은 플러그인으로 실행될 수 있으므로 관련 파일만 두고 실행 내용을 먼저 살펴본다. [공식 설치·플러그인 안내](https://swiftbar.github.io/SwiftBar/)

표시와 동작을 구성하는 방법

스크립트 출력에서 첫 --- 앞은 메뉴 막대 제목, 뒤는 펼침 메뉴 내용이 된다. 여러 제목을 출력하면 메뉴 막대에서 순환해 보여 준다. 항목에는 링크나 실행 명령을 연결할 수 있어 상태 확인과 후속 작업을 한 메뉴에 모을 수 있다.

갱신은 파일명에 지정한 주기, Cron 일정, 클릭 시 새로고침 등으로 구성한다. 지속적인 이벤트를 받는 스트리밍 방식도 지원한다. 조회 비용이 있는 데이터는 실제 필요한 간격으로 갱신하는 편이 좋다. [공식 플러그인 문서](https://swiftbar.github.io/SwiftBar/)

실무 예시: 서비스 상태 확인

운영 중인 웹서비스를 주기적으로 확인하는 스크립트를 준비하고, 메뉴 막대에는 '서비스 정상' 또는 '응답 오류'를 출력하도록 구성할 수 있다. 펼침 메뉴에는 마지막 확인 시각, 응답 결과, 관리 페이지 링크, 다시 확인 항목을 배치한다.

이는 SwiftBar의 출력 형식과 메뉴 동작을 활용한 구성 예시다. 상태 판정과 네트워크 조회는 사용자가 준비한 스크립트가 수행하며, SwiftBar 자체가 서비스 감시 시스템을 제공하는 것은 아니다.

비용과 사용 제약

SwiftBar는 MIT 라이선스로 공개되어 있으며 공식 배포 파일을 무료로 받을 수 있다. 확인한 공식 자료에는 별도 유료판이나 구독에 따른 기능 구분이 제시되어 있지 않다. 외부 데이터를 이용하는 플러그인은 해당 서비스의 계정, 인증키, 이용 요금이나 요청 제한을 따로 확인해야 한다.

직접 만든 플러그인은 실행 언어와 외부 명령 등 의존성을 준비해야 하며, 데이터 조회 실패를 처리하는 책임도 스크립트에 있다. [공식 라이선스](https://github.com/swiftbar/SwiftBar/blob/main/LICENSE)

메뉴가 없거나 오류가 날 때

항목이 나타나지 않으면 지정한 플러그인 폴더와 파일명, 실행 가능 여부를 먼저 확인한다. 다음으로 스크립트를 터미널에서 실행해 필요한 명령과 인증 정보가 있는지, 표준 출력이 비어 있지 않은지 살펴본다. 정상 종료해도 출력이 비어 있으면 메뉴 막대에 표시되지 않는다.

경고 아이콘이 나오면 펼침 메뉴의 Error를 열고 macOS Console에서 로그를 확인한다. ~/.swiftbar 폴더에서 플러그인이 누락되는 문제는 2.1.1의 수정 항목이다. [공식 2.1.1 배포 설명](https://github.com/swiftbar/SwiftBar/releases/tag/v2.1.1)

다른 도구와 선택 기준·지원 상태

BitBar·xbar 플러그인을 이미 보유했다면 공식 호환 형식을 바탕으로 SwiftBar에서 활용 가능성을 검토할 수 있다. 원하는 정보와 실행 메뉴를 직접 조합하려면 SwiftBar가 적합하고, 정해진 기능을 설정만으로 쓰려면 해당 기능의 전용 앱과 비교하는 편이 좋다. 스크립트 작성 부담이 크다면 SwiftBar의 단축어 플러그인 방식도 선택지다.

2026-10-09 확인 시 안정판 표시는 2.1.1이고 2.1.2 beta 5는 사전 배포판이다. 지원 종료 공지는 확인되지 않았으며 후속 수정이 이어지고 있다. 현재 OS 기준은 최신 README와 안정판 설명의 macOS 12 이상으로 판단해야 한다. [공식 배포 목록](https://github.com/swiftbar/SwiftBar/releases)

공식 안내

• SwiftBar 공식 홈페이지 · 확인 2026-10-09
• SwiftBar 공식 README · 확인 2026-10-09
• SwiftBar 공식 설치·플러그인 문서 · 확인 2026-10-09
• SwiftBar 2.1.1 공식 릴리스 · 확인 2026-10-09
• SwiftBar 2.1.0 공식 릴리스 · 확인 2026-10-09
• SwiftBar 공식 릴리스 목록 · 확인 2026-10-09
• SwiftBar MIT License · 확인 2026-10-09