kone
소미소프트
소미소프트

크롬 다운로드 매니지 확장프로그램 만들었음 - 개인이 사용할려고

유틸
30,776 views · 23 points

크롬 다운로드 매니지 확장프로그램 만들었는데 쓰실 사람 사용 ㄱㄱ

( 주 목적 사실상 pawchive.pw 쉽게 다운로드 )

비번 : 국룰

aHR0cHM6Ly90cmFuc2Zlci5pdC90L3dDWFVnUXRGeFRBYQ== (2026,09,16 버그 픽스 재업로드)

1

1

해당 페이지 이미지 가로 크기 지정해서 클롤링 기능 ( 이것도 규칙 정해서 미리 지정 가능 )

(참고 : pawchive.pw 은 800 으로 하니까 왠만한 이미지 다 가져오더라고요…)

1

1

↑↑↑↑↑↑↑↑↑

이런식으로 규칙 정해서 미리 저장 위치 해당 url 지정 할수 있음 매번 선택 없이

설치 방법은 README.md 참고

1

README 읽고도 정 설치 방법을 모르겠다 댓글 ㄱㄱㄱ

(사람들이 REAMD.MD 못 읽으셔서 아래 복사 붙이기함 )

Chrome Downloader Manager

크롬 다운로드를 사이트별 규칙에 따라 원하는 절대경로(다른 드라이브·외장하드 포함)로 자동 저장하는 도구입니다.

  • 툴바 아이콘 클릭 → 다운로드 매니저 사이드 패널(브라우저 오른쪽에 붙어 있어 다른 창에 안 가려짐 · 진행/기록/동작)

    • 사이드 패널 미지원 구버전 크롬에서는 별도 팝업 창으로 열림

  • 열린 페이지 이미지 받기 : 패널 상단 🖼 이 페이지 이미지 또는 페이지에서 우클릭 → 이 페이지 이미지 다운로드 → 썸네일 목록에서 골라 받음 (받을 때 그 페이지 도메인 규칙이 자동 적용)

  • 규칙 설정 → 옵션 페이지(chrome://extensions → 이 확장 → 세부정보 → 확장 프로그램 옵션, 또는 매니저 창의 설정 버튼)

  • extension/ : 크롬 확장 (MV3). 다운로드 가로채기 + 매니저 창 + 옵션 페이지

  • native_host/ : 파이썬 헬퍼. 완료된 파일을 임의 절대경로로 이동 + SQLite 인덱싱 + 탐색기 열기

  • install_host.bat / uninstall_host.bat : 헬퍼 등록 / 해제

헬퍼(네이티브 호스트)를 설치하지 않아도 확장은 동작합니다. 이 경우 규칙이 걸린 다운로드도 절대경로로는 못 옮기고 크롬 기본 다운로드 폴더에 저장됩니다. 규칙에도 안 걸리고 호스트도 안 쓰는 다운로드는 파일명·경로를 전혀 건드리지 않습니다 (다른 확장이 만든 하위폴더 구조 그대로 유지). 단 .jfif 로 저장되는 JPG 는 .jpg 로 보정합니다.


1. 확장 설치

  1. 크롬에서 chrome://extensions 접속

  2. 우측 상단 개발자 모드 켜기

  3. 압축해제된 확장 프로그램을 로드 클릭 → 이 폴더의 extension 폴더 선택

  4. 표시된 확장 ID 를 복사 (예: abcdefghijklmnopabcdefghijklmnop)

2. 헬퍼(절대경로 저장) 설치

  1. 파이썬 3 설치되어 있어야 함 (python --version)

  2. 파일 탐색기에서 install_host.bat 더블클릭

    • "EXTENSION_ID를 입력하세요" 가 나오면 위에서 복사한 확장 ID 붙여넣기

    • 또는 명령창에서 install_host.bat <확장ID>

  3. 크롬을 완전히 종료 후 재실행

  4. 확장 옵션 페이지에서 호스트 연결 테스트 → "연결됨" 이면 완료

해제: uninstall_host.bat 더블클릭

3. 사용

다운로드할 때 (자동)

  • 파일은 규칙대로 자동 저장됩니다 (폴더를 매번 묻지 않음). 저장 위치 = 도메인 규칙 폴더 또는 기본 저장 폴더 (그 폴더에 바로 저장, 하위폴더 없음)

  • 매니저는 사이드 패널로 봅니다. 다운로드가 시작돼도 창이 자동으로 뜨지 않고, 툴바 아이콘 배지(진행 중 수)로만 알립니다. 사이드 패널을 열어두면 그 안에서 진행률이 실시간 갱신됩니다.

    • (구버전 크롬 = 사이드 패널 미지원) 이때만 별도 팝업 창이 세션당 한 번 자동으로 뜹니다. 자동 이어받기로 확장이 스스로 시작한 다운로드는 이 자동 열기를 트리거하지 않습니다

    • 툴바 아이콘을 누르면 사이드 패널이 열립니다 (다시 누르면 닫힘). 사이드 패널은 브라우저에 붙어 있어 다른 창/메뉴에 가려지지 않습니다 — 받는 동안 옆에 계속 띄워두는 용도

    • 아예 끄려면 옵션 페이지의 다운로드 시작 시 다운로드 매니저 창 자동 열기 체크 해제

    • 📌 고정 (팝업 창 우상단, 사이드 패널에는 없음) : 팝업 창을 쓸 때 세션 1회 제한을 무시하고 다운로드가 시작될 때마다 팝업이 자동으로 뜹니다 (닫아도 다음 다운로드에 다시). 사이드 패널은 자동 오픈이 안 돼서(크롬 제약) 이 버튼이 없음

      • 별도 팝업 창을 브라우저 최상단에 계속 고정하는 건 크롬 확장 API 로 불가 → 그 용도는 사이드 패널을 쓰세요

    • 툴바 아이콘 배지 : 창을 안 띄워도 아이콘에 진행 중 다운로드 수가 숫자로 표시됩니다 (0이면 없음)

    • 단축키 : 기본 Alt+Shift+D 로 매니저를 엽니다. 변경은 옵션 페이지의 단축키 변경 버튼 (→ chrome://extensions/shortcuts). 크롬 정책상 단축키는 이 페이지에서만 지정할 수 있습니다

    • 🖼 이 페이지 이미지 (패널 상단) 또는 페이지 우클릭 → 이 페이지 이미지 다운로드

      • 현재 탭의 <img> + 이미지로 연결된 링크를 모아 썸네일 그리드로 보여줍니다 (프레임 포함, 페이지에 나오는 순서 그대로)

      • 이미지로 연결된 <a> 는 원본으로 잡고 그 안의 썸네일 <img> 는 제외합니다 (download 속성이 있으면 그 파일명 사용)

      • 최소 크기 칸에 원하는 픽셀 수를 직접 입력해 작은 이미지를 걸러냅니다 (크기를 알 수 없는 <a> 원본은 필터와 무관하게 항상 표시). 클릭해서 선택 → 받기

      • 번호로 이름 (01.jpg) 체크 시 파일명을 선택 순서(=페이지 순서)대로 01.jpg, 02.jpg … 로 통째로 바꿉니다 (해시 파일명 정렬 문제 해결). 확장자는 원본 유지, 1~9 만 앞에 0(01.jpg), 10 이상은 그대로(100.jpg). 서버가 Content-Disposition 으로 파일명을 강제해도 이 이름이 우선합니다

      • 시작 칸(기본 1)으로 매길 첫 번호를 지정합니다. 이전 게시글이 01~06 이면 다음 게시글은 시작 = 7 로 → 07, 08, 09, 10 이어서 저장. 스캔해도 이 값은 유지되니 다음 갤러리에서 숫자만 올리면 됩니다

      • 하위 폴더명 칸에 이름을 넣으면 규칙 폴더 아래에 그 폴더를 만들어 저장합니다 (예: 규칙 H:\pawchive\Allya + post5 → H:\pawchive\Allya\post5\). 비우면 규칙 폴더에 바로. 호스트 필요

      • 덮어쓰기 체크 시 같은 이름 파일이 있으면 (1), (2) 를 붙이지 않고 그대로 교체합니다 (같은 갤러리를 다시 받을 때). 정확히 같은 이름만 교체하며, 이전에 생긴 01 (1).jpg 류는 안 지웁니다

      • 받는 순간 그 페이지 도메인 규칙이 적용됩니다 (규칙 있으면 지정 폴더로)

      • 스크롤 안 해서 아직 로드 안 된 이미지는 안 잡힘 · 리퍼러 검사하는 이미지는 실패할 수 있음

      • <all_urls> + scripting 권한이 필요해 설치·업데이트 시 "모든 사이트 데이터" 경고가 뜹니다

    • 진행 중: 진행바 + 12.3 / 45.6 MB · 약 30초 남음 + 일시중지 / 계속 / 취소 버튼 (취소하면 목록·크롬 기록에서 사라짐)

    • 완료: 104MB · 14분 전 + 저장 경로. 파일이 없으면 삭제됨 표시

    • 항목별 버튼: 폴더 열기 / 저장 위치 변경 / 기록 삭제

      • 기록 삭제는 목록·크롬 기록에서만 지웁니다. 실제 파일은 그대로 둡니다

      • 저장 위치 변경 : 폴더 입력 + "이 사이트는 앞으로 여기로 (규칙 추가)" 체크 시, 그 다운로드의 페이지 주소로 규칙이 자동 생성됨 (크리에이터별 폴더를 손으로 안 넣어도 됨). 호스트 필요

    • 규칙에 안 걸려 기본 폴더로 간 항목엔 노란 규칙없음 배지

    • 중단됨(NETWORK_FAILED 등) 항목엔 다시 받기 버튼: 이어받기가 되면 이어받고, 안 되면 원본 주소로 새로 받습니다(규칙 재적용). blob: 주소는 이어받기만 가능

    • 네트워크 오류로 중단되면 자동으로 이어받기를 계속 시도합니다(30초 → 1·2·5분 → 이후 10분 간격, 성공할 때까지). "재시도 불가" 오류(권한/404 등)면 멈춥니다. 중단 항목에 자동 다시 받기 7회 처럼 표시. 끄려면 옵션 페이지의 중단되면 자동으로 이어받기 체크 해제

      • 서버가 이어받기를 지원하지 않으면(canResume 불가) 자동은 안 되고, 위의 다시 받기 버튼으로 새로 받아야 함

    • 상단 전체 기록 삭제 : 목록 + 크롬 다운로드 기록(완료/중단분)을 모두 지움 (파일은 안 지움, 2번 클릭 확인)

저장 규칙 설정 (옵션 페이지에서만)

옵션 페이지 여는 법: chrome://extensions → 이 확장 세부정보 → 확장 프로그램 옵션, 또는 다운로드 매니저 창의 설정 버튼.

  • 전체 기본 저장 폴더 : 예) D:\ChromeDL — 규칙 없는 모든 다운로드가 이 폴더에 바로 저장. 경로 직접 입력 또는 찾기 버튼(탐색기 폴더 선택, 호스트 필요)

  • 사이트별 저장 규칙 : 계속 추가하는 방식. "사이트"에 도메인 또는 URL 앞부분을 넣음

    • kone.gg → H:\코네

    • japaneseasmr.com → D:\asmr

    • https://kone.gg/board/ → H:\코네\게시판 (URL 앞부분이 더 길게 맞는 규칙이 우선)

    • 매칭은 페이지 주소(referrer) → 다운로드를 누른 탭 주소 → 파일 URL → 최종 URL 순서로 확인, www. 무시, 서브도메인 포함

      • 리퍼러를 origin(https://site/)만 보내는 사이트(pawchive 등) 때문에 탭 주소도 함께 봅니다 (tabs 권한)

      • 위 4가지로 규칙이 안 맞으면, 이 다운로드와 같은 사이트(리퍼러·파일 URL 의 기준 도메인, 예 pawchive.pw)인 열린 다른 탭(최근 사용 순)을 찾아 그 탭 주소로 규칙을 맞춰봅니다. 이렇게 맞은 항목엔 진단줄에 (다른 탭 기준) 표시. 리퍼러를 https://site/ 로만 보내는 사이트(pawchive)에서 다른 페이지(북마크 등)를 거쳐 받을 때, 해당 게시글 탭이 열려 있으면 경로 규칙까지 맞습니다. 같은 사이트 탭이 하나도 안 열려 있으면 기본 폴더로 갑니다 (그럴 땐 도메인만 넣은 규칙 pawchive.pw 를 폴백으로 추가하세요). 무관한 사이트의 규칙 탭엔 끌려가지 않습니다

      • 네이티브 호스트가 그 순간 응답하지 못하면(연결 지연 등) 규칙이 맞아도 크롬 다운로드 폴더로 갑니다. 한 번 응답한 뒤 60초간은 재확인 없이 신뢰하고, 실패는 캐시하지 않아 다음 다운로드는 정상 시도합니다

  • 경로 미리보기 (옵션 페이지) : 샘플 URL·파일명으로 실제 저장 위치 확인

  • 내보내기 / 가져오기 (규칙 표 아래) : 현재 설정을 chrome-downloader-rules.json 으로 저장 / 다시 불러오기. 가져오면 화면에만 채워지고 [저장] 을 눌러야 실제 적용 (다른 PC 이전·백업에 사용)

  • 임시 폴더 정리 (기본 동작 영역) : 이동 실패·취소로 ...\Downloads\__cdm__\ 에 남은 10분 이상 지난 조각 파일 삭제

  • 완료 알림 : 진행 중인 다운로드가 모두 끝나면 데스크톱 알림 (기본 꺼짐, 옵션에서 켜기)

  • 크롬 기본 다운로드 표시줄/알림 창 사용 : 끄면(기본값) 크롬이 다운로드 때 띄우는 흰색 "다운로드" 알림 창이 브라우저 전체에서 안 뜹니다 (이 확장 매니저 창만 사용). downloads.ui 권한, chrome.downloads.setUiOptions 사용. 이 설정은 크롬을 재시작할 때마다 확장이 자동으로 다시 적용합니다

  • 하위폴더(도메인/확장자)는 만들지 않음. 파일은 지정 폴더에 그대로 저장

저장 경로/규칙은 언제든지 바꿀 수 있고 다음 다운로드부터 즉시 반영됩니다.

예시 결과:

D:\ChromeDL\clip.mp4
E:\pixiv\illust_123.png

동작 방식 메모

  • onDeterminingFilename 에서 규칙대로 경로 계산 후 바로 저장 (프롬프트 없음)

  • 툴바 아이콘 → 사이드 패널(chrome.sidePanel, side_panel.default_path = panel.html). setPanelBehavior({openPanelOnActionClick:true}) 로 아이콘 클릭 = 패널 토글. 구버전은 chrome.action.onClicked → 팝업 창 폴백. 팝업(popup.html) 없음

    • 사이드 패널은 chrome.sidePanel.open() 이 사용자 제스처를 요구해 다운로드 시작 시 자동 오픈은 불가 → 자동 열기/고정은 팝업 창 경로에서만 동작. 사이드 패널 안에서는 고정 버튼 숨김(chrome.tabs.getCurrent()가 탭을 안 줌으로 판별)

  • commands.open-manager(기본 Alt+Shift+D) → chrome.commands.onCommand 는 제스처로 취급되어 sidePanel.open({windowId}) 가능. 미지원/실패 시 팝업 창. 단축키 바인딩은 확장이 못 하고 chrome://extensions/shortcuts 에서만 (옵션 페이지에 이동 버튼)

  • chrome.downloads.onCreated 에서 panel.html 창을 자동 오픈(세션당 1회). 이미 열려 있으면 아무 동작 안 함(포커스도 안 뺏음). 창 존재 여부는 windows.getAll 로 확인해 SW 재시작 시 중복 방지

    • 자동 이어받기/다시 받기로 확장이 만든 다운로드는 markSelfDownload() 로 표시해 자동 오픈 트리거에서 제외(15초 창). SW 시작 시 sweepInterrupted 가 만료 URL 을 재시도해도 창이 뜨지 않음

  • 헬퍼 모드: 크롬이 파일을 다운로드\__cdm__\ 에 잠깐 받은 뒤, 완료되면 헬퍼가 목표 절대경로로 이동

  • 폴백 모드(헬퍼 없음): 크롬 기본 다운로드 폴더에 그대로 저장 (지정 폴더 무시)

  • 헬퍼 통신은 영속 포트(connectNative) 로 파이썬 1개를 계속 유지 (호출마다 새로 실행하지 않음 → 느린 PC 에서도 안정적)

  • 이동이 실패하면 파일이 __cdm__ 에 남고 매니저 창에 이동대기 뱃지 + 다시 이동 버튼 표시. 헬퍼가 (재)연결되면 자동으로 재시도하고, 상단 이동 재시도 버튼으로 수동 재시도도 가능

  • 다운로드가 네트워크 오류로 중단되면 chrome.alarms 로 backoff(0.5→10분) 예약 후 downloads.resume 자동 재시도. RESUME_MAX=0 이라 성공/재시도불가 오류/canResume 상실 전까지 무제한. 시도 횟수는 storage.session resumeTries (크롬 재시작 시 초기화). alarms 권한 필요

  • 매니저 창은 800ms 간격 폴링으로 진행률 갱신

  • 페이지 이미지 긁기: chrome.scripting.executeScript({allFrames:true, func}) 로 <img>(currentSrc)+이미지 링크 수집. 우클릭 메뉴는 스캔 결과를 storage.session.pageImages 에 넣고 sidePanel.open + pendingScan 브로드캐스트. 받을 때 page:downloadImages 가 scrapeSource={url,at} 를 세팅 → planFor 가 30초간 이 URL 을 규칙 후보에 포함해 자동 라우팅. <all_urls>+scripting 권한 필요

  • 확장 ID가 바뀌면(다른 PC / 폴더 이동 등) install_host.bat 을 새 ID로 다시 실행하고 크롬을 재시작해야 함

다른 PC 로 옮길 때

  1. 파이썬 3 설치

  2. extension/ 을 압축해제된 확장으로 로드 → 그 PC 의 새 확장 ID 확인 (PC마다 다름)

  3. install_host.bat <새 ID> 실행 → 크롬 완전 종료 후 재시작

  4. 옵션 페이지에서 호스트 연결 테스트 → 연결됨 확인

  5. 기본 저장 폴더 / 사이트별 규칙 다시 입력 (설정은 크롬 프로필에 저장되어 파일로 따라가지 않음)

    • 옮기기 전 옵션 페이지에서 내보내기 → 새 PC 옵션 페이지에서 가져오기 → 저장 하면 규칙을 그대로 옮길 수 있음

  6. 옮길 때 제외: native_host/com.chrome_downloader.host.json, run_host.bat, cdm_index.db, cdm_host.log, __pycache__/ (설치 시 그 PC 기준으로 다시 생성됨)


호스트 연결 잘 못하시는분들을 위해서

“install_host.bat “ 에 아래 id 를 입력하는겁니다.

1

23
24 comments
👍
혹 압축 파일로 저장하려면 어케해야되나요??
이미지 있는 zip 말씀하시는건가요 ?? zip파일 다운로드 되는건 pawchive.pw 에 첨부파일 다운받는겁니다.
혹시 본인이 키오스크 다운로드 만드심?
혹시나 본인이 만든거면 이거 혹시 고려 가능함? 1. 일괄 시작, 일괄 일시정지, 일괄 삭제 기능 필요함 2. 링크 일괄로 넣을 수 있는 기능 추가 3. 링크 넣을 시에 바로 시작이 아니라 일시정지 상태로 있는게 좋을듯 4. 다운로드 여러개 켜두면 생각보다 자주 오류 뜸, 이때는 일시정지+재다운은 잘 안먹혀서 아예 끄고 다시 켜면 작동함
2번 항에서 install_host.bat이 안 보이는대 어디서 찾나요
???? 압축해제 하면 바로 보입니다. 제가 잘못 올린줄 알았는데 확인해보니까 있는데요????
측면 패널 오른 쪽에서 나오는데 뭘 잘못건들였는지 왼쪽에 패널 보이네요... 그리고 호스트 없음은 엌케..하는지
패널 위치는 >크롬 설정 측면 패널 위치 > Chrome 패널 호스트는 readme 끝까지 읽기 ( 4번 )
와 이미지 크롤링 진짜 필요했는데 고맙습니다.
README 누르면 https://dealsbe.com 사이트 나오는데 정상인가요?
사이트에서 눌르는게 아니라 압축해제 후 메모장이나 따로 에디터 같은데서 읽으시면 됩니다.
[deleted] (edited )

Deleted comment.

(edited )
압축해제된 확장 프로그램을 로드 클릭 → 이 폴더의 extension 폴더 선택 하고나면 확장프로그램 오류로 나오는데 왜 이럴까요? Unchecked runtime.lastError: Access to the specified native messaging host is forbidden. Unchecked runtime.lastError: Error when communicating with the native messaging host. 그리고 호스트 연결테스트 하면 실패 : 호스트 연결 끊김으로 나오네요 ㅜㅜ 혹시 파일경로에 한글 있으면 안되나요?
제가 게시글에 방금 수정했는데 맨 아래 꺼 입력하는겁니다.
[deleted] (edited )

Deleted comment.

All
Title
Body