버스에서 노트북을 반쯤 접고 내리다가 만든 프로그램, LidGuard

퇴근길 버스에서 노트북을 자주 엽니다. 코드를 직접 치기보다 에이전트에게 일을 맡겨 두는 시간이 더 길어서, 내리기 몇 정거장 전에 프롬프트를 넣어 두고 도착할 즈음 결과를 확인하는 식으로 씁니다. 에이전트는 OpenChamber로 돌리고 있습니다.

문제는 에이전트가 정류장에 맞춰 일을 끝내 주지 않는다는 점이었습니다. 덮개를 닫으면 노트북이 잠들고, 노트북이 잠들면 작업도 멈춥니다. 그래서 한동안은 화면이 꺼지지 않을 만큼만 노트북을 접어서 들고 내렸습니다. 한 손에는 반쯤 접힌 노트북을, 다른 손에는 교통카드를 들고 하차 태그를 몇 번 하다 보니 이건 아니다 싶더라고요.

있는 프로그램으로는 애매했습니다

절전 방지 프로그램은 이미 많습니다. 그런데 써 보니 대부분 덮개가 열려 있는 상황을 전제로 하고 있었습니다. 타이머를 걸어 두거나, 특정 프로세스가 떠 있는 동안 막거나, 사용자가 직접 켜고 끄는 방식이었습니다. 덮개를 닫았을 때의 동작까지 바꿔 주는 프로그램은 드물었고, 바꿔 주더라도 나중에 원래대로 돌려놓는 건 제가 기억해야 했습니다.

제가 원한 건 에이전트가 일하는 동안에만 깨어 있다가, 일이 끝나면 원래 전원 설정으로 돌아가서 알아서 잠드는 노트북이었습니다. 가방 안에서 하루 종일 켜져 있는 노트북은 원하지 않았으니까요. 그래서 LidGuard를 만들었습니다.

작업이 끝난 시점을 아는 방법

가장 고민한 부분은 에이전트가 언제 일을 끝냈는지 판단하는 방법이었습니다. 프로세스가 살아 있는지만 보면, 에이전트가 사용자 입력을 기다리며 멈춰 있는 동안에도 노트북이 계속 깨어 있게 됩니다.

다행히 Codex, Claude Code, GitHub Copilot CLI는 세션이 시작되고 끝나는 시점에 hook을 걸 수 있습니다. LidGuard는 이 hook으로 세션을 추적합니다. 세션이 시작되면 일반 절전과 덮개 닫힘 절전을 잠시 막아 두고, 마지막 세션이 끝나면 전원 설정을 되돌린 다음 설정에 따라 절전이나 최대 절전으로 넘어갑니다. Windows에서는 덮개를 닫았을 때의 동작을 잠시 “아무 작업도 안 함”으로 바꾸고, Linux(systemd/logind)와 macOS에서는 각 운영체제가 제공하는 방식으로 막습니다.

LidGuard 동작 화면

설치

.NET 10 전역 도구로 배포하고 있어서, 설치하고 hook을 연결하는 데는 두 줄이면 충분합니다.

dotnet tool install --global lidguard
lidguard hook-install --provider all

에이전트에게 설치를 맡기셔도 됩니다. README에 에이전트용 설치 지시문을 넣어 두었는데, 에이전트가 이 지시문을 읽고 나면 hook 연결부터 안전 설정까지 하나씩 물어보면서 진행합니다. 에이전트 때문에 만든 도구이니 설치도 에이전트가 하는 편이 어울린다고 생각했습니다.

GeekNews에 올린 뒤로 바뀐 것들

몇 달 전에 GeekNews Show GN에 처음 소개했습니다. 첫 댓글은 “Windows에서 WSL에 설치한 에이전트도 감지할 수 있나요?”라는 질문이었는데, 솔직히 생각해 본 적이 없는 환경이었습니다.

고민해 보니 WSL 안에 LidGuard를 한 번 더 설치하는 것보다, 리눅스 쪽 에이전트 hook이 Windows에 설치된 lidguard.exe를 호출하게 만드는 편이 깔끔했습니다. 그렇게 1.0.1을 냈고, 지금은 lidguard wsl-hook-install --provider all 한 줄로 연결할 수 있습니다.

