설정 참조

FlowPick은 풍부한 설정 옵션을 제공하며, 다운로드 동작, 필터 규칙, 저장 전랽, 인터페이스 선호를 포괄합니다. 본 문서는 각 설정 항목의 역할, 기본값, 적용 시나리오를 일일이 설명합니다.

빠른 참조

설정 진입점

설정은 두 개의 계층으로 나뉘며, 서로 다른 사용 시나리오에 적합합니다:

저장 및 동기화:

• 확장 설정은 chrome.storage.sync에 저장되며, Chrome 계정 로그인 후 다른 장치에 자동 동기화
• 다운로드 패널 설정은 현재 탭 세션에만 존재하며, 페이지 새로고칭 후 기본값으로 복원
• 저장 디렉토리 이름은 localStorage의 flowpick_save_dir_name 키에 캐시되며, 장치 간 동기화되지 않음

다운로드 설정

병렬 스레드 수

동시 다운로드 세그먼트 수를 제어합니다. 더 높은 병렬 수는 다운로드 속도를 향상시킬 수 있지만, 네트워크 대역폭 점유와 브라우저 메모리 압력도 증가시킵니다.

선택 가이드:

실제 병렬 수는 세그먼트 총수를 초과하지 않습니다. 예를 들어 세그먼트가 3개만 있는 경우, 8로 설정해도 3개의 다운로드 작업만 시작됩니다.

출력 포맷

스트리밍 세그먼트 병합 후의 출력 컨테이너 포맷입니다.

선택 가이드:

• 최대 호환성 필요(플레이어, 편집 소프트웨어, 타인과 공유) → MP4 선택
• 가장 빠른 병합 속도 추구, 추후 다른 도구로 트랜스코딩 → TS 선택
• 원본 스트림이 이미 TS 컨테이너이고 이차 처리 불필요 → TS 선택

MP4 출력 시, FlowPick은 자동으로 -movflags +faststart 플래그를 추가하여 moov atom을 앞쪽에 배치하고, 비디오가 다운로드 완료 전부터 재생을 시작할 수 있게 합니다(점진식 다운로드 시나리오에 적합).

저장 디렉토리

FlowPick은 두 가지 파일 저장 전략을 지원합니다:

전략 1: 브라우저 기본 다운로드 디렉토리

저장 디렉토리를 설정하지 않으면, 모든 파일은 브라우저의 Downloads API를 통해 시스템 기본 다운로드 폴더에 저장됩니다. 매번 다운로드 시 추가 확인 없음.

전략 2: 사용자 정의 저장 디렉토리(File System Access API)

다운로드 패널에서 "저장 디렉토리 선택" 버튼 클릭 후 폴더 권한 부여하면, 이후 모든 다운로드는 해당 디렉토리에 직접 기록되며 저장 대화상자가 더 이상 표시되지 않습니다.

디렉토리 권한 설명:

• 권한 상태는 navigator.permissions.query()로 무음 체크하며, 반복 팝업 발생하지 않음
• 권한이 취소된 경우(사용자가 시스템 설정에서 수동 제거), FlowPick은 자동으로 팝업 모드로 다운그레이드
• 디렉토리 이름은 localStorage의 flowpick_save_dir_name 키에 캐시되며, UI 표시에만 사용
• 사용자 정의 디렉토리는 장치 간 동기화를 지원하지 않으며, 각 장치별로 별도 권한 부여 필요

파일명

다운로드 파일의 명명 규칙:

