파일명번역기능

1

기본 기계번역설정되어있음 등록작업필요x
혹시나 번역퀄을 올리고싶은사람들은 api발급받아서 제미니나 딥플사용하면됨 구글번역같은경우 한번에 15개정도의 파일만 처리가능함
제거한다는걸까먹은 이지트렌스는 사용이불가능함(기능추가 안되어있음) 아마 추가안할듯....



엑셀파일(.xlsx)로의 출력기능

1

코드만 출력기능 (txt)

1

정보편집기능 (캐시등록)

1

기존 데이터베이스 캐시등록기능

1

엑셀파일(.xlsx)로된 db파일을 등록가능 코드.이미지확장자 로된 썸네일폴더등록가능




사용자태그기능

1

파일명형식에 집어넣어 추가정리가 가능




필터검색기능

1

위에서 등록한 사용자태그로도 검색가능

# 방주정리기 v1.16 사용법
제작자 알비노


주의사항
*최초배포처 [*소미 코네, *404 아카라이브채널] 이외의 배포자와 이외의 배포처에서 받으시는분께서는 변조파일에 주의해주세요.*

** 각 사이트의 국가제한 게시물과 DLsite의 ai사용게시물은 VPN을 사용해야 제대로 정보수집이 될수있습니다. **
*** 한번의 다량의 파일처리는 프로그램이 멈출수있습니다 ***



--

업데이트 내역(v1.16)
* ** 신규 태그 추가: [버전], [원본괄호], [기존제목]
* ** 코드 마스킹 로직 개선: RJ 오타(거, 꺼 등) 및 플랫폼 접두어(Steam 등) 파편 제거
* ** 내부 로직 안정화 및 버그 수정

업데이트 내역(v1.15b)
* ** 파일삭제기능 추가
* ** 중복파일 모아두기/되돌리기 기능 추가
* ** 몇가지 실행관련버그수정

업데이트 내역(v1.14)
* ** 변환/미리보기 시도시 프리징현상 개선
* ** 우선언어 적용순서 변경(한일영중) 외 버그수정
---
## 1. 프로그램 소개

이 프로그램은 지정된 폴더 내의 파일들에서 작품 코드(DLSite, VNDB 등)를 자동으로 감지하고, 해당 코드에 맞는 작품 정보를 각 사이트에서 가져와 파일명을 깔끔하게 정리해주는 도구입니다.
*DLsite*이외의 사이트는 곁다리지원에 까까우므로 프로그램이 지원하는기능이 제대로기능하지 않을수있으니 양해바랍니다

## 2. 설치 안내

이 프로그램은 별도의 설치가 필요 없는 포터블 실행 파일(exe) 입니다만 기능사용을 위해 파이썬패키지를 설치하셔야 정상실행될수있습니다.


* 사용된 패키지
PyQt6
requests
cloudscraper
beautifulsoup4
openpyxl
selenium
webdriver-manager
deep_translator
flask
flask-cors
psutil
google-generativeai
curl-cffi

* 설치방법
실행-> cmd -> 아래명령어 입력후 엔터
pip install 패키지이름

상세설치가이드 : https://docs.python.org/ko/3.13/installing/index.html

## 3. 화면 구성 및 기능 안내

### 1. 폴더 선택

* **폴더 추가 / 드래그 앤 드롭**: '폴더 추가' 버튼으로 정리할 폴더를 목록에 추가하거나, 탐색기에서 폴더를 창으로 직접 끌어와 추가할 수 있습니다.
* **선택 초기화**: 추가된 모든 폴더 목록을 지웁니다.
* **코드 감지**: 선택된 폴더들 안에서 코드가 포함된 파일들을 찾아 아래의 "감지된 파일 목록"에 표시합니다.
* **하위 폴더 포함**: 체크하면, 선택한 폴더뿐만 아니라 그 안의 모든 하위 폴더까지 검색합니다.
* **타게임 추가감지**: DLSite 코드 외에 **Steam, Getchu, FANZA, VNDB** 코드를 추가로 감지하려면 이 옵션을 체크하세요.

### 2. 설정

* **파일명 형식**: 파일명이 변경될 규칙을 정합니다. 아래의 키워드를 조합하여 원하는 형식을 만들 수 있습니다.
**중괄호 `{}`나 대괄호 `[]` 없이 키워드만 입력해도 작동합니다.**
예시: `[아티스트] {제목} [{코드}] [사용자태그]`

**사용 가능한 키워드:**
- **기본 정보**: `코드`, `제목`, `아티스트`, `출시일`, `연령지정`, `언어`, `평점`, `판매수`, `별점`, `리뷰 수`
- **VNDB 정보**: `플레이 시간`, `배급사`, `관련 작품`, `관련 아니메`
- **작품/장르 (인덱싱 가능)**: `작품형식`, `장르`
- **사용자 태그**: `사용자태그` (직접 추가한 모든 태그를 표시)
- **상세 정보**: `시리즈명`, `시나리오`, `일러스트`, `성우`, `파일형식`, `파일용량`, `페이지수`, `갱신 정보`, `동작 환경`, `기타`

**인덱싱 사용법 (작품형식, 장르 등 여러 값을 갖는 경우):**
키워드 뒤에 `:숫자`를 붙이면 해당 순서의 값만 가져옵니다.
- `장르:1`: 첫 번째 장르만 표시
- `장르`: 모든 장르를 쉼표로 구분하여 표시

