프로젝트의 기능
onlyfans-ai-creator-video-downloader-uploader-free는 OnlyFans 동영상 작업 흐름을 관리하기 위한 Windows 데스크톱 애플리케이션입니다. 그래픽 인터페이스를 통해 세션 쿠키로 인증하고, 크리에이터 페이지에서 동영상을 가져오며, 선택한 파일을 다운로드하고, 내장 AI 태깅 엔진으로 라벨을 생성하고, 동영상을 일괄 업로드할 수 있습니다.
본인이 소유하거나 액세스, 다운로드 및 업로드 권한을 부여받은 계정과 콘텐츠에만 이 애플리케이션을 사용하세요. 플랫폼 약관과 관련 저작권 및 개인정보 보호법을 준수하세요.
주요 기능
- 멀티스레드 다운로드: 최대 8개의 다운로드 스레드를 동시에 실행합니다.
- AI 태그 생성: 내장 자연어 처리 엔진을 사용해 라벨을 생성합니다.
- 일괄 업로드: 최대 50개의 동영상을 한 번에 처리할 수 있습니다.
- 쿠키 인증: 계정 비밀번호를 요구하는 대신 OnlyFans 세션 쿠키를 읽습니다.
- 프록시 지원: HTTP 및 SOCKS5 프록시와 함께 작동합니다.
- JSON 구성: 조정 가능한 옵션을
config.json에 저장합니다. - 문제 해결 로그: 진단 정보를
logs\디렉터리에 기록합니다.
스케줄러는 버전 2.0에 추가될 예정이며 현재 사용할 수 없습니다. 실시간 미리보기 역시 향후 기능으로 등록되어 있으므로 현재 릴리스에서는 두 기능을 사용할 수 없습니다.
설치 및 안전한 설정
1. 아카이브 다운로드 및 검사
- 저장소 파일 또는 README에서 안내하는 릴리스 링크를 통해 아카이브를 다운로드합니다.
- 소스가 사용하려는 프로젝트 위치가 맞는지 확인합니다.
- 아카이브를 전용 폴더에 압축 해제합니다. README에는 압축 해제 비밀번호가 필요하지 않다고 안내되어 있습니다.
- 실행 파일을 실행하기 전에 Windows 보안 또는 신뢰할 수 있는 다른 보안 제품으로 아카이브와 압축 해제된 파일을 검사합니다.
README에서는 프로그램이 차단될 경우 바이러스 백신 보호를 일시적으로 비활성화할 것을 제안합니다. 더 안전한 방법은 보호 기능을 계속 활성화한 상태에서 경고를 검토하고, 가능한 경우 파일의 출처와 서명 또는 해시를 확인한 다음, 익숙하지 않은 바이너리를 격리된 환경에서 테스트하는 것입니다. 경고가 표시된 이유를 이해하지 못한 상태에서는 경고를 우회하지 마세요.
2. 애플리케이션 시작
압축을 해제한 디렉터리를 열고 OnlyFans-Downloader-Uploader.exe를 실행합니다. 애플리케이션이 시작되면 대시보드가 자동으로 로드됩니다.
3. 인증 구성
메시지가 표시되면 config.json을 열고 기존 구성 필드에서 요구하는 쿠키 정보를 입력합니다. README에는 브라우저의 sessionid 쿠키가 명시되어 있습니다. 전체 JSON 스키마는 문서화되어 있지 않으므로 추측한 옵션을 추가하지 말고 파일의 기존 필드 이름과 형식을 유지하세요.
세션 쿠키는 로그인된 브라우저 세션과 동등한 액세스 권한을 제공할 수 있으므로 민감한 정보입니다. 스크린샷, 로그, 지원 문의, 소스 관리 시스템 또는 공유 구성 파일에 절대 게시하지 마세요. 본인의 세션만 사용하고 config.json을 비공개로 유지하세요. 쿠키가 노출되었다고 생각되면 계정을 통해 세션을 폐기하세요.
기본 다운로드 작업 흐름
- 애플리케이션을 실행하고 대시보드가 나타날 때까지 기다립니다.
- 다운로더 탭을 엽니다.
- 액세스 권한이 있는 크리에이터 프로필의 URL을 붙여 넣습니다.
- 동영상 가져오기를 선택하고 사용 가능한 클립이 로드될 때까지 기다립니다.
- 필요한 동영상을 선택합니다.
- 다운로드를 선택해 동영상을 로컬에 저장합니다.
- 상태 패널에서 실시간 진행 상황과 오류를 확인합니다.
작업 흐름 예시
예를 들어 본인 아카이브를 관리하는 권한 있는 크리에이터라면 자신의 프로필에서 동영상을 가져온 후, 결과 목록에서 여러 클립을 선택하고 다음 업로드 배치에 필요한 파일만 다운로드할 수 있습니다.
권한 있는 프로필 URL → 동영상 가져오기 → 클립 선택 → 다운로드AI 태깅 및 일괄 업로드
- 업로더 탭을 엽니다.
- 다운로드한 동영상 파일을 업로드 대기열에 추가합니다.
- 내장 AI 엔진으로 라벨을 생성하려면 자동 태깅을 활성화합니다.
- 인터페이스에서 허용하는 경우 선택한 파일과 생성된 태그를 검토합니다.
- 업로드를 선택합니다.
- 배치가 완료되거나 오류가 보고될 때까지 실시간 상태 패널을 확인합니다.
업로더는 배치당 최대 50개의 동영상을 처리합니다. 소규모로 시험하려면 권한이 있는 파일 1~2개로 시작하여 대기열을 크게 만들기 전에 인증, 태깅 및 업로드 동작을 확인하세요.
다운로드한 파일 → 업로더 → 자동 태깅 → 업로드 → 상태 패널고급 구성 팁
다운로드 동시성 조정
애플리케이션은 최대 8개의 스레드를 동시에 지원합니다. 관련 설정은 config.json에서 조정할 수 있지만 README에는 정확한 속성 이름이 제공되어 있지 않습니다. 동시성을 높이면 처리량이 향상될 수 있지만 대역폭과 시스템 리소스를 더 많이 사용할 수도 있습니다. 다운로드가 불안정해지면 구성된 스레드 수를 줄이세요.
프록시 구성
HTTP 및 SOCKS5 프록시를 지원하며 프록시 목록은 config.json에서 조정할 수 있습니다. 신뢰할 수 있고 사용 권한이 있는 프록시만 사용하세요. 프록시 운영자는 연결 메타데이터를 확인할 수 있으므로 출처를 알 수 없는 무료 프록시 서비스는 피하세요.
업로드 배치 크기 관리
이 도구는 한 번에 최대 50개의 동영상을 처리할 수 있지만, 배치 규모가 작을수록 문제를 진단하기 쉽습니다. 먼저 짧은 대기열을 테스트한 다음, 세션과 업로드 구성이 제대로 작동하는지 확인한 후 파일 수를 늘리세요.
구성 데이터 보호
- 쿠키나 프록시 자격 증명이 포함된 경우
config.json을 공개 저장소에 커밋하지 마세요. - 민감한 값을 삭제하지 않은 상태로 구성 파일을 제3자에게 보내지 마세요.
- 인증 데이터가 유출되었을 가능성이 있다면 OnlyFans 세션을 갱신하거나 폐기하세요.
- 다운로드한 미디어는 적절한 Windows 액세스 제어가 설정된 폴더에 보관하세요.
문제 해결에 로그 사용
진단 로그는 logs\ 아래에 저장됩니다. 가져오기, 다운로드 또는 업로드에 실패하면 해당 디렉터리를 확인하세요. 로그를 공유하기 전에 내용을 검토하고 세션 식별자, 프로필 세부 정보, 로컬 경로 및 기타 개인정보를 삭제하세요.
일반적인 문제
애플리케이션에서 인증할 수 없음
세션 쿠키가 현재 유효한지, config.json이 여전히 올바른 JSON인지 확인하세요. 브라우저 세션이 만료되었거나 폐기된 경우, 직접 로그인한 세션에서 새 쿠키를 가져와야 할 수 있습니다.
다운로드가 느리거나 불안정함
다운로드 스레드 수를 줄이고 네트워크 연결을 확인한 다음, 구성된 프록시를 검토하세요. 그런 다음 상태 패널과 logs\ 디렉터리에서 보고된 오류를 확인하세요.
계획된 기능이 없음
현재 기능 매트릭스에는 활성 스케줄러나 실시간 미리 보기가 포함되어 있지 않습니다. 스케줄러는 버전 2.0에 계획되어 있으며, 실시간 미리 보기는 곧 제공될 예정으로 안내되어 있습니다.
결론
이 Windows GUI는 쿠키 기반 인증, 멀티스레드 다운로드, AI 생성 태그 및 일괄 업로드를 하나의 워크플로에 통합합니다. 검증된 소프트웨어로 시작하고, 세션 쿠키를 보호하며, 권한이 있는 소규모 배치로 테스트하고, 상태 패널과 로그를 사용해 문제를 해결하세요. 이 프로젝트는 Apache-2.0 라이선스로 공개되어 있습니다.