YTuff

로컬 오디오 파일 재생

MP3, FLAC, WAV, M4A, OGG, AAC, Opus, WMA 형식의 로컬 파일을 재생하며, 네이티브 디코더가 처리하지 못하는 형식은 FFmpeg을 통해 재생합니다.

YouTube Music 스트리밍

YouTube Music을 검색하고 재생하며, 계정 로그인을 통해 개인화된 홈, 계정 플레이리스트 및 안정적인 재생을 이용할 수 있습니다.

플레이리스트 및 큐 관리

로컬에 저장된 플레이리스트를 만들고, YouTube 플레이리스트나 앨범을 가져올 수 있으며, 큐에 트랙을 추가하거나 삭제하고 순서를 변경할 수 있습니다.

가사 및 아트워크

현재 재생 중인 트랙의 가사를 표시하고, wimg, Kitty graphics, Sixel 또는 블록 아트 등으로 앨범 아트워크를 렌더링합니다.

백그라운드 데몬 및 컨트롤

백그라운드 데몬으로 음악을 계속 재생하고, 슬립 타이머, 자동 재생, 볼륨 컨트롤, 미디어 키 등을 지원합니다.

설치 및 기본 사용

Windows에서는 winget 패키지 관리자를 통해 winget install HarshJha.YTuff 명령으로 설치할 수 있으며, MSI 또는 포터블 ZIP을 다운로드하여 수동 설치도 가능합니다. Linux에서는 AUR에서 yay -S ytuff-bin 명령이나 tarball을 받아 설치할 수 있습니다.

설치 후 터미널에서 ytuff tui 명령을 실행해 텍스트 사용자 인터페이스를 시작합니다. 로컬 파일을 재생하려면 파일 경로를 지정하고, YouTube Music을 재생하려면 해당 URL이나 검색어를 입력합니다. 스페이스바로 일시정지, 엔터로 트랙 재생 또는 선택한 플레이리스트 열기, s 키로 로컬/YouTube 모드 전환 등을 사용할 수 있습니다.

활용 예시

• 로컬 음악 폴더를 등록해 터미널에서 음악 컬렉션을 탐색하고 재생하기
• YouTube Music에서 특정 아티스트나 곡을 검색해 바로 재생하거나 플레이리스트에 추가하기
• 플레이리스트를 만들어 오프라인에서 듣기 위해 M4A 또는 MP3 형식으로 다운로드하기
• 가사 표시 기능을 이용해 현재 재생 중인 노래의 가사를 실시간으로 확인하기
• 백그라운드 데몬을 활성화해 다른 터미널 작업 중에 음악을 지속적으로 재생하기

지원 환경 및 요구사항

지원 운영 체제: Windows 10 이상 (x64), Linux (배포판에 따라 의존성 필요). 필수 런타임: FFmpeg (미디어 디코딩 및 스트리밍), Windows에서는 WebView2Loader.dll 및 wimg.exe와 관련된 DLL이 필요합니다. YouTube Music 스트리밍을 위해서는 활성 인터넷 연결이 필요하며, 계정 로그인을 통해 개인화된 콘텐츠에 접근할 수 있습니다.

제한 사항 및 확인사항

• YouTube Music 재생은 인터넷 연결이 필수이며, 일부 지역이나 저작권 제한으로 인해 특정 트랙이 재생되지 않을 수 있습니다.
• 터미널 기반 프로그램이므로 그래픽 사용자 인터페이스(GUI)를 선호하는 사용자에게는 적합하지 않을 수 있습니다.
• 로컬 파일 재생 시 FFmpeg이 설치되어 있어야 하며, 누락된 경우 일부 형식은 재생되지 않을 수 있습니다.