CLI Music

음악 검색

터미널에서 키워드로 음악을 검색할 수 있습니다. 자유 텍스트 쿼리를 입력하고, 필요에 따라 믹스/플레이리스트 포함 또는 연도별 정렬 옵션을 사용할 수 있습니다.

장르 및 분위기별 발견

장르와 분위기를 선택하여 해당 조건에 맞는 음악을 탐색할 수 있으며, 검색과 동일한 방식으로 결과를 페이지 단위로 불러올 수 있습니다.

YouTube URL 재생

YouTube 플레이리스트 URL 또는 단일 영상 URL을 붙여넣으면 바로 재생할 수 있으며, 이 모드에서는 쿼리/분위기/정렬 프롬프트를 건너뜁니다.

키보드 컨트롤

재생 중 다음과 같은 키보드 단축키를 사용할 수 있습니다:

• N: 다음 곡
• P: 이전 곡
• Q: 플레이어 종료
• S: 검색/모드 선택 화면으로 이동
• D: 현재 곡 다운로드
• D puis P 빠르게 누르기: 현재 큐의 모든 곡 다운로드

다운로드 기능

원하는 음악을 다운로드하여 오프라인으로 감상할 수 있습니다. 다운로드된 곡은 Downloads/music/ 디렉터리에 저장되며, ffmpeg를 사용하여 192 kbps의 MP3로 변환됩니다.

설치 및 시작 방법

터미널에서 다음 단계를 따라 CLI Music을 설치하고 실행할 수 있습니다:

1. 선택 사항이지만 권장되는 가상 환경을 생성하고 활성화합니다.
2. pip install -r requirements.txt 명령어로 의존성을 설치합니다.
3. 프로젝트 루트에서 python cli/stream.py를 실행하여 프로그램을 시작합니다.

또는 Winget을 통해 winget install --id BonnieBoni.CliMusic --exact 명령어로 바로 설치할 수 있습니다.

활용 예시

터미널에서 CLI Music을 실행한 후, 가수 이름이나 곡 제목 등을 입력하여 음악을 검색할 수 있습니다. 검색 결과 목록에서 원하는 곡을 선택해 스트리밍 재생하거나, D 키를 눌러 다운로드할 수 있습니다. 장르와 분위기를 결합해 새로운 음악을 탐색하거나, YouTube URL을 붙여넣어 특정 플레이리스트를 바로 감상할 수도 있습니다.

지원 환경 및 요구사항

CLI Music은 Windows, macOS, Linux 등 터미널을 지원하는 모든 운영체제에서 실행 가능합니다. 별도의 GUI가 필요 없으며, 순수 명령줄 환경에서 작동합니다. 다만, 스트리밍 및 다운로드 기능은 정상적인 인터넷 연결을 필요로 합니다.

제한 사항 및 확인 사항

터미널 사용에 익숙하지 않은 사용자에게는 다소 불편할 수 있습니다. 스트리밍 및 다운로드 기능은 인터넷 연결이 필요하며, 저작권에 유의하여 합법적인 용도로만 사용해야 합니다. 또한, 동시 재생은 한 번에 하나의 프로세스만 허용되며, 다음/이전 곡으로 이동 시 현재 재생 중인 곡이 종료된 후에야 다음 곡이 시작됩니다.