Wan 2.1 사용자 메뉴얼

Wan 2.1 사용자 메뉴얼

 

목차

1. 소개
2. 설치 방법
3. 사용 방법
4. 고급 기능
5. 문제 해결
6. 라이선스

소개

Wan 2.1은 다양한 비디오/오디오 형식을 변환하고 다운로드할 수 있는 강력한 오픈 소스 도구입니다. 이 도구는 yt-dlp를 기반으로 하며 사용자 친화적인 인터페이스를 제공합니다.

주요 기능

• 여러 비디오/오디오 웹사이트에서 미디어 다운로드
• 다양한 출력 형식으로 변환 가능 (MP4, MP3, WAV 등)
• 간편한 명령줄 인터페이스 제공
• 배치 작업 지원
• 빠른 처리 속도

설치 방법

사전 요구 사항

• Python 3.7 이상
• FFmpeg (미디어 처리를 위해 필요)

윈도우에 설치하기

1. FFmpeg 설치
   • FFmpeg 공식 웹사이트에서 FFmpeg를 다운로드하세요.
   • 다운로드한 파일의 압축을 풀고 시스템 PATH에 추가하세요.
2. Wan 2.1 설치
3. git clone https://github.com/Wan-Video/Wan2.1.git cd Wan2.1 pip install -r requirements.txt

macOS에 설치하기

1. Homebrew를 통해 FFmpeg 설치
2. brew install ffmpeg
3. Wan 2.1 설치
4. git clone https://github.com/Wan-Video/Wan2.1.git cd Wan2.1 pip install -r requirements.txt

Linux에 설치하기

1. FFmpeg 설치
2. sudo apt update sudo apt install ffmpeg
3. Wan 2.1 설치
4. git clone https://github.com/Wan-Video/Wan2.1.git cd Wan2.1 pip install -r requirements.txt

사용 방법

기본 사용법

1. 비디오 다운로드예: python wan.py -u https://www.youtube.com/watch?v=example -o ~/Downloads/video.mp4
2. python wan.py -u [URL] -o [출력 경로]
3. 오디오만 다운로드 (MP3 형식)예: python wan.py -u https://www.youtube.com/watch?v=example -f mp3 -o ~/Music/audio.mp3
4. python wan.py -u [URL] -f mp3 -o [출력 경로]
5. 특정 품질로 다운로드예: python wan.py -u https://www.youtube.com/watch?v=example -q 1080 -o ~/Videos/hd_video.mp4
6. python wan.py -u [URL] -q [품질] -o [출력 경로]

배치 다운로드

여러 URL을 포함한 텍스트 파일을 사용하여 배치 다운로드를 수행할 수 있습니다:

1. 각 줄에 하나의 URL이 있는 텍스트 파일 생성 (예: urls.txt)
2. 다음 명령어 실행: 
3. python wan.py -b urls.txt -o [출력 디렉토리]

고급 기능

사용자 정의 형식 옵션

다양한 형식 옵션을 지정할 수 있습니다:

python wan.py -u [URL] -f [형식] -o [출력 경로] --custom-args "[추가 인수]"

예시:

python wan.py -u https://www.youtube.com/watch?v=example -f mp4 -o video.mp4 --custom-args "--postprocessor-args '-codec:v libx264 -crf 23'"

프록시 사용

프록시를 통해 다운로드:

python wan.py -u [URL] -o [출력 경로] --proxy [프록시 URL]

예시:

python wan.py -u https://www.youtube.com/watch?v=example -o video.mp4 --proxy http://proxy-server:8080

자막 다운로드

비디오와 함께 자막 다운로드:

python wan.py -u [URL] -o [출력 경로] --subtitles

특정 언어의 자막만 다운로드:

python wan.py -u [URL] -o [출력 경로] --subtitles --sub-lang [언어 코드]

예시:

python wan.py -u https://www.youtube.com/watch?v=example -o video.mp4 --subtitles --sub-lang ko

다운로드 속도 제한

대역폭 사용량을 제한하려면:

python wan.py -u [URL] -o [출력 경로] --limit-rate [속도]

예시:

python wan.py -u https://www.youtube.com/watch?v=example -o video.mp4 --limit-rate 1M

문제 해결

일반적인 문제

1. "FFmpeg not found" 오류
   • FFmpeg가 제대로 설치되었는지 확인하세요.
   • 시스템 PATH에 FFmpeg가 포함되어 있는지 확인하세요.
   • 명령줄에서 ffmpeg -version을 실행하여 설치를 테스트하세요.
2. 다운로드 속도가 느림
   • 인터넷 연결을 확인하세요.
   • 다른 서버 또는 프록시를 사용해 보세요.
   • 피크 시간을 피해 다운로드하세요.
3. 특정 웹사이트에서 다운로드 실패
   • yt-dlp가 최신 버전인지 확인하세요: pip install -U yt-dlp
   • --verbose 플래그를 사용하여 더 자세한 오류 정보를 확인하세요.
4. 변환 오류
   • FFmpeg가 최신 버전인지 확인하세요.
   • 출력 파일 형식이 올바른지 확인하세요.
   • 충분한 디스크 공간이 있는지 확인하세요.

로그 확인

문제 해결을 위해 자세한 로그를 확인할 수 있습니다:

python wan.py -u [URL] -o [출력 경로] --verbose

라이선스

Wan 2.1은 MIT 라이선스 하에 배포됩니다. 자세한 내용은 프로젝트의 LICENSE 파일을 참조하세요.

---

추가 도움이 필요하시면 GitHub 이슈 페이지에 문의하시거나 기여해 주세요. 여러분의 피드백은 Wan 2.1을 개선하는 데 큰 도움이 됩니다!