윈도우에서 WSL 설치 및 환경 설정: 동영상 스크린샷 추출 개발 준비

 

이 글에서는 윈도우에서 WSL(Ubuntu-24.04)을 설치하고, FFmpeg와 파이썬 환경을 설정하여 동영상에서 프레임을 추출할 수 있는 환경을 준비하는 방법을 설명합니다. 윈도우 WSL 설치 방법과 환경 설정 과정을 단계별로 정리하여 이미지 추출을 개발할수 있는 환경을 구성하는 내용을 설명합니다~

FFmpeg 명령을 활용한 영상에서 장면 추출(스크립트 포함)

---

 

1. 목표 및 준비사항

목표

• 윈도우에서 WSL(Ubuntu-24.04) 설치.
• WSL 환경에서 FFmpeg 설치.
• 파이썬 환경 설정 및 필요한 패키지 설치.
• 동영상 프레임 추출 작업을 위한 환경 준비.

준비사항

• 윈도우 10 또는 11 (버전 2004 이상).
• 관리자 권한이 있는 윈도우 계정.
• 인터넷 연결.
• 기본적인 명령줄 사용 지식.

2. 윈도우에서 WSL 설치

(1) WSL 활성화

WSL(Windows Subsystem for Linux)을 활성화합니다.

1. 윈도우 검색창에서 Windows 기능 켜기/끄기를 검색하여 실행.

2. 목록에서 "Windows Subsystem for Linux"와 "Virtual Machine Platform"을 체크.

3. 확인 클릭 후 윈도우 재부팅.

(2) WSL2 설정

cmd 창을 열어서 WSL2를 기본 버전으로 설정합니다.

wsl --set-default-version 2

명령 프롬프트(cmd) 또는 PowerShell에서 실행하세요.

(3) Ubuntu-24.04 설치

Microsoft Store에서 Ubuntu-24.04를 설치합니다.

1. Microsoft Store를 열고 Ubuntu 24.04를 검색.

2. 설치 버튼 클릭.

3. 설치 후 Ubuntu-24.04를 실행하여 초기 설정:

• 사용자 이름과 비밀번호 설정 (예: 사용자 이름 doyo).

4. 설치 확인:

wsl --list --verbose

출력 예:

  NAME                   STATE           VERSION
  * Ubuntu-24.04           Running         2

3. WSL 환경 설정

(1) Ubuntu 업데이트

Ubuntu 패키지를 최신 상태로 업데이트합니다.

sudo apt update
sudo apt upgrade -y

(2) 한글 로케일 설정

한글 경로 지원을 위해 로케일을 설정합니다.

sudo locale-gen ko_KR.UTF-8
sudo update-locale LANG=ko_KR.UTF-8

설정 확인:

locale

출력 예:

LANG=ko_KR.UTF-8
LC_CTYPE="ko_KR.UTF-8"
...

(3) 파이썬 설치 확인

Ubuntu-24.04에는 파이썬이 기본 설치되어 있습니다. 버전을 확인합니다.

python3 --version

출력 예: Python 3.12.3

파이썬이 설치되어 있지 않다면 설치:

sudo apt install python3 python3-pip -y

(4) FFmpeg 설치

동영상 프레임 추출에 사용할 FFmpeg를 설치합니다.

sudo apt install ffmpeg -y

설치 확인:

ffmpeg -version

출력 예: ffmpeg version 6.0...

(5) NVIDIA GPU 지원 설정 (선택)

GPU를 사용하려면 NVIDIA 드라이버와 CUDA를 설치해야 합니다.

1. 윈도우에서 NVIDIA 드라이버 설치:

• NVIDIA 공식 웹사이트(https://www.nvidia.com/Download/index.aspx)에서 드라이버 다운로드.
• 설치 후 확인:

nvidia-smi

출력 예:

+-----------------------------------------------------------------------------+
| NVIDIA-SMI 535.104.05   Driver Version: 535.104.05   CUDA Version: 12.2     |
...

2. WSL에서 CUDA 지원 확인:

ffmpeg -encoders | grep nvenc

출력에 h264_cuvid 또는 nvenc가 있으면 GPU 사용 가능.

4. 작업 디렉토리 설정

(1) 디렉토리 생성

작업 디렉토리를 생성합니다.

mkdir -p /home/doyo/py_pj/get_v2i
cd /home/doyo/py_pj/get_v2i

윈도우에서 접근 가능한 경로:

\\wsl.localhost\Ubuntu-24.04\home\doyo\py_pj\get_v2i

파일 탐색기에서 확인:

explorer \\wsl.localhost\Ubuntu-24.04\home\doyo\py_pj\get_v2i

(2) 테스트 동영상 준비

테스트용 동영상을 준비합니다. 예: C:\녹화폴더\test.mp4

WSL에서 접근 경로:

/mnt/c/녹화폴더/test.mp4

파일 확인:

ls /mnt/c/녹화폴더

5. 추가 환경 설정

(1) 네트워크 설정

WSL과 윈도우 간 네트워크 연결을 확인합니다.

1. 윈도우에서 WSL 어댑터 IP 확인:

ipconfig

출력 예:

이더넷 어댑터 vEthernet (WSL (Hyper-V firewall)):
   IPv4 주소 . . . . . . . . . : 172.26.xx.xx

2. WSL에서 핑 테스트:

ping 172.26.16.1

응답이 오면 성공:

PING 172.26.xx.xx (172.26.xx.xx) 56(84) bytes of data.
64 bytes from 172.26.16.1: icmp_seq=1 ttl=128 time=0.123 ms

응답이 없으면 네트워크 리셋:

wsl --shutdown
netsh winsock reset
netsh int ip reset all
ipconfig /flushdns

(2) 방화벽 설정

WSL과 윈도우 간 통신을 위해 방화벽 설정을 조정합니다.

1. 윈도우 검색창에서 방화벽 검색 → Windows Defender 방화벽 → 고급 설정.

2. 인바운드 규칙 → 새 규칙:

• 규칙 유형: "프로그램".
• 프로그램 경로: C:\Windows\System32\wsl.exe.
• 작업: "연결 허용".
• 프로필: "개인"만 체크.
• 이름: "WSL Allow Inbound".

3. 아웃바운드 규칙도 동일하게 추가.

6. 환경 설정 요약

(1) WSL 설치

WSL 활성화 및 Ubuntu-24.04 설치:

wsl --set-default-version 2

(2) Ubuntu 환경 설정

패키지 업데이트 및 한글 로케일 설정:

sudo apt update
sudo apt upgrade -y
sudo locale-gen ko_KR.UTF-8
sudo update-locale LANG=ko_KR.UTF-8

(3) FFmpeg 및 파이썬 설치

필요한 도구 설치:

sudo apt install ffmpeg -y
sudo apt install python3 python3-pip -y

(4) 작업 디렉토리 준비

작업 디렉토리 생성 및 테스트 동영상 준비:

mkdir -p /home/doyo/py_pj/get_v2i
cd /home/doyo/py_pj/get_v2i

7. 다음 단계

이제 환경 설정이 완료되었습니다. 다음 단계로 동영상 프레임 추출 작업을 진행할 수 있습니다.

 

FFmpeg 명령을 활용한 영상에서 장면 추출(스크립트 포함)

 

글을 참고하여 프레임 추출 스크립트를 작성하고 실행하세요.

작업 디렉토리(/home/doyo/py_pj/get_v2i)에 스크립트를 저장하고, 테스트 동영상(/mnt/c/녹화폴더/test.mp4)을 사용하여 프레임 추출을 시작할 수 있습니다.