그 뒤로 OpenCode도 플러그인 방식으로 지원하게 됐습니다. 제가 쓰는 OpenChamber가 OpenCode 위에서 동작하다 보니, 지금은 이 플러그인을 제일 많이 쓰고 있습니다. 그리고 기능 중에서 제일 자주 쓰는 건 “절전 전에 한 번 묻기”입니다. 덮개를 닫아 둔 세션이 끝나서 노트북이 잠들기 직전이 되면 휴대폰으로 알림이 옵니다. 알림에서 답장을 보내면 그 내용이 에이전트에게 그대로 전달되고, 노트북은 잠들지 않고 작업을 이어 갑니다.

에이전트가 “작업을 마쳤습니다”라고 할 때 실제로는 “제가 결정해야 할 게 하나 남았습니다”인 경우가 생각보다 많습니다. 지하철에서 가방을 열지 않고도 다음 지시를 보낼 수 있으니 꽤 편했습니다. 다만 알림은 별도 서버(LidGuard.Notifications)가 Web Push로 보내는 구조라서, 이 기능을 쓰려면 서버를 직접 배포하셔야 합니다.

가방에 넣기 전에

켜져 있는 노트북을 닫아서 가방에 넣는 건 그 자체로 조심해야 하는 일입니다. 제 노트북은 Windows on ARM이라 에이전트 작업 정도로는 미지근한 수준에서 그치지만, 모든 노트북이 그렇지는 않습니다. 그래서 덮개가 닫혀 있는 동안 온도를 확인하다가, 설정한 온도를 넘으면 바로 최대 절전으로 보내는 기능을 넣었습니다. 센서와 펌웨어에 따라 동작이 달라질 수 있으니 보조 장치 정도로 생각해 주세요.

덮개가 닫힌 상태에서 에이전트가 권한을 요청할 때 어떻게 처리할지도 정할 수 있습니다. 기본값은 거부입니다. 허용으로 바꾸면 화면을 보지 않는 동안에도 에이전트가 명령을 실행할 수 있으니, 바꾸기 전에 한 번 더 생각해 보시길 권합니다.

아직 덜 검증된 부분

제가 주로 쓰는 환경은 Windows와 OpenChamber(OpenCode)입니다. Linux, macOS, Claude Code, Copilot CLI도 구현은 되어 있지만, 제가 실제로 오래 써 본 환경은 아닙니다. 다른 환경에서 쓰시다가 이상한 점을 발견하시면 GitHub 이슈로 알려 주세요. 한국어로 쓰셔도 됩니다. WSL 지원도 그렇게 받은 질문 하나에서 시작됐습니다.

링크

MIT 라이선스로 배포하고 있습니다.

Windows 11 작업표시줄에 내 앱 UI를 올리는 라이브러리 – Deskband11Lib

Windows 11 작업표시줄 안에 앱 UI를 직접 끼워 넣을 수 있는 라이브러리를 만들었습니다. 이름은 Deskband11Lib이고, NuGet으로 설치하면 WinUI 3이나 WPF 앱을 작업표시줄 위젯으로 만들 수 있습니다.

왜 만들게 됐는지, 어떻게 동작하는지, 그리고 이 라이브러리로 만들어 스토어에 올린 앱까지 순서대로 정리해 보겠습니다.

Windows 11에서 사라진 데스크밴드

Windows 10까지는 작업표시줄에 작은 도구모음을 띄우는 데스크밴드(Deskband) 기능이 있었습니다. 그런데 Windows 11로 넘어오면서 이 기능이 통째로 없어졌죠. 미디어 컨트롤, 시스템 모니터, 빠른 실행처럼 항상 떠 있는 작은 위젯을 작업표시줄에 두고 싶었던 입장에서는 꽤 아쉬운 변화였습니다.

출발점: zadjii의 Deskband11

그러다 GitHub에서 zadjii/Deskband11을 보게 됐는데, 접근 방식이 정말 멋있었습니다.

