ILKO

네트워크 기반 자동 월페이퍼 전환 — 집에선 덕질, 밖에선 일코

YOUTUBE : ILKO(일코) - 씹덕들의 일코를 위한 네트워크 기반 월페이퍼 자동 전환 서비스

(영상 내에서는 월페이퍼가 이미지처럼 보이는데, 실제로는 mp4로 재생 됩니다. 영상 녹화 시에는 사진취급 되네요.)

Wi-Fi 게이트웨이를 감지해 장소에 맞는 월페이퍼로 자동 전환하는 앱. macOS · Windows 지원.
집에선 좋아하는 캐릭터 라이브 월페이퍼, 카페·회사에선 조용한 기본 배경으로

Based on LiveWallpaperMacOS by thusvill, licensed under GPL v3.

---

주요 기능

기능	macOS	Windows
게이트웨이 MAC 기반 자동 전환	✅	✅
라이브 영상 월페이퍼 (mp4)	✅	✅
정적 이미지 월페이퍼	✅	✅
멀티모니터 지원	✅	✅
Wi-Fi 단절 시 기본 프로필 자동 전환	✅	✅
프로필별 네트워크 등록	✅	✅
시스템 트레이 / 메뉴바 상주	✅	✅

---

macOS

설치 (DMG 권장)

1. Releases에서 ILKO-vX.X.X.dmg 다운로드
2. DMG 열고 ILKO.app → Applications 폴더로 드래그
3. 터미널에서 아래 명령 실행 (최초 1회):

   xattr -d com.apple.quarantine /Applications/ILKO.app

   이 단계를 건너뛰면 "손상되었기 때문에 열 수 없습니다" 오류가 발생합니다.

4. ILKO 실행 → 메뉴바 아이콘 확인

소스 빌드

요구사항: macOS 14.6+, Xcode Command Line Tools

git clone https://github.com/winshine0326/ilko.git
cd ilko
make run

DMG 직접 생성:

make dmg VERSION=1.0.0
# 결과물: dist/ILKO-1.0.0.dmg

사용법

핵심 개념: 프로필이란?

ILKO는 장소(네트워크)별 월페이퍼 프로필로 동작합니다.

프로필 종류	언제 적용되나	용도
기본 프로필 (GatewayMAC 없음)	등록된 네트워크가 아닐 때	외출 시 보여줄 일반 배경화면
네트워크 프로필	해당 게이트웨이 MAC에 연결됐을 때	집/특정 장소에서 보여줄 배경화면

중요: 오타쿠 월페이퍼는 반드시 네트워크 프로필에 설정해야 합니다.
기본 프로필에 설정하면 어디서든 오타쿠 배경화면이 표시됩니다.

초기 설정 (5분)

1단계 — 기본(외출용) 프로필 설정

앱을 처음 실행하면 "기본 (일코)"라는 프로필이 자동 생성됩니다.

1. 메뉴바 아이콘 클릭 → 설정 열기

   

2. 툴바 👥 버튼 → 프로필 관리 화면

   

3. "기본 (일코)" 프로필 선택 → 편집

4. 외출 시 쓸 평범한 배경화면 파일 지정 후 저장

2단계 — 집(오타쿠용) 프로필 추가

1. 프로필 관리 화면에서 프로필 추가

2. 프로필 이름 입력 (예: "집")

3. 네트워크 자동 감지 버튼 클릭 → 현재 연결된 게이트웨이 MAC이 자동 입력됨

   • 자동 감지가 안 되면: 터미널에서 netstat -rn | grep default | awk '{print $2}' 로 게이트웨이 IP 확인 후 arp <IP>로 MAC 조회

4. 오타쿠 배경화면 파일 지정 (mp4/mov/jpg/png)

5. 저장

3단계 — 완료

이후 집 Wi-Fi에 연결되면 오타쿠 월페이퍼로, 다른 네트워크에서는 기본 월페이퍼로 자동 전환됩니다.

파일명 주의: 비디오 파일명에 .이 2개 이상이면 인식 불가.
rem-loop.mp4 ✅ / rem.1920x1080.mp4 ❌

시스템 요구사항

• macOS 14.6 (Sonoma) 이상

---

Windows

설치

EXE (권장)

1. Releases에서 ILKO-vX.X.X-windows-x64.exe 다운로드
2. 다운받은 EXE 실행 — 설치 불필요, 단독 실행 파일
3. 시스템 트레이 아이콘 확인

.NET 런타임 내장 파일이라 별도 설치 없이 바로 실행됩니다.

소스 빌드

요구사항: Windows 10 이상, .NET 8 SDK

git clone https://github.com/winshine0326/ilko.git
cd ilko/windows
"C:\Program Files\dotnet\dotnet.exe" run

사용법

macOS와 동일한 프로필 개념으로 동작합니다 — 기본 프로필(외출용)과 네트워크 프로필(집용)을 분리해서 설정하세요.

1단계 — 기본(외출용) 프로필 설정

1. 앱 실행 → 시스템 트레이 아이콘 확인
2. 트레이 아이콘 더블클릭 또는 우클릭 → 설정 열기
3. 좌측 사이드바에서 "기본 (일코)" 프로필 선택 → 편집
4. 외출 시 쓸 평범한 배경화면 지정 후 저장

2단계 — 집(오타쿠용) 프로필 추가

1. 사이드바 하단 + 버튼 클릭
2. 프로필 이름 입력 (예: "집")
3. 현재 네트워크 자동 감지 버튼 클릭 → 게이트웨이 MAC 자동 입력
4. 오타쿠 배경화면 파일 선택 (mp4/mov/jpg/png 등)
5. 저장

라이브 영상 월페이퍼 동작 방식

Windows 버전은 Windows Media Foundation(MFPlay) + WorkerW 방식으로 영상을 바탕화면에 렌더링합니다.

• Progman에 0x052C 메시지를 보내 WorkerW(바탕화면 아이콘 뒤 레이어)를 확보
• WinForms HWND를 WorkerW 자식으로 SetParent
• MFPCreateMediaPlayer로 EVR이 해당 HWND에 D3D9 COPY 모드로 직접 렌더링
• 영상 종료 시 자동 루프

지원 형식

종류	형식
영상	.mp4, .mov, .avi, .mkv 등 Windows Media Foundation 지원 형식
이미지	.jpg, .jpeg, .png, .bmp, .gif

알려진 제한사항

• 영상 월페이퍼는 바탕화면 아이콘 뒤에 렌더링됩니다 (정상 동작)
• 일부 DRM이 걸린 영상 파일은 재생되지 않을 수 있습니다

시스템 요구사항

• Windows 10 이상
• .NET 8 Runtime
• Windows Media Foundation (기본 내장)

---

월페이퍼 영상 다운로드 링크 모음 (여러분들이 찾은 사이트를 계속해서 추가해주세요!)

• https://motionbgs.com/
• https://moewalls.com/anime

---

크레딧

Based on LiveWallpaperMacOS by thusvill — GPL v3.

---

For licensing details, see LICENSE.