RubinLabs26/ISpotify

iSpotify – 빠른 개요

정의 – iSpotify는 Windows 또는 Linux에서 음악을 검색하고 MP3 파일로 다운로드하며 로컬에서 재생할 수 있는 무료 오픈 소스 데스크톱 클라이언트입니다. 모든 작업은 사용자 컴퓨터에서 이루어집니다. 중앙 iSpotify 계정, 서버, 분석 또는 원격 측정이 없습니다.

핵심 기능

기능	제공 내용
검색 및 발견	(YouTube를 통해) 노래와 재생 목록을 쿼리하고 결과를 탐색합니다. 여러 항목을 한 번에 선택하여 일괄 다운로드할 수 있습니다.
다운로드 관리자	MP3 다운로드를 대기열에 넣고 속도/예상 시간을 표시하며 실패 시 재시도하고 재시작 후에도 유지됩니다.
로컬 라이브러리	다운로드한 파일은 OS별 사용자 데이터 폴더에 저장됩니다. 정렬, 즐겨찾기, 재생 목록으로 구성하여 오프라인 재생이 가능합니다.
재생	이전/다음, 탐색, 볼륨 조절, 헤드폰 분리 시 자동 일시 정지 기능을 갖춘 간단한 오디오 플레이어.
개인정보 보호 우선	자격 증명(YouTube 쿠키, Discord 토큰)은 OS 키링에 저장됩니다. 원격 측정이 기기 밖으로 나가지 않습니다.
Discord 통합(선택 사항)	Discord 계정을 연결하면 커버 아트와 트랙 시간이 포함된 "Listening to iSpotify" 상태를 게시합니다.
크로스 플랫폼 UI	PySide6(Qt for Python)로 구축되어 동일한 인터페이스가 Windows와 Linux에서 실행됩니다.
설치 옵션	Windows 설치 프로그램, 휴대용 exe, Debian/Ubuntu .deb, 일반 Linux 휴대용 바이너리, 또는 서명된 저장소를 추가하고 aria2를 가져와 빠른 재개 가능 다운로드를 제공하는 한 줄 설치 스크립트.

내부 작동 방식

• yt‑dlp는 YouTube 검색, 비디오 URL 해석, 오디오 스트림 추출에 사용됩니다.
• FFmpeg(또는 번들된 imageio‑ffmpeg)는 스트림을 고품질 MP3로 변환합니다.
• Aria2(Linux 설치 프로그램으로 설치)는 재개 지원과 함께 실제 파일 다운로드를 처리합니다.
• Keyring은 쿠키나 Discord 토큰을 OS 보관소에 안전하게 저장합니다.
• GUI는 이러한 도구를 조정하고 친숙한 음악 플레이어 레이아웃을 제공하는 얇은 Qt 레이어입니다.

시작하기

1. 다운로드 표에서 적절한 패키지를 다운로드합니다(예: Windows용 ISpotify-Setup-x86_64.exe 또는 Linux 설치 스크립트).
2. 설치 프로그램 또는 휴대용 바이너리를 실행합니다. 앱이 라이브러리용 사용자 데이터 폴더를 만듭니다.
3. 앱을 열고 트랙을 검색한 다음 다운로드 버튼을 클릭합니다. 백그라운드 대기열이 완료되면 파일이 라이브러리에 나타납니다.
4. (선택 사항) 설정 → Discord에서 Discord 계정을 연결하여 재생 중인 음악을 방송합니다.

이런 분께 추천 – Spotify 스트리밍 앱의 자체 호스팅 대안을 원하는 음악 애호가, Python 기반 데스크톱 도구를 선호하는 개발자, 또는 청취 데이터를 완전히 비공개로 유지하려는 모든 사람.

기여 – 프로젝트는 표준 Python 가상 환경 워크플로(python -m venv .venv && pip install -r requirements.txt)를 사용합니다. 풀 리퀘스트를 통한 기여를 환영합니다. 지침은 CONTRIBUTING.md를 참조하세요.

---

위의 모든 정보는 저장소의 README에서 직접 가져온 것입니다.