VideoToAscii

비디오 변환 및 재생

비디오 파일을 콘솔에서 실시간으로 ASCII 아트로 변환하여 재생합니다. 기본 설정으로 즉시 실행할 수 있으며, 다양한 전환 전략을 지원하여 각기 다른 예술적 스타일을 구현할 수 있습니다.

오디오 지원

시각적 변환과 함께 동기화된 오디오 재생을 지원합니다. 이를 통해 터미널 환경에서도 영상의 소리와 함께 완성도 높은 시청 경험을 누릴 수 있습니다.

다양한 출력 형식

변환된 결과를 단순히 화면에 표시하는 것 외에도 파일로 출력할 수 있습니다. 현재 텍스트(.txt), JSON(.json), 배치 파일(.bat), PowerShell 스크립트(.ps1), 셸 스크립트(.sh) 형식이 지원됩니다.

설치 및 시작

Windows 환경에서는 WinGet을 통해 간편하게 설치할 수 있습니다. 터미널에서 다음 명령어를 실행하여 설치합니다.

winget install videotoascii

설치 후 기본 명령어 구조는 다음과 같습니다.

videotoascii -f [비디오_파일_경로]

비디오 파일을 지정하고 실행하면 콘솔 창에서 바로 ASCII 아트 변환이 시작됩니다.

활용 예시

기본적인 설정으로 비디오를 재생하려면 파일 경로만 지정하면 됩니다.

videotoascii -f video.mp4

ascii-color 전환 전략을 사용하고 오디오를 활성화하여 재생할 수도 있습니다.

videotoascii -f video.mp4 -s ascii-color -a

변환된 결과를 PowerShell 스크립트 파일로 저장하고 싶을 때는 출력 경로를 지정합니다.

videotoascii -f video.mp4 -o output.ps1

지원 환경 및 요구사항

현재 Windows 운영 체제를 지원하며, .NET 8 런타임이 설치되어 있어야 합니다. 터미널이나 콘솔 환경은 Unicode를 지원해야 하며, 원하는 ASCII 해상도에足够的한 충분한 콘솔 크기가 필요합니다.

전환 전략 옵션

사용 가능한 전환 전략은 다음과 같습니다.

• filled-ascii: 기본 전략으로 채워진 ASCII 문자 사용
• ascii-color: 색상이 적용된 ASCII 변환
• just-ascii: 순수 ASCII 문자만으로 변환

제한 사항 및 참고 사항

이 도구는 그래픽 사용자 인터페이스 없이 콘솔 환경에서만 동작합니다. 변환된 ASCII 아트의 품질과 시각적 효과는 사용하는 터미널의 해상도, 색상 지원 설정, 그리고 콘솔 창 크기에 따라 달라집니다. 오디오 지원을 사용하려면 별도의 FFmpeg 설치가 필요할 수 있습니다.