searchConf

1. 프로그램 개요

SearchConf Finder는 지정한 폴더 안에서 특정 검색어가 포함된 특정 확장자 파일(.conf 등) 을 빠르게 찾기 위한 도구입니다. 하위 폴더 검색, 대소문자 구분, 전역 단축키, 트레이 아이콘 지원합니다.

---

2. 기본 UI 구성

• 폴더 경로 입력 / 선택
• 검색어 입력
• 확장자(.conf 기본)
• 하위 폴더 포함 여부
• 대/소문자 구분
• 검색 / 정지 / 지우기 / 설정 버튼
• 검색 결과 리스트
• 상태 메시지 표시줄

---

3. 사용 방법

3-1. 폴더 선택

• “찾아보기…” 버튼을 눌러 폴더 선택
• 또는 직접 경로 입력 후 Enter

3-2. 검색어 입력

• 검색어 입력 후 Enter
• 또는 “검색” 버튼 클릭

3-3. 확장자 설정

• .conf 기본값
• .json, .txt, *.lang 등 원하는 확장자로 변경 가능

3-4. 옵션

• 하위 폴더 포함

  • 체크 시 os.walk로 모든 하위 폴더까지 검색

• 대/소문자 구분

  • 체크 시 정확히 일치하는 문자열만 검색

3-5. 검색 실행

• “검색” 클릭
• 진행 중에는 “정지” 버튼으로 중단 가능
• 검색 완료 시 상태줄에 개수 표시

3-6. 검색 결과 활용

• 항목 더블클릭 → 해당 파일 기본 프로그램으로 열기

• 우클릭 메뉴

  • 파일 열기
  • 폴더 열기
  • 경로 복사

• Ctrl + C → 선택된 결과 경로 복사

---

4. 전역 단축키 (Global Hotkey)

• 프로그램 창 보이기/숨기기

  • Ctrl + Shift + 8
  • 또는 Ctrl + Num * (Multiply)

• 관리자 권한 필요할 수 있음

• 설정 창에서 기능 켜고 끌 수 있음

---

5. 시스템 트레이 기능

• 프로그램을 닫지 않고 최소화하면 트레이로 이동

• 트레이 아이콘 우클릭 메뉴

  • 열기/복원
  • 숨기기
  • 종료

트레이 기능은 pystray, PIL이 설치되어 있어야 동작함

---

6. 설정 메뉴

“설정” 버튼 → 작은 설정 창 열림

항목

• 프로그램 이름 변경
• 기본 폴더 설정
• Windows 시작 시 자동 실행
• 전역 단축키 켜기/끄기

저장 시 자동으로 settings.json에 반영됩니다.

---

7. 설정 파일 위치

설정값은 아래 경로에 저장됩니다.

%APPDATA%\SearchConfFinder\settings.json

없으면 자동 생성됩니다.

---

8. 자동 실행

• Windows 레지스트리 HKCU\Software\Microsoft\Windows\CurrentVersion\Run 에 등록
• 관리자 권한 필요할 수 있음
• 설정 창에서 켜고 끌 수 있음

---

9. 검색 동작 방식

• os.walk() 또는 os.listdir() 로 파일 탐색

• 패턴 매칭: fnmatch

• 파일 읽기 인코딩

  • "utf-8", "cp949", "euc-kr", "latin-1" 순서로 시도

• 검색어 포함 여부 확인 후 결과 리스트에 추가

• 중간에 오류 발생한 파일은 건너뜀

---

10. 종료 시

• 창을 닫으면 설정 자동 저장
• 검색 스레드, 전역 단축키, 트레이 아이콘 자동 정리