작업표시줄 위에 투명한 WinUI 3 창을 하나 얹고, 그 창을 작업표시줄의 자식 HWND로 SetParent한 다음, 콘텐츠 크기에 맞춰 클립 영역을 잡아서 마치 작업표시줄의 일부처럼 보이게 만든다.

결국 작업표시줄 위에 떠 있는 창일 뿐인데, 그 발상이 아주 영리했습니다. 다만 원본 프로젝트는 스스로 “해커톤급 코드”라고 밝히고 있었고, 실제 제품에 가져다 쓰기에는 부족한 부분이 있었습니다.

아이디어가 아까워서, dotnet add package 한 줄로 누구나 쓸 수 있도록 라이브러리로 다시 짰습니다.

사용법

WinUI 3 창을 하나 만들고 TaskbarContentHost에 넘겨주면 끝입니다.

var window = new MainWindow();
var host = new TaskbarContentHost(window, rootElement, new TaskbarContentHostOptions
{
    PreferredWidth = 360,
    PreferredHeight = 48
});

await host.AttachWhenLayoutReadyAsync();
window.Activate();

WPF도 API가 거의 같습니다. 그리고 아래와 같은 처리는 라이브러리가 알아서 합니다.

  • 작업표시줄 정렬(왼쪽/가운데) 감지
  • 시작 버튼, 알림 영역과 겹치지 않도록 배치
  • Explorer가 재시작되면 다시 붙이기
  • 레이아웃이 바뀔 때 애니메이션

패키지는 WinUI 3용 Deskband11Lib.WinUI와 WPF용 Deskband11Lib.Wpf 두 가지입니다.

생각보다 오래 걸린 부분

원본 코드를 그대로 돌려 보니 실행은 됐는데, 창의 위치와 크기가 엉뚱하게 잡혔습니다. 해커톤 때 짠 코드라서 그사이 Windows 11 업데이트로 작업표시줄 구현이 바뀐 건지, 원래 코드 자체가 어긋나 있던 건지 처음에는 판단이 서지 않더라고요. 둘 다 원인일 수 있어서, 작업표시줄을 하나씩 뜯어보면서 현재 빌드에서 실제로 어떻게 잡히는지 직접 확인하는 수밖에 없었습니다.

게다가 원본은 시작 버튼이 가운데에 오는 경우나 위젯 버튼 같은 요소를 전혀 고려하지 않고 있어서, 라이브러리로 만들면서 새로 신경 써야 했습니다.

그래서 원본에서는 UI Automation을 쓰는 방식과 창 크기·위치를 잡는 Win32 API 정도만 참고하고, 빈 공간을 계산하는 로직은 처음부터 다시 짰습니다. 시작 버튼, 작업표시줄 앱 버튼 그룹, 위젯 버튼, 알림 영역의 위치를 읽어 와서 남는 공간을 구하는 방식인데, 작업표시줄이 왼쪽 정렬인지 가운데 정렬인지에 따라 여유 공간이 생기는 자리도 달라져서 이 부분도 따로 처리했습니다.

직접 앱을 만들어 스토어에 올렸습니다: BarPlay

라이브러리가 실제로 쓸 만한지 확인하고 싶어서, 이걸로 앱을 하나 만들어 Microsoft Store에 올렸습니다. 이름은 BarPlay입니다.

작업표시줄에 지금 재생 중인 미디어의 썸네일, 제목, 컨트롤을 띄워 주는 위젯입니다. Spotify, 브라우저, YouTube PWA 등 Windows 시스템 미디어 컨트롤(SMTC)을 지원하는 앱이라면 모두 동작합니다. NativeAOT로 컴파일해서 시작 속도와 리소스 사용량도 최소화했습니다.

주변 지인들에게 먼저 소개해 봤는데 반응이 꽤 좋았습니다.

어디에 쓸 수 있을까

WinUI 3나 WPF로 만든 콘텐츠를 별도 창 없이 항상 보이는 자리에 둘 수 있습니다. 예를 들면 이런 용도를 생각해 볼 수 있습니다.

  • 타이머
  • 미디어 재생 컨트롤 (BarPlay처럼)
  • 빌드 상태나 CI 알림
  • 시스템 모니터
  • 퀵 런처, 계정 전환
  • 알림 표시기

