홈페이지>프로그래밍 관련>기타 소스코드
다운로드

Sunnify (스포티파이 다운로더)

Sunnify는 전체 재생 목록을 Mac/Linux/Windows PC에 로컬로 다운로드할 수 있는 Spotify 다운로더 애플리케이션입니다.

써니파이 로고

프로그램 시연

다음은 내 개인 Spotify 재생 목록을 다운로드하면서 Sunnify 애플리케이션이 작동하는 모습을 보여주는 스크린샷입니다.

다운로드 진행 중그리고

설치

전제 조건

  • 시스템에 Python 3.6 이상이 설치되어 있습니다. 설치되어 있지 않은 경우 python.org에서 Python을 다운로드하여 설치하세요.
  • Python의 패키지 관리자인 pip가 설치되어 있는지 확인합니다. 일반적으로 Python과 함께 제공됩니다. 터미널에서 pip --version 실행하여 확인할 수 있습니다.

Sunnify 실행 파일(Windows)

Windows를 사용하는 경우 여기에서 실행 파일을 직접 다운로드할 수 있습니다.

소스에서 빌드

저장소를 복제합니다. 

git clone https://github.com/sunnypatell/sunnify-spotify-downloader.git

프로젝트 디렉터리로 이동합니다. 

 cd sunnify-spotify-downloader

필요한 종속성을 설치합니다. 

pip install -r req.txt

애플리케이션을 실행합니다. 

python Spotify_Downloader.py

용법

  1. Sunnify 애플리케이션을 실행합니다.
  2. 제공된 입력 필드에 Spotify 재생 목록 URL을 입력하세요.
  3. 진행 상황을 보려면 미리보기 표시 상자를 선택하세요.
  4. 표지 아트, 작가, 앨범, 출시일 등을 다운로드하려면 메타데이터 상자를 확인하세요.
  5. 다운로드를 시작하려면 URL 필드에 Enter를 누르세요.
  6. 다운로드한 노래는 미디어 디렉터리(소스나 실행 파일이 있는 위치)에 저장됩니다.

사용된 라이브러리

Sunnify는 다음 Python 라이브러리를 활용합니다.

  • PyQt5: GUI 인터페이스에 사용됩니다.
  • webbrowser: Spotify 네트워크 트래픽 감지를 우회하는 데 사용됩니다.
  • 요청: HTTP 요청을 만드는 데 사용됩니다.
  • mutagen.id3: ID3 태그 편집 및 메타데이터 스크랩에 사용됩니다.

일반적인 디버깅

Sunnify를 실행하는 동안 문제가 발생하면 다음 단계를 시도해 보십시오.

  1. 인터넷 연결이 안정적인지 확인하세요.
  2. 올바른 Spotify 재생 목록 URL을 입력했는지 확인하세요.
  3. Sunnify에 사용 가능한 업데이트가 있는지 확인하세요. 저장소에서 최신 변경 사항을 가져오고 종속성을 다시 설치할 수 있습니다. git pull

Web App 실행(Windows 데스크톱 버전을 사용하지 않는 경우)

Sunnify 웹 앱을 로컬에서 실행하려면 다음 단계에 따라 백엔드와 프런트엔드를 모두 설정하세요.

백엔드 설정(Sunnify 백엔드)

  1. 터미널에서 web-app/sunnify-backend 디렉터리로 이동합니다. 

     cd web-app/sunnify-backend

  2. 아직 완료하지 않은 경우 필수 종속성을 설치합니다. 

    pip install -r requirements.txt

  3. 백엔드 서버를 실행합니다. 

    python app.py

    또는 다음을 사용할 수 있습니다. 

    python -m app.py

    그러면 http://127.0.0.1:5000 에서 백엔드가 시작됩니다.

    백엔드는 Flask를 사용하여 API 엔드포인트를 생성하고 Flask-CORS를 사용하여 CORS(Cross-Origin Resource Sharing)를 처리함으로써 프런트엔드와 통신하여 서로 다른 도메인에 걸쳐 프런트엔드와 백엔드 간의 API 요청을 허용합니다.

프런트엔드 설정(Sunnify 웹 클라이언트)

  1. 백엔드가 실행되면 web-app/sunnify-webclient 디렉터리로 이동합니다. 

     cd ../sunnify-webclient

  2. 필요한 프런트엔드 종속성을 설치합니다. 

    npm install

  3. 프런트엔드 개발 서버를 시작합니다. 

    npm run dev

    이제 프런트엔드는 http://localhost:3000 에서 로컬로 실행되며 http://127.0.0.1:5000 에서 백엔드와 통신할 수 있습니다.

사용된 기술

프런트엔드 기술:

  • ⚛️ React : 사용자 인터페이스 구성 요소를 구축하는 데 사용됩니다.
  • Next.js : 서버 측 렌더링 및 라우팅을 위한 프레임워크를 제공합니다.
  • ? Tailwind CSS : 스타일 지정 및 반응형 디자인에 사용됩니다.
  • ? shadcn/ui : 사전 구축된 사용자 정의 가능한 UI 구성 요소를 제공합니다.
  • ? Lucide React : 애플리케이션 전체의 아이콘에 사용됩니다.
  • React Hooks : 상태 관리 및 부작용에 활용됩니다.
  • Fetch API : 백엔드에 HTTP 요청을 하는 데 사용됩니다.
  • Web Audio API : 오디오 재생 기능을 위해 구현되었습니다.

