방주정리기 (파일명정리 프로그램) v1.16 (26.04.04)

방주정리기 v1.16

용도: 코드명으로만되어있는 파일들을 감지하여 사용자가 지정한 형식으로 제정리하는 프로그램

감지된 코드를 기반으로 dl사이트에서 정보를 가져와 게임명 서클 태그등으로 파일명을 지정이가능

(검출가능한 코드 : RJ코드시리즈, dmm동인게임코드,스팀코드,겟츄비주얼노벨코드,vndb v코드)

대방주시절에 엄청 받아놓고 정리하려니 막막해서 내가쓸려고만들었는데 이것저것 기능붙이는 재미에 오래걸렸음...

그냥 잡다기능이 많긴한데 제일 기본적인 정리기능정도만 제대로 돌아간다고 보고 사용해주심댈듯 ai도움받아 작성해서 내환경에서 재현이

안되는 오류는 나도 도움을 줄수가없을거같음

아마 버전업도 따로 더없을듯

혹시나 1.16버전이 실행이 안되면 1.0 버전으로 실행해보면 될듯

두버전의 정보수집방식에 큰차이가 있어서 장단점이 있음

---------------------------------------------------------------------------------

사용법

주의사항

한번에 많은파일변환은 프리징올수있음

아래 사용법에 적힌 파이썬패키지 설치필요할수있음

메인화면

기본적으로 UI에적힌 번호순대로 설정해나가면됨

1.정리할 코드가적힌 게임폴더를 지정후 (폴더 드래그앤드롭가능)

2.원하는 파일명형식을 지정

3. 코드감지버튼을 누르면

(테스트용 파일명들)

타게임추가감지를 체크하지 않으면 기본적으로 DL사이트의 RJ코드류감지만함 체크를하게되면

dmm 스팀 겟츄 vdb 코드를 추가로감지함 왜 이렇게 따로빼놧냐면 그렇게 완벽하진 않기때문임... 그냥 이런기능도 있다정도로 넘어가주심됨

4.미리보기기능으로 어떻게변환될지 확인후 변환하기누르면 확정됨

상세정보칸에서 게임의 태그와 별점등 정보를 확인후 변환가능

여기까지가 기본적인 사용법

타게임 추가감지는 불완전한 기능이라 파일명 직접변경도 가능하게 해두었음

해당 코드 클릭후 사이트로 이동버튼을 누르면 해당코드에 맞는 페이지로 이동하고 누르지않고 사이트로이동버튼을 누르면 홈페이지로 이동하니 주의

---------------------------------------------------------------------------------

추가기능안내

파일명번역기능

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

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

코드만 출력기능 (txt)

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

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

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

사용자태그기능

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

필터검색기능

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

사용법 전체

# 방주정리기 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

파이썬 모듈 설치하기
전자 우편, distutils-sig@python.org,. 널리 사용되는 공개 소스 개발 프로젝트로서, 파이썬에는 적극적으로 지원하는 기여자와 사용자의 커뮤니티가 있어, 자신들의 소프트웨어를 공개 소스 라이센스 계약에 따라 다른 파이썬 개발자가 사용할 수 있도록 합니다. 이를 통해 파이썬 사용자는 효과적으로 공유하고 공동 작업할 수 있으며, 다른 사...

## 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. 설정에서 **파일명 자동번역**을 체크하거나 **전체 파일명 번역** 버튼을 누르면 번역 기능이 작동합니다.

1.15b에 추가된기능