내 앱의 컨트롤과 스타일을 그대로 가져가면서 작업표시줄에 올릴 수 있다는 점에서, 데스크밴드가 사라진 Windows 11에서 이런 경험을 만들 수 있는 거의 유일한 .NET 라이브러리라고 생각합니다.

링크

MIT 라이선스이고, 샘플 프로젝트(Deskband11Lib.WinUI.Sample, Deskband11Lib.Wpf.Sample)를 복사해서 바로 시작하실 수 있습니다. 피드백이나 이슈, PR은 GitHub에 남겨 주세요. 재미있는 작업표시줄 위젯을 만드시면 알려 주시고요.

MSIX 인스톨러를 더블클릭 EXE로 만들어주는 도구 – MSIX Installer Generator

MSIX는 Windows의 최신 패키징 포맷입니다. 샌드박스 기반으로 동작해서 레지스트리나 파일 연결 같은 시스템 변경이 격리되고, 삭제하면 잔여물이 하나도 남지 않습니다. MSIXBundle로 x64, x86, ARM64를 하나의 파일에 담을 수도 있고요.

문제는 배포입니다.

MSIX를 스토어 밖에서 설치하려면 사용자가 개발자 모드를 켜고, PowerShell을 열고, 인증서를 신뢰해야 합니다. 개발자한테는 당연한 과정이지만, 일반 사용자한테는 전부 장벽입니다. Electron이나 Tauri로 앱을 만들어도 MSIX 패키징을 지원하지 않는 프레임워크가 많고요.

그래서 만들었습니다. MSIX Installer Generator는 MSIX 패키징부터 더블클릭 EXE 인스톨러 생성까지 한 번에 처리하는 도구입니다.

어떻게 시작됐나

원래 이 프로젝트는 MSIX와는 관계가 없었습니다.

WinUI 3로 만든 앱을 스토어 밖에서 배포하려고, .atp라는 자체 패키지 포맷을 쓰는 인스톨러 프레임워크를 만들고 있었습니다. 7z로 압축해서 인스톨러에 넘기고, 레지스트리 등록이나 시작 메뉴 바로가기 생성을 인스톨러가 처리하는 구조였습니다. 단순한 EXE 패키징으로는 충분히 잘 동작했고요.

그러던 중에 문득 “MSIX를 쓰면 샌드박스까지 지원하는데, 이걸로 인스톨러를 만들면 어떨까?” 하는 생각이 떠올랐습니다. 기존 .atp 방식은 편리하긴 하지만, 결국 레지스트리에 직접 쓰고 AppData에 폴더를 만드는 전통적인 설치 방식이라 깔끔한 삭제가 보장되지 않습니다. MSIX를 쓰면 Windows가 알아서 샌드박스로 격리하고, 삭제할 때 잔여물이 하나도 남지 않잖아요.

그래서 MSIX 설치 지원을 추가하기 시작했는데, 하다 보니 인증서 생성, 매니페스트 작성, 패키징까지 전부 사용자가 직접 해야 한다는 게 문제였습니다. 프레임워크가 MSIX 패키징을 지원하지 않는 경우도 많고요. 결국 패키징까지 자동화하는 도구를 만들게 됐고, 지금은 MSIX 패키징부터 EXE 인스톨러 구성까지 한 번에 처리하는 형태가 됐습니다.

어떤 문제를 풀고 싶었나

MSIX로 배포하려니 사용자 경험이 너무 안 좋았습니다.

  • “개발자 모드를 켜세요” → 사용자가 당황
  • “PowerShell을 관리자 권한으로 열어서 명령어를 입력하세요” → 더 당황
  • “인증서를 신뢰하세요” → 제일 당황

인스톨러를 더블클릭하면 끝나는 전통적인 EXE 인스톨러의 간편함과 MSIX의 샌드박스 이점을 둘 다 가져가고 싶었습니다.

MSIX Installer Generator가 하는 일

크게 두 가지입니다.

1. MSIX 패키징

