YouTube List Maker
최종 수정일:
YouTube List Maker는 사용자가 입력한 가수 이름 또는 검색어를 기반으로 YouTube 및 YouTube Music에서 열 수 있는 음악 재생 링크를 만들어 주는 앱입니다.
본 앱은 앱 자체 계정을 만들지 않으며, Google 로그인 또는 YouTube 계정 로그인을 요구하지 않습니다. 또한 사용자의 YouTube 계정에 재생목록을 직접 생성하거나 저장하지 않습니다.
주요 기능
- YouTube / YouTube Music 임시 재생목록 링크 생성
- 기본 10곡
- 최대 30곡
- Shorts 제외
- 120초 미만 영상 제외
- 중복 곡 제거
- 공식 음원 / Topic / 공식 MV 우선
- 서버 메모리 캐시
- Known Artist 사전 등록
- Cloud Run 저비용 배포
사용 방법
- 앱에서 가수 이름 또는 검색어를 입력합니다.
- 생성할 곡 개수를 입력합니다.
- 재생 링크 생성 버튼을 누릅니다.
- 생성된 곡 목록을 확인합니다.
- YouTube 또는 YouTube Music에서 엽니다.
서비스 정보
- 앱 이름: YouTube List Maker
- 플랫폼: Android
- 가격: 무료
- 문의: sicorp.apps@gmail.com
프로젝트 구조
YouTube List Maker: Flutter 앱과 Node.js API 서버로 구성된 Android 앱.
youtube-list-maker-app- Flutter Android 앱
- 사용자 입력, 결과 표시, 링크 열기 담당
youtube-list-maker-api- Node.js Express API
- YouTube 검색, 필터링, 링크 생성 담당
- Google Cloud Run
- API 서버 배포
- Google Play Console
- Android 앱 배포
- GitHub Pages
- 개인정보처리방침 페이지 제공
사용한 주요 기술
| 구분 | 기술 |
|---|---|
| 앱 | Flutter, Dart |
| Android 배포 | Android App Bundle .aab, Play Console |
| API 서버 | Node.js, Express |
| HTTP 요청 | Axios |
| 배포 | Docker, Google Cloud Run |
| 외부 API | YouTube Data API v3 |
| 문서/정책 | GitHub Pages |
| 인증/배포 설정 | Android Keystore, Play App Signing |
현재 앱 동작 방식
1. 사용자 입력
사용자가 앱에서 다음 정보를 입력한다.
- 가수 이름
- 곡 개수(기본 10개, 최대 30개)
2. Flutter 앱에서 API 요청
Flutter 앱은 Cloud Run에 배포된 API 서버로 요청을 보낸다.
3. API 서버에서 가수 확인
API는 먼저 입력된 가수가 미리 등록된 Known Artist 목록에 있는지 확인한다.
Known Artist 예시:
- 아이유
- BTS
- 뉴진스
- 화사
- BLACKPINK
- IVE
- aespa
- LE SSERAFIM
- SEVENTEEN
- 임영웅
- 송가인
4. 미리 등록된 영상 우선 사용
등록된 가수라면 미리 저장된 공식 음원/뮤직비디오 ID를 우선 사용한다.
이 방식의 장점:
- YouTube API quota 절약
- 응답 속도 개선
- 검색 품질 안정화
- 공식 음원 위주 결과 제공
5. 부족하면 YouTube API 검색 사용
Known Artist 목록에 없거나 결과가 부족하면 YouTube Data API를 사용한다.
이때 다음 기준으로 필터링한다.
- Shorts 제외
- 120초 미만 영상 제외
- 가사 영상 제외
- 커버 영상 제외
- 팬 영상 제외
- 리액션 영상 제외
- 티저 / 트레일러 제외
- Official Audio 우선
- Topic 채널 우선
- 공식 MV 우선
- 공식 채널 영상 우선
6. 중복 제거
같은 곡이 여러 형태로 나오는 경우를 필터링한다.
예:
- Official Audio
- Official MV
- Performance Video
- Topic 영상
- Lyrics 영상
API는 제목을 정규화해서 같은 곡으로 판단되는 결과를 중복 제거한다.
7. 임시 재생목록 링크 생성
최종 영상 ID 목록으로 YouTube 임시 재생목록 링크를 만든다.
저장형 재생목록이 아니라, 사용자가 바로 열 수 있는 링크 방식으로 제공한다.
8. YouTube / YouTube Music 링크 제공
- YouTube에서 열기
- YouTube Music에서 열기
YouTube Music 링크는 단순 watch_videos 방식이 아니라, YouTube 임시 목록을 실제 watch?v=...&list=... 형태로 변환한 뒤 Music 도메인으로 바꿔서 제공한다.
9. Flutter 앱에서 결과 표시
앱은 다음을 보여준다.
- 곡 목록
- 썸네일
- 제목
- 영상 ID
- YouTube에서 열기 버튼
- YouTube Music에서 열기 버튼
- 링크 복사 버튼
비용 절감 구조
Cloud Run 설정:
| 항목 | 설정 |
|---|---|
| min instances | 0 |
| max instances | 1 |
| memory | 256Mi |
| cpu | 1 |
| concurrency | 10 |
| CPU throttling | enabled |
| timeout | 120초 |
비용 절감 방법:
- 저장형 재생목록 생성 제거
- Google 로그인 제거
- YouTube API 호출 최소화
- Known Artist 목록 우선 사용
- 서버 메모리 캐시 사용
- Cloud Run 최소 인스턴스 0 유지
- 최대 인스턴스 1로 제한