즐겨찾기 위젯

다중 인스턴스 Ctrl+V 추가 드래그 앤 드롭

즐겨찾기 위젯은 자주 쓰는 웹사이트 URL, 폴더, 파일을 카드 형태로 모아두고, 한 번의 클릭으로 열 수 있는 위젯입니다. 여러 인스턴스를 만들어 용도별(“업무 링크”, “개인 링크”, “개발 도구” 등)로 분리할 수 있습니다.

즐겨찾기 위젯 — URL · 폴더 · 파일 카드 — 즐겨찾기 위젯 — 기본 화면

핵심 특징

다중 인스턴스

여러 즐겨찾기 모음을 동시에 띄울 수 있고, 각 인스턴스마다 제목과 항목 목록이 독립됩니다.

3가지 항목 타입

URL(웹사이트), 폴더, 파일을 한 위젯에서 함께 관리합니다.

붙여넣기로 추가

URL이나 파일 경로를 복사한 뒤 위젯에 Ctrl+V를 누르면 자동으로 항목이 만들어집니다.

드래그 앤 드롭

파일/폴더를 위젯 위로 끌어다 놓으면 즐겨찾기로 추가됩니다.

위젯 화면 구성

┌────────────────────────────────────────┐
│ 즐겨찾기      [+] [↻] [☰] [⚙] [×]      │ ← 헤더
├────────────────────────────────────────┤
│  ┌────┐ ┌────┐ ┌────┐ ┌────┐           │
│  │ 🌐 │ │ 📁 │ │ 📄 │ │ ⭐ │   ← 그리드  │
│  │GitHub│ │Docs│ │file│ │star│           │
│  └────┘ └────┘ └────┘ └────┘           │
└────────────────────────────────────────┘

영역	설명
제목	더블클릭으로 인라인 편집 가능
+	새 즐겨찾기 추가 (편집 팝업 열기)
↻	존재하지 않는 파일/폴더 일괄 정리
☰	즐겨찾기 인스턴스 목록 팝업
⚙	위젯 설정 창
×	인스턴스 비활성화 또는 위젯 끄기

항목 타입

타입	입력 예	클릭 시 동작
URL	`https://github.com`	시스템 기본 브라우저로 열림
폴더	`D:/Projects`	Windows 파일 탐색기로 열림
파일	`D:/docs/report.xlsx`	연결된 기본 프로그램으로 열림

각 항목은 자동으로 적절한 아이콘을 가져옵니다.

