• 목록

YouTube Playlist Manager Pro는

YouTube API를 기반으로 계정 내 재생목록을 대량 정리·백업·편집할 수 있는 데스크톱 애플리케이션입니다.

프로그램 사용 전 필요한 초기 API 설정과 주요 기능 사용법을 정리한 가이드입니다.

1. 시작 전 필수 설정 (Google Cloud Console API & OAuth 연동)

YouTube 데이터 수정 및 계정 연동을 위해 최초 1회 Google Cloud 설정이 필요합니다.

• 프로젝트 생성 및 API 활성화:

  1. Google Cloud Console에 로그인 후 새 프로젝트를 생성합니다.

  2. API 및 서비스 > 라이브러리로 이동하여 YouTube Data API v3를 검색하고 [사용 설정]을 클릭합니다.

• OAuth 동의 화면 설정:

  1. OAuth 동의 화면에서 User Type을 외부(External)로 선택합니다.

  2. 앱 이름과 이메일을 입력한 후, 범위(Scope) 단계에서 [https://www.googleapis.com/auth/youtube](https://www.googleapis.com/auth/youtube)를 추가합니다.

  3. 테스트 사용자(Test Users) 목록에 본인의 YouTube 구글 계정 이메일을 반드시 등록합니다.

• 클라이언트 ID 발급:

  1. 사용자 인증 정보 > 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 선택합니다.

  2. 애플리케이션 유형을 데스크톱 앱(Desktop App)으로 선택하여 생성합니다. (웹 애플리케이션 유형일 경우 승인된 리디렉션 URI에 http://localhost:8080/ 추가)

  3. 발급된 Client ID와 Client Secret을 복사합니다.

• 프로그램 로그인 연동:

  1. 프로그램 실행 후 상단 메뉴 Settings > Preferences를 엽니다.

  2. 발급받은 Client ID와 Client Secret을 입력하고 [Sign in with Google]을 클릭합니다.

  3. 브라우저에서 계정 로그인 및 권한을 허용하면 연동이 완료됩니다.

2. 화면 구성 및 주요 인터페이스

3. 주요 기능별 상세 사용법

재생목록 탐색 및 관리

• 불러오기: 드롭다운에서 재생목록을 선택하면 백그라운드에서 영상 목록과 썸네일, 음악/영상 구분을 자동 로드합니다.

• 새 목록 생성 / 삭제: New PL 버튼을 눌러 새 비공개 목록을 만들거나, Delete PL로 현재 목록을 완전 삭제할 수 있습니다.

• 이름 변경: Name 입력창의 텍스트를 수정한 뒤 Save (Rename)을 누르면 YouTube에 실시간 반영됩니다.

재생목록 자동 정리 (청소 기능)

• 중복 영상 제거 (Deduplicate): 중복 제거 버튼을 누르면 목록 내 비디오 ID 중복을 탐색해 1개만 남기고 나머지를 일괄 삭제합니다.

• 삭제/비공개 영상 청소 (Clean Dead): 원본이 삭제되었거나 비공개로 전환된 재생불가 영상을 찾아 한 번에 정리합니다.

항목 순서 변경 및 추가

• 영상 순서 이동: 변경할 영상을 1개 선택한 후 ▲ 위로 또는 ▼ 아래로 버튼을 누르면 재생 순서가 즉시 변경됩니다.

• Add Item (영상 추가):

  • 개별 영상: YouTube 영상 URL 또는 11자리 Video ID를 입력하여 추가합니다.

  • 재생목록 일괄 복사: 다른 공개/비공개 재생목록의 URL이나 Playlist ID를 입력하면 포함된 모든 영상을 현재 목록으로 가져옵니다.

실시간 검색 및 브라우저 연동

• 실시간 필터링: 우측 상단 Search 창에 단어를 입력하면 타이핑 즉시 제목 및 채널명이 일치하는 영상만 필터링됩니다.

• 더블클릭 실행:

  • URL 컬럼 더블클릭: 기본 브라우저에서 해당 YouTube 영상이 바로 재생됩니다.

  • Channel 컬럼 더블클릭: 기본 브라우저에서 해당 채널 홈 페이지로 이동합니다.

우클릭 메뉴 (복사 및 이동)

• 목록에서 영상을 마우스 우클릭하면 컨텍스트 메뉴가 열립니다.

• Copy to Playlist로 다른 내 재생목록에 복사하거나, Move to Playlist를 통해 현재 목록에서 삭제하면서 대상 목록으로 이동시킬 수 있습니다.

데이터 백업 및 복원 (Import / Export)

• Export: 현재 재생목록 메타데이터를 JSON 또는 엑셀 호환 CSV 파일로 로컬 PC에 백업합니다.

• Import: 백업해 둔 JSON 파일을 불러와 현재 재생목록에 일괄 등록합니다.

4. 단축키 및 기타 팁

• 다중 선택: Ctrl + 클릭으로 개별 다중 선택, Shift + 클릭으로 범위 선택이 가능합니다.

• 언어 변경: 상단 메뉴 Settings > Language에서 한국어, English, 日本語, 中文(간체)으로 실시간 전환할 수 있습니다.

• 안전한 종료: 프로그램 삭제(언인스톨) 시 로컬에 캐시된 토큰(token.json)과 설정 파일(config.json)이 완전히 삭제되므로 개인 계정 정보가 남지 않습니다