T툴박스
WINDOWS DESKTOP UTILITY

툴박스
다운로드 및 사용 안내

이미지·음원 변환, 파일명 정리, 프롬프트 편집과 R2 업로드를 지원하는 Windows용 작업 도구입니다.

Windows 64비트 · 최신 버전 확인 중

서버에서 최신 버전을 확인하고 있습니다.

툴박스툴박스 · 홈프로그램 화면
툴박스 홈 화면. 파일명 변경, 음원 PNG, WebP 변환, 와일드카드 편집 등 여덟 가지 도구가 배치되어 있습니다.

01 — 기능 안내

주요 기능

각 기능은 프로그램의 전체 메뉴에서 선택할 수 있습니다.

파일명 변경

순차 번호와 규칙으로 파일명을 한 번에 정리합니다. 바뀔 이름을 미리 보고 적용하세요.

변경 전후 미리보기

음원 → PNG

MP3·WAV 원본과 제목을 ELD2 PNG에 담습니다. 제목과 순서를 편집하고 결과를 검증할 수 있습니다.

ELD2 패킹

PNG → WebP

PNG를 WebP로 변환하고 EXIF를 제거합니다. 무손실·품질 설정과 하위 폴더 구조 보존을 지원합니다.

폴더 드래그 지원

와일드카드 편집기

폴더의 TXT 파일을 열어 바로 편집합니다. 자동저장과 외부 변경 감지로 편집 흐름을 이어갑니다.

TXT 자동저장

이미지 프롬 문법 변환기

ComfyUI와 NAI의 가중치 문법을 변환합니다. 주석·와일드카드·공백 처리 옵션을 선택하세요.

ComfyUI ↔ NAI

NAIS 씬 JSON 생성기

캐릭터와 씬 템플릿을 편집해 JSON을 만듭니다. 생성 결과를 복사하거나 파일로 저장하세요.

템플릿 기반 생성

클라우드 파일 관리

R2 버킷의 파일을 탐색하고 미리 봅니다. 업로드·다운로드·이름 변경·삭제를 한 화면에서 처리합니다.

R2 연결 필요

AWS로 업로드

로컬 폴더와 하위 파일을 R2로 업로드합니다. WebP 변환 결과에서 업로드 화면으로 이어갈 수 있습니다.

폴더 단위 전송

02 — 설치 및 설정

설치 및 기본 사용

처음 설치하는 경우와 기존 사용자 업데이트 방법을 안내합니다.

01

설치파일 받기

위의 다운로드 버튼으로 Windows 64비트 설치파일을 받으세요.

02

설치 위치 선택하기

다운로드한 EXE를 실행하고 설치 위치를 선택합니다. 설치 후 바탕화면 바로가기로 실행하세요.

03

전체 메뉴에서 도구 열기

상단 왼쪽 전체 메뉴에서 도구를 선택하고 파일이나 폴더를 불러오세요.

기존 사용자 업데이트

전체 메뉴 → 업데이트 확인 → 업데이트 보기에서 변경 내역을 읽고 다운로드합니다. 다운로드가 끝나면 작업을 마친 뒤 재시작하고 설치를 선택하세요.

앱 시작 시 자동 확인이나 자동 설치는 하지 않습니다. 업데이트 메뉴가 없는 구버전은 위 설치파일을 받아 설치하세요.

클라우드 기능을 사용한다면

전체 메뉴 → 클라우드 플레어 설정에서 본인의 R2 엔드포인트와 S3 인증 키를 등록하세요. 파일 관리에서 버킷과 공개 URL을 설정할 수 있습니다.

앱 다운로드와 로컬 도구 사용에는 R2 인증 정보가 필요하지 않습니다. 클라우드 이용에는 본인의 계정과 연결 설정이 필요합니다.

API 인증 및 연결

Cloudflare R2 연결 설정

파일 관리와 R2 업로드를 위한 설정입니다.
로컬 변환·편집에는 API 키가 필요 없습니다.

파일 전송에 필요

R2 S3 인증 키

Access Key ID + Secret Access Key
버킷의 파일을 읽고 업로드할 때 사용합니다.

캐시 초기화 시 선택

캐시 초기화용 API 토큰

