GitHub와 GitLab을 오가며 저장소 알림을 확인한다면 Forge Sparks로 목록을 한곳에 모아 볼 수 있습니다. GNOME 공식 앱 목록은 GitHub·GitLab·Gitea·Forgejo 알림을 지원하는 프로그램으로 소개하고, Flathub는 Linux용 무료 설치를 제공합니다.
이 글은 공식 설치 경로와 계정 연결 화면, 알림 목록 읽기와 백그라운드 설정까지 다룹니다. 화면에 보이는 계정 이름과 알림은 개발자가 제공한 예시입니다. 자신의 계정에 연결하기 전에는 접근 토큰이 필요한 이유와 권한을 먼저 확인하세요.
Forge Sparks는 어떤 알림을 모아 주나요?
Forge Sparks는 Git 서비스에서 받은 알림을 계정별로 모아 보여 주는 데스크톱 앱입니다. 공식 화면에는 저장소 이름, 알림 제목, 계정 주소와 받은 시점이 행마다 표시됩니다. 예시에는 이슈와 변경 요청에 관한 알림이 섞여 있지만, 실제 목록은 연결한 계정에 도착한 알림에 따라 달라집니다.
계정을 연결해야 목록이 채워집니다. 처음 실행 화면에는 Add Account…가 있으며, 이후에는 오른쪽 위 메뉴의 Accounts에서 계정을 추가하거나 확인할 수 있습니다. 앱은 브라우저 로그인 버튼 대신 서비스별 Access Token을 받는 방식이므로 계정 권한을 읽고 직접 준비해야 합니다.
알림 목록은 저장소를 통째로 복제하거나 이슈를 새로 만드는 화면이 아닙니다. 먼저 어떤 계정과 저장소에서 확인할 일이 생겼는지 파악하는 용도로 보세요. 제목이 길면 화면에서 끝이 잘릴 수 있으므로 항목을 열어 원래 서비스의 내용을 확인하는 편이 안전합니다.
GNOME 목록의 확인 시점 최신 표기 버전은 1.0.1입니다. Flathub에는 Free와 Linux x86_64·aarch64가 표시됩니다. 이 글의 파일은 Flathub stable .flatpakref이며, 작은 참조 파일을 받은 것만으로 앱 전체가 설치되는 것은 아닙니다.
공식 화면에서 알림·계정·설정 확인하기
GNOME 공식 이미지입니다. 알림 목록의 Mark all as Read, Preferences의 백그라운드 설정, Accounts의 Add…와 계정 행이 보입니다. 예시 계정과 알림은 실제 사용자 데이터가 아닙니다.
| 프로그램 | Forge Sparks |
| 개발자 | Rafael Mardojai CM |
| 공식 표시 버전 | 1.0.1 |
| 지원 운영체제 | Linux |
| 공식 앱 ID | com.mardojai.ForgeSparks |
| 배포 경로 | Flathub stable Flatpak |
| 지원 서비스 | GitHub·GitLab·Gitea·Forgejo |
Linux에 설치하고 연결할 계정 준비하기
GNOME 공식 Forge Sparks 페이지에서 Get the app을 선택해 Flathub로 이동하세요. 이름과 앱 ID com.mardojai.ForgeSparks를 확인한 다음 Linux 소프트웨어 센터에서 설치할 수 있습니다. stable .flatpakref를 받는 방법도 있지만, Flatpak·Flathub가 설정돼 있어야 실제 앱 파일을 내려받습니다.
앱을 처음 열면 Welcome to Forge Sparks 화면에서 Add Account…를 선택합니다. 이미 계정이 있다면 오른쪽 위 메뉴의 Accounts를 열어 Add…를 누르세요. Add Account 화면에서 Forge를 고르고, 필요하면 Instance URL을 확인한 뒤 Access Token을 입력합니다. 토큰이 맞는지 확인되면 Add로 계정을 저장할 수 있습니다.
GitHub 연결을 예로 들면 공식 소스는 일반 용도의 classic 개인 접근 토큰에 notifications와 read:user 권한이 필요하다고 안내합니다. 비공개 저장소까지 다루려면 repo 권한도 요구합니다. repo는 넓은 권한이므로 필요한 범위를 이해한 경우에만 부여하세요. 토큰을 글이나 채팅에 붙여 넣지 말고 앱의 입력란에만 넣으세요.
GitHub 문서는 classic 토큰이 계정의 여러 저장소에 접근할 수 있어 주의가 필요하며 만료일을 설정하도록 권장합니다. Forge Sparks를 위해 토큰을 따로 만들고 무엇에 쓰는지 구분되는 이름과 만료일을 정해 두면 나중에 폐기할 때 찾기 쉽습니다. 발급 화면에서 표시되는 값을 보관할 필요가 있다면 개인이 관리하는 안전한 저장소를 이용하고, 게시글이나 스크린샷에는 절대 노출하지 마세요.
Instance URL은 계정이 연결될 서버를 가리킵니다. github.com이나 gitlab.com을 쓰는지, 회사나 개인이 운영하는 별도 서버를 쓰는지 먼저 확인하세요. 주소를 잘못 선택하면 올바른 토큰을 넣어도 다른 서버에서 인증을 시도하게 됩니다. 공식 계정 입력 화면은 주소 형식을 검사하며 주소가 비어 있거나 토큰이 없으면 Add 버튼을 활성화하지 않습니다.
- Flathub의 Forge Sparks 이름과 앱 ID를 대조해 설치합니다.
- 첫 화면의 Add Account… 또는 메뉴의 Accounts → Add…를 엽니다.
- Forge와 필요한 Instance URL을 확인하고 해당 서비스에서 발급한 토큰을 앱에 입력합니다.
알림 목록에서 저장소와 계정 구분하기
계정 연결이 끝나면 알림 목록에서 제목만 보지 말고 그 아래의 저장소 이름과 오른쪽 계정 주소를 함께 보세요. 같은 제목의 이슈라도 어느 저장소와 계정에서 온 것인지 구분할 수 있습니다. 공식 화면에는 여러 날짜의 알림이 한 목록에 나타나며, 화면 맨 위에는 Mark all as Read가 있습니다.
읽지 않은 알림을 차례로 확인해 필요한 작업을 정하세요. Mark all as Read는 목록을 읽음 처리하려는 버튼이므로 아직 처리하지 않은 항목이 있다면 먼저 살펴보는 편이 좋습니다. 알림을 한 번 읽었다고 저장소의 이슈나 변경 요청이 완료되는 것은 아닙니다.
GitLab을 함께 쓰는 경우 Accounts에서 별도 계정을 추가합니다. 공식 소스는 GitLab 알림 읽기에 read_api, 할 일 완료 표시까지 하려면 api 권한이 필요하다고 안내합니다. 단순히 목록을 확인하려는 경우에는 필요한 기능에 맞춰 권한을 골라야 합니다. Gitea와 Forgejo도 지원하지만 토큰 발급 화면과 권한은 각 서비스에서 확인하세요.
계정이 한 개면 어떤 계정의 목록인지 헷갈릴 일이 적지만, 여러 계정을 추가했다면 각 행의 계정 표시를 함께 보세요. 공식 화면의 오른쪽에는 계정 주소가 보이고, 아래에는 저장소 이름이 나옵니다. 예시 이미지의 날짜는 개발자 자료의 과거 알림이므로 현재 알림이 늦게 도착한다는 뜻이 아닙니다. 새 항목이 없다는 문구가 보이면 서비스 웹사이트의 알림 상태와 비교해 실제로 읽지 않은 항목이 있는지 확인하세요.
알림 행을 열면 원래 내용을 확인할 수 있도록 연결되는 동작이 코드에 정의돼 있습니다. 목록의 제목만으로 처리 여부를 결정하지 말고 원래 이슈나 변경 요청의 상태, 담당자와 새 댓글을 확인하세요. 이미 해결된 항목이 오래된 알림으로 남아 있을 수도 있으므로 저장소의 현재 상태를 기준으로 다음 작업을 정하는 것이 좋습니다.
- 계정별 알림 제목과 저장소 이름을 함께 읽습니다.
- 처리할 항목을 먼저 확인한 뒤 읽음 상태 변경 여부를 정합니다.
- 다른 서비스를 추가할 때는 Accounts에서 계정을 별도로 연결합니다.
백그라운드 알림과 시작 설정 살펴보기
창을 닫아도 새 알림을 받으려면 메인 메뉴의 Preferences에서 Keep Running in Background를 확인하세요. 공식 설정 화면에는 Run on Startup과 Start Hidden도 보입니다. 백그라운드 실행이 꺼져 있거나 Linux 환경에서 허용되지 않으면 창을 닫은 뒤 알림을 기대하기 어렵습니다.
Run on Startup은 로그인할 때 앱을 시작하는 설정입니다. Start Hidden은 시작할 때 창을 감추는 선택지로 보이지만, 화면 예시에서는 비활성화돼 있습니다. 먼저 백그라운드 실행 상태를 확인하고, 실제 사용할 Linux의 시작 프로그램·알림 권한도 함께 살펴보세요. 설정을 켜는 것만으로 모든 데스크톱에서 동일하게 동작한다고 단정하지 않습니다.
공식 소스는 첫 실행 때 시스템의 백그라운드 실행 허용을 요청하고 그 결과에 따라 창을 닫은 뒤 계속 실행하는 설정을 정합니다. 처음 나타난 허용 창을 닫거나 거부했다면 Preferences의 현재 값을 다시 확인하세요. 알림이 필요할 때는 앱이 백그라운드에 남아 있는지와 데스크톱의 알림 방해 금지 설정도 별도로 살펴보는 편이 빠릅니다.
계정을 추가했는데 알림이 비어 있을 때
알림이 보이지 않으면 우선 해당 Git 서비스 웹사이트에서 계정에 새 알림이 있는지 확인하세요. 앱에 등록한 계정이 다른 계정이거나, 토큰이 만료됐거나, 권한이 부족하면 목록이 비어 있거나 인증 오류가 날 수 있습니다. Accounts에서 계정 주소와 선택한 Forge, Instance URL을 다시 확인합니다.
GitHub 연결 오류라면 classic 토큰의 notifications와 read:user 권한을 공식 안내와 대조하세요. 비공개 저장소 알림이 필요한 경우에만 repo 권한 요구 사항을 따로 검토합니다. 토큰을 다시 발급했다면 이전 토큰의 사용 여부를 확인하고 필요 없는 토큰은 서비스 설정에서 폐기하세요.
계정 추가 화면은 인증이 되지 않았을 때와 필요한 권한이 없을 때 다른 오류를 표시하도록 정의돼 있습니다. 'Couldn’t authenticate the account'라면 서버 주소와 토큰 값·만료 여부부터 확인하고, 'The access token doesn’t have the needed scopes'라면 선택한 서비스의 권한을 확인하세요. 오류가 다르다고 무조건 더 넓은 권한을 추가하지 말고, 해당 계정에서 실제 필요한 알림 범위와 앱의 공식 안내를 먼저 대조해야 합니다.
GitLab의 개인 접근 토큰도 발급 시 만료일과 범위를 선택합니다. GitLab.com이 아닌 자체 운영 인스턴스라면 그 서버의 주소와 정책이 다를 수 있으므로, 계정 추가 화면의 Instance URL을 원래 서비스 주소와 비교하세요. 알림 읽기만 필요한데 api처럼 넓은 권한을 먼저 부여하지 않도록 기능을 정한 뒤 토큰을 만들면 불필요한 접근을 줄일 수 있습니다.
설치 참조 파일이 열리지 않으면 Flatpak을 지원하는 소프트웨어 센터와 Flathub 저장소 설정을 확인하세요. 파일 크기만 보고 손상됐다고 판단하지 말고, 앱 ID와 stable 경로가 맞는지 살펴보세요. 앱은 설치됐지만 창을 닫으면 알림이 끊긴다면 Preferences와 Linux의 백그라운드 허용 상태를 확인합니다.
자주 묻는 질문
Forge Sparks는 무료인가요?
네. Flathub의 Forge Sparks 항목에 Free로 표시됩니다.
어떤 Git 서비스를 지원하나요?
GNOME 공식 설명에는 GitHub, GitLab, Gitea, Forgejo가 나옵니다.
GitHub 비밀번호를 앱에 입력하나요?
아니요. Add Account 화면은 Access Token을 받습니다. 공식 소스의 GitHub 안내는 classic 토큰과 필요한 권한을 설명합니다.
알림이 없으면 설치가 실패한 건가요?
그렇지는 않습니다. 계정에 새 알림이 있는지, 연결한 계정과 토큰 권한이 맞는지부터 확인하세요.
창을 닫아도 알림을 받으려면요?
Preferences의 Keep Running in Background와 Linux의 백그라운드·알림 허용 상태를 확인하세요.
한 계정부터 연결하고 알림 목록을 확인하세요
Forge Sparks를 설치할 때는 Flathub의 앱 ID를 확인하고, 첫 실행에서는 한 서비스의 계정만 연결해 보세요. 알림 제목과 저장소·계정을 함께 읽으면 여러 저장소의 작업을 구분하기 쉽습니다.
백그라운드 알림을 원한다면 Preferences와 Linux 권한을 확인하세요. 계정 토큰에는 앱이 요구하는 권한만 부여하고, 사용하지 않게 되면 발급한 서비스에서 정리하는 것이 좋습니다.
공식 자료와 확인일
Forge Sparks GNOME 공식 설명·화면·버전 · Forge Sparks Flathub 무료 배포·지원 아키텍처 · Forge Sparks 공식 계정 연결 화면 · Forge Sparks GitHub 토큰 권한 안내 · Forge Sparks GitLab 토큰 권한 안내 · GitHub 개인 접근 토큰 관리 · GitLab 개인 접근 토큰 관리 · Flatpak 공식 배포판별 설정 | 2026-10-30T00:55:23.779454+00:00