인증서 생성, 매니페스트 작성, 빌드 출력 패키징을 GUI에서 처리합니다. 프레임워크가 MSIX 패키징을 지원하지 않아도, 빌드 출력 폴더만 지정하면 됩니다. x64, x86, ARM64 등 아키텍처별 폴더를 추가하면 PE 헤더를 읽어서 자동으로 감지하고, 단일 .msix 또는 다중 아키텍처 .msixbundle을 만들어 냅니다.

2. EXE 인스톨러 구성

만들어진 MSIX를 더블클릭 한 번에 설치되는 독립 실행형 EXE 인스톨러로 변환합니다. 사이드로딩에 필요한 모든 과정(인증서 설치, 의존성 처리 등)을 인스톨러가 알아서 처리합니다. 사용자 입장에서는 그냥 인스톨러를 다운로드하고 실행하면 끝입니다. PowerShell도, 개발자 모드도, 인증서 프롬프트도 나오지 않습니다.

CLI 도구도 있습니다

GUI 말고 CLI 도구(aticmsixgen)도 NuGet에 올려뒀습니다. CI나 AI 자동화 워크플로에서 명령줄로 MSIX 패키징과 EXE 구성을 전부 처리할 수 있습니다. NativeAOT로 빌드해서 런타임 의존성이 없는 단일 실행 파일입니다.

dotnet tool install --global aticmsixgen

인증서 생성, 매니페스트 작성, MSIX 패키징, EXE 구성까지 전부 CLI에서 됩니다.

이런 분들께 잘 맞습니다

  • MSIX로 배포하고 싶은데 사이드로딩 과정이 부담스러운 분
  • Electron, Tauri, WPF 등 MSIX 패키징을 기본 지원하지 않는 프레임워크를 쓰는 분
  • x64, x86, ARM64 등 여러 아키텍처를 하나의 인스톨러로 배포하고 싶은 분
  • CI에서 MSIX 패키징과 EXE 구성을 자동화하고 싶은 분

링크

MIT 라이선스이고, 피드백이나 이슈는 GitHub에 남겨주시면 됩니다. 한국어도 괜찮습니다.

Windows 10/11에서 카카오스토리 알림을 웹 페이지로 연결되는 토스트로 띄워주는 프로그램 – 카카오 스토리 웹 알리미

스크린샷:

소스코드
다운로드

변경내역:

1.0.0: 첫 릴리즈

1.0.1:
– 알림상의 앱 이름을 exe 파일명이 아닌 “카카오스토리 웹 알리미”로 변경
– 업데이트 안내 문구를 한국어로 변경
– 알림이 올 때, 기존에 표시된 알림 중 같은 게시글의 알림이 있는 경우 해당 알림을 지우는 기능 추가
– 알림 내용이 “내용 없음”일 경우, 그냥 해당 내용을 보여주지 않게끔 수정

1.0.2:
시스템 재시작 이후 프로그램이 제대로 실행되지 않고 오류 로그를 대량으로 기록하는 오류 수정
로그인 전용 브라우저 로직과 관련된 오류 수정

1.0.3 / 1.0.4:
시스템 재시작 이후 프로그램이 제대로 실행되지 않고 오류 로그를 대량으로 기록하는 오류 수정

Windows 10/11에서 PC의 리소스를 작업 표시줄의 고정 아이콘으로 확인 – Pin Stats

스크린샷:

소스코드
다운로드

변경 내역:
1.0.0: 최초 릴리즈 / CPU 사용량 조회 및 그래프 조회 기능 제작
2.0.0: GPU/메모리/네트워크 모니터링 기능 추가
2.0.1: GPU 사용량이 올바르지 않게 표시되는 오류 수정 및 컨텍스트 메뉴에 버전,저자 정보 추가
2.0.2: Intel GPU 버그 수정 및 타이머 멈추는 오류 수정
2.0.3:
– 타이머 버그 수정 및 예외 핸들링
– UI 수정
– 팝업 창 위치를 고정된 위치로 설정
– 기타 코드상의 수정
2.0.4: 이전에 관찰된 5개의 사용량 값을 캐싱하여 갑작스러운 사용량 급증 방지
2.0.5:
– CPU 및 GPU 사용량 정확도 개선
– 아이콘 갱신 안되는 버그 수정|
2.0.6: 프로그램 실행 이후 몇 분이 지나면 GDI+ 핸들의 누수로 인해 강제 종료 되는 오류 수정