**포맷 버튼 활용:**
- **포맷 추가**: `제목`, `서클`, `사용자태그` 등 사용 가능한 키워드 목록을 보여줍니다. 메뉴에서 키워드를 클릭하면 해당 키워드가 입력창의 커서 위치에 추가됩니다.
- **[ ]**: 입력창에서 텍스트를 드래그하여 선택한 상태로 이 버튼을 누르면, 선택된 텍스트 양쪽에 대괄호 `[]`가 추가됩니다.

* **우선 언어**: DLSite에서 정보를 가져올 때, 어떤 언어의 페이지를 우선적으로 사용할지 선택합니다.
* **추가 상세정보포함 (느려짐)**: 체크하면 출시일, 장르 외에 성우, 시나리오 등 더 자세한 정보를 가져옵니다. 처리 속도가 느려질 수 있습니다.
* **한글제목 남기기**: 체크하면, 파일명 변경 시 원래 파일명에 있던 한글을 맨 앞에 덧붙여줍니다.
* **파일명 자동번역**: 체크하면, "전체 미리보기" 시 일본어 제목을 한국어로 자동 번역하여 파일명을 생성합니다. (번역 서비스 설정 필요)
* **셀레니움 사용**: 체크하면, 일반적인 방법으로 정보를 가져오지 못할 때 정보를 다시 수집합니다. 매우 강력하지만, 처리 속도가 매우 느려지므로 꼭 필요할 때만 사용하세요.
* **캐싱사용**: 체크하면 한번 변환(미리보기) 했던 코드는 저장되어 빠르게 불러올수있습니다. 정보가 없거나 부실한 항목은 미리보기 시 자동으로 웹에서 정보를 가져와 캐시를 갱신합니다.

### 3. 감지된 파일 목록

* **필터**: 목록 상단의 입력창에 키워드를 입력하여 파일 목록을 실시간으로 필터링할 수 있습니다.
- `RPG`: 'RPG'가 포함된 모든 파일 표시 (제목, 장르, 태그 등 모든 정보 대상)
- `-NTR`: 'NTR'이 포함된 모든 파일 숨김
- `RPG -NTR`: 'RPG'는 포함하고 'NTR'은 포함하지 않는 파일 표시

### 4. 상세 정보

* **정보 편집**: 버튼을 누르면 제목, 서클 등 선택된 파일의 주요 정보를 직접 수정하는 창이 열립니다. 수정한 내용은 캐시에 영구 저장됩니다.
* **사용자 태그 추가**: 버튼을 누르면 현재 선택된 파일(들)에 사용자 정의 태그를 추가하는 창이 열립니다. 쉼표(,)로 여러 태그를 한 번에 추가할 수 있습니다.

### 5. 버튼 기능

* **사용법**: 현재 보고 계신 이 사용법 안내 창을 엽니다.
* **설정 저장**: 현재 설정을 파일에 저장하여, 다음에 프로그램을 실행할 때 그대로 불러옵니다.
* **API 관리**: 번역 기능에 필요한 API 키를 입력하고, 사용할 번역 서비스를 선택하는 창을 엽니다.
* **전체 미리보기 / 미리보기 취소**: 현재 설정을 바탕으로 파일명이 어떻게 변경될지 미리 보여줍니다. 실제 파일명은 바뀌지 않습니다.
* **전체 변환**: "전체 미리보기"에 표시된 내용대로 실제 파일명을 모두 변경합니다. (*이 작업은 되돌릴 수 없으니 신중하게 사용하세요!*)
* **기존 DB 가져오기**: 엑셀 파일(.xlsx)로 저장된 DB를 캐시로 가져옵니다.
* **중복 검사**: 버튼 클릭 시 나타나는 메뉴에서 검사 방식을 선택합니다.
- **코드 중복 검사**: 동일한 작품 코드를 가진 파일을 찾아 노란색으로 강조합니다.
- **파일 내용 중복 검사 (느림)**: 파일 내용을 직접 비교하여 완전히 동일한 파일을 찾아 각 그룹별로 다른 색상으로 강조합니다.
- **중복 강조 취소**: 모든 강조 표시를 제거합니다.
* **DL사이트로 / getchu로 등**: 파일 목록에서 항목을 선택한 상태에서 누르면, 해당 작품의 공식 페이지가 웹 브라우저에서 열립니다.

### 6. 파일 목록 우클릭 메뉴

* **정보 편집**: 선택한 파일의 상세 정보를 직접 수정합니다.
* **사용자 태그 추가**: 선택한 모든 파일에 태그를 한 번에 추가합니다.
* **저장된폴더로 이동**: 선택한 파일이 실제 저장된 폴더를 엽니다.
* (기타 미리보기, 변환 등 기본 기능 포함)

## 7. 번역 기능 사용법
* 이프로그램은 따로 api키 발급법을 안내하지않습니다 따로 구글에 검색하여 발급받아주시기바랍니다.

1. **API 관리** 버튼을 누릅니다.
2. 사용할 번역 서비스를 선택합니다. (예: 구글번역, DeepL API)
3. 선택한 서비스에 맞는 API 키를 입력하고 "저장" 버튼을 누릅니다.
4. 설정에서 **파일명 자동번역**을 체크하거나 **전체 파일명 번역** 버튼을 누르면 번역 기능이 작동합니다.