• 기본적으로 비디오 페이지 제목 또는 스트림 URL의 파일명 부분 사용
• 수동 편집 지원, 다운로드 패널의 파일명 입력창에서 수정
• 특수 문자(\/:*?"<>|)는 자동으로 밑줄로 교체
• 대상 디렉토리에 동일한 이름의 파일이 이미 존재하면, 브라우저가 자동으로 순번 접미사 추가(video (1).mp4 등)

필터 설정

자동 감지

확장이 페이지 로드 시 자동으로 미디어 리소스를 스캔할지 여부를 제어합니다.

자동 감지를 켜면 페이지 로드 시 CPU 점유율이 약간 증가하지만, 일반적으로 무시할 수 있는 수준입니다.

최소 파일 크기

지정된 임계값보다 작은 리소스를 필터링하여, 광고 조각, 썸네일, 플레이홀더 이미지를 건너뜁니다.

전형적인 시나리오:

유형별 필터링

팝업 창에서 미디어 유형별로 표시 결과 필터링:

길이별 필터링

비디오 및 오디오 리소스에만 적용됩니다. 최소 길이를 설정하여 매우 짧은 조각을 필터링할 수 있습니다.

인터페이스 설정

테마 모드

기본값은 시스템 선호를 따릅니다. 설정은 chrome.storage.sync에 저장되며, 계정과 함께 동기화됩니다.

알림

다운로드 완료 후 데스크탑 알림 동작 제어:

알림은 브라우저의 Notifications API를 사용하며, 처음 사용 시 권한을 요청합니다. 알림 권한을 거부한 경우, 브라우저 설정에서 다시 활성화할 수 있습니다.

고급 설정

화질 선택 전략

적응형 스트림(HLS Master Playlist / DASH MPD)의 경우, FlowPick은 두 가지 화질 선택 방식을 제공합니다:

화질 목록은 비트레이트 높은 순서로 정렬되며, 표시 형식은: 1080p · 5.2 Mbps · avc1.640028.

재시도 전략

세그먼트 다운로드 실패 시 자동 재시도 메커니즘:

재시도는 네트워크 레벨의 일시적인 장애(타임아웃, 연결 리셋)에만 적용됩니다. HTTP 4xx 오류(403, 404 등)는 재시도를 트리거하지 않으며, 즉시 오류를 보고합니다.

메모리 안전 제한

브라우저가 메모리 부족으로 크래시하는 것을 방지하기 위해, FlowPick은 내장 메모리 보호 메커니즘을 갖추고 있습니다:

예상 파일 크기가 Blob 상한을 초과할 경우, FlowPick은 File System Access API 또는 StreamSaver 스트리밍 쓰기를 강제로 요청하여 전체 파일을 메모리에 로드하는 것을 방지합니다.

세그먼트 크기 예측

다운로드 시작 전, FlowPick은 샘플링으로 총 파일 크기를 예측합니다:

• 샘플링 수량: min(5, max(1, totalSegments × 0.1))
• 예측 공식: avgSampleSize × totalSegments
• 스트리밍 쓰기 모드 활성화 여부 판단에 사용

시나리오별 설정 방안

서로 다른 사용 시나리오에 따라, 다음 설정 조합을 권장합니다:

일상 비디오 다운로드

대부분 사용자에게 적합한 기본 설정:

대용량/생중계 녹화

5GB 초과 생중계 녹화 또는 장시간 비디오 다운로드:

갤러리 일괄 다운로드

갤러리 웹사이트에서 이미지 일괄 다운로드:

팟캐스트/오디오 다운로드

팟캐스트 프로그램 또는 오디오 파일 다운로드:

모바일 핫스팟/데이터 절약

모바일 핫스팟 또는 데이터 제한 환경에서:

설정 초기화

모든 설정을 기본값으로 복원하려면:

1. 확장 팝업 창 열기
2. 톱니바퀴 아이콘 클릭하여 설정 진입
3. 모든 데이터 삭제 클릭
4. 작업 확인

이 작업은 다음을 삭제합니다:

• chrome.storage.sync의 모든 확장 설정
• localStorage에 캐시된 저장 디렉토리 이름
• 필터 프리셋 및 테마 선호

영향 받지 않는 데이터:

• 브라우저 다운로드 기록
• 로컬에 다운로드된 파일
• 확장 자체(제거되지 않음)

관련 문서

• 설치 가이드 — 확장 설치 및 초기 설정
• 사용 방법 — 일상 사용 작업 가이드
• 포맷 변환 — 출력 포맷의 상세 기술 설명
• 비디오 스니핑 — 미디어 감지 원리 및 암호화 처리
• 다운로드 엔진 아키텍처 — 병렬 제어, 재시도 전략, 메모리 관리
• 브라우저 호환성 — 각 브라우저 API 지원 및 다운그레이드 전략
• 일반적인 문제 해결 — 설정 관련 문제의 진단 방법
• 알려진 제한 — 리무싱 vs 트랜스코딩의 차이
• 사용 시나리오 — 시나리오별 설정 방안
• 개인정보 보호와 보안 — 자동 감지 및 개인정보 설명