2.0.7:
관리자 모드에서 프로그램을 실행하여 다음과 같은 자세한 정보를 확인할 수 있습니다:

  • CPU 온도 및 전력 사용량
  • GPU 전력 사용량
  • 배터리 잔량 및 충전 및 방전 속도
  • 배터리 수명 상태(퍼센트)

시작 프로그램 등록과 관련된 몇 가지 버그 수정

2.0.9:
시작 프로세스 버그 수정
배터리 충전률 정보 텍스트의 오타 수정

2.1.0:
오타 수정 (BatteryHealth -> Battery Health)
(실험적) 윈도우 10 지원

2.1.1:
업데이트 확인 기능 추가

2.1.2:
어두운 테마 기기를 위해 아이콘과 텍스트를 검은색으로 표시하는 기능 추가
(Reflection님이 구현하셨습니다. 감사합니다!)
작업 표시줄을 왼쪽 또는 오른쪽으로 정렬한 사용자의 리포트 창 위치가 잘못 표시되던 버그를 수정

2.1.3:
가상 메모리 정보를 표시하는 기능 추가
초당 스토리지 읽기/쓰기 속도를 표시하는 기능 추가
정보량 증가에 따른 리포트 창 크기 증가
리포트 창 초기 로딩 시간 및 타이머 정확도 개선

2.1.4: 처음 실행 시 시스템 테마 설정에 따라 아이콘 테마 색상 자동 설정

2.1.5:
코드베이스 리팩토링
기능: 전용 모니터링 디스플레이를 위한 H/W 모니터

2.1.6:
모니터 감지 관련 버그 수정 (H/W 모니터)

2.1.7:
사소한 UI 수정

2.1.8:
기능: 이제 팝업 창/하드웨어 모니터 창에 배경 이미지를 설정할 수 있습니다.

2.1.9:
기능: 컨텍스트 메뉴의 메뉴를 통해 하드웨어 목록을 새로 고칠 수 있습니다.
오타 수정
코드베이스 리팩토링

2.2.0:
버그 수정: 모니터 인식과 관련된 문제 해결
버그 수정: 키보드 단축키를 통해 다른 모니터로 이동할 때 H/W 모니터 창이 전체 화면 모드가 아닐 수 있는 버그 수정

2.2.1:
설치 관리자 지원
하드웨어 수동 새로 고침 성능 개선
.NET 8 업데이트 및 WinUI 버전 업그레이드
기능: 시작 시 자동 시작 바이너리 위치를 확인하고 손상된 경우 잘못된 경로를 수정

C# Selenium Driver 자동 설정 라이브러리

Selenium의 특성상 브라우저의 드라이버가 브라우저의 버전과 정확히 일치하여야 되는 단점이 있어 설치된 브라우저의 버전을 읽고 해당하는 드라이버를 자동으로 다운로드 및 캐싱해주는 프로젝트를 생성하였습니다.

링크

현재는 Edge와 Chrome만 지원합니다만, 차후 지원 브라우저를 늘릴 예정입니다.

원클릭으로 영상 프레임을 두배로 늘려주는 프로그램 Frame Interpolation

참고 소스 : https://github.com/nihui/dain-ncnn-vulkan

클릭 한번으로 영상의 프레임을 늘려주는 프로그램입니다. DAIN을 사용하였으며, 성능은 아래의 영상을 확인해주세요.

※ GPU를 사용하나, 프레임 보간이 매우 오래걸립니다. 이 점 참고해주세요.
※ 현재로써는 실행 파일 경로와 변환 파일 경로에 특수문자나 한글이 있으면 안됩니다 (1.2.0 업데이트로 해결됨)

프로그램 UI
DAIN 성능 비교 영상

다운로드
소스코드

변경 내역 :
* 1.0.0 : 최초 공개
* 1.1.0 : 프레임 보간 작업에 대한 프로그래스바 추가
* 1.2.0 : 프로그래스바 오류 수정 및 특정 상황에서 프로그램이 종료되는 오류 수정