URL: Google s2 favicon 서비스(https://www.google.com/s2/favicons?domain=...)에서 favicon을 가져옵니다.
파일: 확장자별 SVG 아이콘이 사용자 데이터 폴더의 data/fileext/<ext>.svg에 있으면 그 아이콘을, 없으면 기본 파일 이모지를 표시합니다.
폴더: 폴더 이모지를 사용합니다.

항목 추가하기

세 가지 방법으로 항목을 추가할 수 있습니다.

1. 추가 버튼(+) — 편집 팝업

위젯 헤더의 + 버튼을 클릭하면 즐겨찾기 편집 팝업이 열립니다.
타입(URL / 폴더 / 파일)을 선택합니다.
이름(표시명), URL 또는 경로를 입력합니다.
필요하면 아이콘 이모지를 입력합니다.
저장 버튼을 누르면 위젯에 카드가 추가됩니다.

2. 붙여넣기 (`Ctrl+V`)

위젯 창이 활성화된 상태에서 Ctrl+V 를 누르면 클립보드 내용을 자동 분석하여 즐겨찾기 항목을 만듭니다.

클립보드 내용	결과 타입
`https://...`, `http://...`, `www.` 시작	URL
`C:\...`, `D:\...` 등 드라이브 경로	파일/폴더 (자동 판별)
`\\server\share\...` UNC 경로	파일/폴더
파일 탐색기에서 복사한 파일들	파일/폴더 (여러 개 일괄 추가)

이미 같은 URL/경로가 있으면 중복으로 인식되어 추가되지 않고 기존 카드가 잠시 강조됩니다.

3. 드래그 앤 드롭

Windows 탐색기에서 파일이나 폴더를 위젯 위로 드래그하면 드롭존이 표시되고, 놓으면 즐겨찾기로 추가됩니다. 여러 항목을 동시에 끌어다 놓을 수 있습니다.

항목 사용

동작	결과
좌클릭	URL은 브라우저, 폴더는 탐색기, 파일은 연결 프로그램으로 엽니다
드래그	카드 위치를 이동해 순서를 바꿉니다
우클릭	컨텍스트 메뉴: 편집 / 삭제 / 아이디 복사 / 암호 복사

비밀번호 연동

암호 위젯에 등록된 항목과 URL의 호스트명이 일치하거나, 파일 경로 일부가 일치하면 우클릭 메뉴에서 다음을 사용할 수 있습니다.

아이디 복사: 매칭된 암호의 사용자명을 클립보드에 복사
암호 복사: 매칭된 암호의 비밀번호를 클립보드에 복사

이 기능은 암호 관리 페이지에 등록된 데이터를 기반으로 하며, 위젯 내부에 별도 암호를 저장하지는 않습니다.

존재하지 않는 항목 정리

위젯 헤더의 **정리 버튼(↻)**을 누르면 즐겨찾기 중 실제로는 존재하지 않는 파일/폴더(삭제되었거나 외장 디스크 분리 등)를 일괄 검색하여 제거할 수 있습니다.

정리 대상은 type === 'file' | 'folder'인 항목 중 fs.existsSync(path) === false 인 것입니다.
결과 토스트로 정리된 항목 수가 표시됩니다.
URL 항목은 정리 대상에서 제외됩니다.

다중 인스턴스 (즐겨찾기 목록 팝업)

위젯 헤더의 ☰ 버튼을 누르면 즐겨찾기 목록 팝업이 열립니다. 인스턴스(즐겨찾기 모음) 단위로 ON/OFF 및 추가/삭제를 할 수 있습니다.

+ 새 즐겨찾기 추가로 새 인스턴스를 만듭니다. 빈 위젯 창 하나가 새로 생성됩니다.
각 인스턴스 행의 눈 아이콘으로 활성/비활성을 토글합니다. 비활성 인스턴스는 위젯 창이 닫히지만 항목 데이터는 유지됩니다.
인스턴스 이름은 더블클릭으로 인라인 편집할 수 있습니다.
우측 휴지통 아이콘으로 인스턴스 자체를 삭제할 수 있습니다(소속 항목도 함께 삭제됨).

설정 항목

설정 창에서 다음을 변경할 수 있습니다.

위젯 제목 (헤더 더블클릭으로도 변경 가능)
배경 색상 + 배경 투명도
타이틀 글자색 / 버튼 색상
항목 아이콘 크기 (32 ~ 96px 연속값) — 폰트, 패딩, 그리드 칸 너비가 비례 조정됩니다
모서리 둥글기
창 고정 (드래그 잠금)
Ctrl+V로 아이템 생성 ON/OFF

데이터 저장 위치

즐겨찾기 항목은 FavoritesStoreDB(SQLite)에 저장되며, 인스턴스 메타데이터(제목/활성 여부)는 **QuickAccessInstanceStoreDB**에 저장됩니다.
각 항목은 instanceId로 인스턴스에 귀속됩니다.
정확한 데이터 폴더 위치와 백업 방법은 데이터 백업 가이드를 참고하세요.

자주 묻는 질문

Q. URL을 추가했는데 favicon이 보이지 않아요. A. favicon 조회는 Google s2 서비스를 사용합니다. 인터넷 연결이 없거나 도메인이 favicon을 제공하지 않으면 기본 이모지로 폴백됩니다.

Q. 항목을 다른 인스턴스로 옮길 수 있나요? A. 현재 버전은 항목 이동 UI를 제공하지 않습니다. 편집 팝업에서 새 인스턴스에 다시 추가하거나, 데이터 백업 후 수동 편집이 필요합니다.

Q. 위젯에서 폴더를 열면 매번 새 창이 떠서 불편해요. A. 폴더 열기는 Electron의 shell.openPath()로 동작하며, 시스템 기본 동작을 따릅니다. 기존 탐색기 창이 있으면 OS가 결정한 정책으로 열립니다.

Q. 항목 위에 마우스를 올리면 무엇이 표시되나요? A. 도구 설명(툴팁)으로 전체 URL이나 경로가 표시되어, 카드 표시명이 줄어들어도 원본을 확인할 수 있습니다.