백엔드 기술:

  • ? Flask : API 엔드포인트를 생성하기 위한 Python 웹 프레임워크입니다.
  • ? Flask-CORS : API 요청에 대한 CORS(Cross-Origin Resource Sharing)를 처리합니다.
  • ? 요청 : 재생 목록 데이터를 가져오기 위해 HTTP 요청을 만드는 데 사용됩니다.
  • ? Mutagen : ID3 태그 편집 및 메타데이터 스크랩에 사용됩니다.
  • ?️ BeautifulSoup : 웹 스크래핑 및 HTML 콘텐츠 구문 분석에 사용됩니다.
  • ? UUID : 추적 및 분석 프로세스에 대한 고유 ID를 생성합니다.
  • ‍♂️ User-Agent : 실제 브라우저 활동을 에뮬레이트하여 보호 메커니즘을 우회합니다.
  • ? Selenium : 브라우저 자동화 및 사용자 상호 작용 에뮬레이션에 사용됩니다.
  • ? FFmpeg : 오디오 변환 및 처리를 처리합니다.

주요 특징

  • CORS 처리 : 교차 출처 요청을 안전하게 허용하도록 구현되었습니다.
  • ? ID 생성 : 추적 및 분석 프로세스를 위해 고유 ID가 생성됩니다.
  • ?️ 브라우저 헤더 에뮬레이션 : 감지를 피하기 위해 실제 브라우저 헤더를 모방합니다.
  • 재생 목록 메타데이터 검색 : 재생 목록 정보를 가져오고 처리합니다.
  • ?️ 웹 스크래핑 : 웹페이지에서 필요한 데이터를 추출합니다.
  • ? ‍ 실제 브라우저 활동 에뮬레이션 : 인간과 유사한 탐색 패턴을 시뮬레이션합니다.
  • 사용자 에이전트 교체 : 차단을 방지하기 위해 사용자 에이전트 문자열을 정기적으로 변경합니다.
  • ?️ Flask 라우팅 : 다양한 기능에 대한 다양한 API 엔드포인트를 처리합니다.
  • ⚡ 비동기 처리 : 동시 다운로드 및 처리 작업을 관리합니다.
  • 오류 처리 : 다양한 시나리오에 대한 강력한 오류 관리.

중요사항

Sunnify의 백엔드는 무료 컴퓨팅 계획에 따라 Render에서 호스팅됩니다. 한동안 렌더 호스팅 백엔드에 대한 API 호출이 없는 경우 프런트엔드가 요청(예: 재생 목록 다운로드)을 보낼 때 "잠자기" 상태가 되고 깨어나는 데 잠시 시간이 걸릴 수 있습니다. 백엔드가 활성화되어 요청을 처리하는 데 몇 초 정도 걸릴 수 있으므로 잠시 기다려 주십시오.

출시 예정

저는 현재 다운로드한 음악을 iOS 장치로 원활하게 전송하고 특히 Apple Music 라이브러리에 추가하기 위해 Sunnify를 iTunes와 통합하는 작업을 진행 중입니다. 또한 다운로드한 음악을 Android 장치로 직접 전송할 수 있도록 Android 파일 시스템에 대한 지원을 추가하는 작업도 진행 중입니다.

Sunnify의 기능을 향상하고 다양한 플랫폼의 사용자에게 보다 원활한 경험을 제공할 흥미로운 업데이트를 계속 지켜봐 주시기 바랍니다.

⚖️법적 및 윤리적 고지⚖️

Sunnify(Spotify 다운로더)는 교육 목적으로만 사용됩니다. 해당 국가 또는 지역의 저작권법 및 규정을 준수하는 것은 귀하의 책임입니다. 적절한 승인 없이 저작권이 있는 음악을 다운로드하는 것은 특정 관할권에서는 불법일 수 있습니다.

작가

Sunnify(Spotify 다운로더)는 Sunny Jayendra Patel이 개발하고 유지 관리합니다. 문의사항, 제안 또는 피드백이 있는 경우 [email protected]으로 Sunny에게 문의하세요.

특허

이 프로젝트는 맞춤형 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

기여

버그가 발생하거나 기능 요청이 있거나 개선 사항에 기여하고 싶다면 언제든지 GitHub에 풀 요청을 제출하세요.

보고 문제

Sunnify를 사용하는 동안 문제가 발생하면 GitHub에서 문제를 열어주세요. 문제를 재현하는 단계와 발생한 오류 메시지를 포함하여 문제에 대한 자세한 정보를 포함하십시오. 귀하의 피드백은 다른 모든 사람들을 위해 애플리케이션을 개선하는 데 도움이 됩니다.

확장하다
추가 정보
관련 애플리케이션
추천
관련 정보 전체