Cache Purge 권한이 있는 토큰
같은 URL의 파일을 교체한 뒤 캐시를 비울 때 사용합니다.

  1. Cloudflare에서 R2 버킷 준비하기

    Cloudflare 대시보드 ↗에 로그인하고 Storage & databases → R2 → Overview를 엽니다. R2를 처음 사용한다면 활성화를 마친 뒤 Create bucket으로 파일을 담을 버킷을 만드세요. 이미 있는 버킷도 사용할 수 있습니다.

  2. R2 전용 키 발급하기

    R2 Overview의 Account Details → API Tokens → Manage로 들어갑니다. 본인 계정에서 가능한 Create Account API token 또는 Create User API token을 선택하세요.

    권한은 Object Read & Write, 대상은 Apply to specific buckets only로 설정하고 사용할 버킷을 지정합니다. 만든 뒤 표시되는 Access Key IDSecret Access Key를 보관하세요. Secret Access Key는 이 화면을 떠나면 다시 볼 수 없습니다.

    공식 문서: R2 인증 키 발급 ↗

  3. 툴박스의 공통 설정에 입력하기

    앱에서 전체 메뉴 → 클라우드 플레어 설정을 열고, 발급 화면에서 복사한 값을 같은 이름의 칸에 넣습니다.

    Account ID
    Cloudflare 계정 ID. 앱에서 엔드포인트와 자동 연동됩니다.
    R2 S3 API 엔드포인트
    R2 화면에서 복사한 S3 API 주소.https://<ACCOUNT_ID>.r2.cloudflarestorage.com기본 관할 예시입니다. 버킷 관할에 맞는 주소를 사용하고, 주소 끝에 버킷 이름을 붙이지 마세요.
    Access Key ID
    R2 키 발급 결과의 Access Key ID.
    Secret Access Key
    같은 발급 결과의 Secret Access Key. 일반 API Token 값과 혼동하지 마세요.

    적용 · 닫기로 저장합니다. 설정은 현재 Windows 계정으로 암호화하여 PC에 저장되며, 앱을 다시 실행해도 복원됩니다. 설정 저장만으로 업로드가 시작되지는 않습니다.

    공식 문서: S3 주소와 연결 값 ↗

  4. 버킷을 연결하고 파일 목록 확인하기

    파일 관리에서 연결에 사용할 버킷 이름을 입력하세요. 인증 키 발급 때 허용한 버킷과 정확히 같아야 합니다. 파일 목록이 열리는지 먼저 확인한 뒤 업로드하세요.

    AWS로 업로드에서는 로컬 폴더, 버킷 이름, 버킷 내 저장 경로를 따로 지정합니다. 공개 URL이 필요하면 버킷에 공개 도메인을 연결하고 해당 주소를 설정하세요. S3 엔드포인트와 공개 다운로드 주소는 용도가 다릅니다.

선택 설정 · 업로드 후 캐시도 자동으로 비우려면

Cloudflare에 연결한 공개 도메인의 캐시를 초기화할 때 설정합니다. R2 파일 업로드만 사용한다면 이 부분은 비워 두어도 됩니다.

  1. Cloudflare의 프로필 → API Tokens → Create Token → Custom token에서 토큰을 만듭니다.
  2. 권한은 Zone → Cache Purge → Purge, Zone Resources는 Include → Specific zone으로 설정하고 공개 도메인의 영역을 선택하세요.
  3. 발급된 값을 앱의 캐시 초기화용 API 토큰에 입력합니다.
  4. 공개 URL 베이스에는 https://cdn.example.com처럼 실제 파일을 제공하는 주소를, Zone ID에는 해당 도메인의 Overview에서 확인한 영역 ID를 입력합니다. Account ID와 Zone ID는 다릅니다.
  5. 업로드 후 해당 파일 캐시 자동 초기화를 켜고 적용하세요. 파일 관리의 연결별 공개 URL·Zone ID도 사용하는 버킷에 맞춰 확인하세요.

공식 문서: 캐시 초기화 API와 권한 ↗

연결이 안 되면 무엇부터 확인하나요?
  • 인증 실패 / AccessDenied: 키 2개가 같은 발급 결과인지, 읽기·쓰기 권한과 허용 버킷이 맞는지 확인하세요.
  • 엔드포인트 오류: 공개 URL이 아닌 R2 S3 주소를 입력했는지 확인하세요. 1.0.47은 기본·EU·FedRAMP 주소 형식을 지원하며, 다른 관할 주소는 입력 검증에서 거부될 수 있습니다.
  • 업로드는 되는데 이전 파일이 보임: 공개 URL 베이스, Zone ID, 별도 Cache Purge 토큰을 확인하세요.
  • Secret Access Key를 잃어버림: 새 R2 키를 발급해 앱 설정을 교체하세요. 키를 공유 게시물이나 문의 스크린샷에 노출하지 마세요.

사용 전에 알아두세요

원본 파일은 어떻게 처리되나요?

WebP 변환의 기본값은 원본 유지입니다. 같은 폴더에 저장할 때는 원본 삭제 옵션을 별도로 선택할 수 있습니다. 파일명 변경은 미리보기 확인 후 실제 파일에 적용되고, 와일드카드 편집기는 원본 TXT에 자동저장합니다.

ELD2 PNG도 WebP로 바꿔도 되나요?

ELD2 PNG는 픽셀에 음원 데이터를 저장하므로 일반 이미지처럼 변환하거나 최적화하면 안 됩니다. 툴박스의 WebP 변환기는 ELD2 입력을 차단합니다.

설치파일에는 무엇이 포함되나요?

Windows용 앱과 Python, ImageMagick, AWS CLI 실행 도구가 함께 제공됩니다. 다운로드 파일은 Windows 64비트 설치형이며 macOS·Linux 설치파일은 제공하지 않습니다.

같은 경로로 다시 업로드하면 어떻게 되나요?

AWS 업로드는 원격의 같은 객체 경로를 덮어씁니다. 취소 전에 완료된 객체는 버킷에 남으므로 업로드 시작 전에 버킷과 저장 경로를 확인하세요.

03 — 업데이트 기록

버전별 변경 내역

배포 서버에서 최근 5개 버전의 변경 내역을 자동으로 불러옵니다.

최신 설치파일 다운로드
최신 변경 내역을 불러오고 있습니다.