Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎵 LyricStudio

다국어 가사 타임라인 편집, Gemini AI 기반 자동 싱크, 시네마틱 이펙트와 MP4 렌더링까지 - 가사 비디오 제작에 필요한 모든 워크플로를 하나의 데스크톱 프로그램 안에서 처리합니다.

LyricStudio 메인 편집 화면

🌐 웹 포트폴리오 사이트: lyricstudio.rmrf.kr · 🐙 쇼케이스 Repository: Project-Rmrf/LyricStudio


📺 실제 제작 결과물 둘러보기 (Live Showcases)

LyricStudio로 직접 제작하고 렌더링한 실제 가사 비디오 결과물을 확인해 보세요.

  • 🇯🇵 @LyricMontJ-POP 및 다국어 가사 비디오 결과물 (원어 · 독음 · 번역 3층 레이아웃)
  • 🇰🇷 @LyricNeo한국 인디(Indie) 음악 비디오 결과물 (Gemini AI 자동 싱크 & 파싱 워크플로 활용)

✨ 핵심 특징 (Key Highlights)

  • 🎧 삼중 다국어 가사 타임라인 (3-Tier Subtitle System)

    • 메인 가사(text), 발음 가이드(pronunciation), 원어 가사(original)를 동시에 관리 및 렌더링
    • Intro(도입부) ➔ Vocal Anchor ➔ Move(부드러운 스크롤) ➔ Skip(간주 압축) ➔ Outro 체계적인 구조화 타임라인 규칙 적용
  • 🤖 Google Gemini AI 어시스턴트 통합

    • 오디오 자동 싱크: 오디오 보컬 시작 시점(Vocal Onset) 자동 측정 및 타임스탬프 부여
    • 다언어 가사 파싱: 자유 텍스트 입력 시 원어/발음/번역 3층 레이아웃 자동 매핑
    • 지능형 프로필 배정: 자연어 지침 및 파트별 담당 가수 프로필 ID 자동 지정
    • 가사 정밀 교정: 띄어쓰기 및 오타 자동 정제
  • 🎬 WYSIWYG 실시간 프리뷰 & 고속 MP4 렌더링

    • PreviewWidget과 VideoRenderer가 동일한 SceneRenderer 로직을 사용하여 보는 그대로 100% 동일한 결과물 보장
    • Zero-Copy 멀티프로세스 인코더: ProcessPoolExecutor + Shared Memory(BGRA) 파이프라인으로 멀티코어 인코딩 수행
    • Standard (1080p) 및 Master Mode (1440p QHD) 고해상도 지원
  • 🎨 시네마틱 이펙트 & 비주얼라이저

    • Shake, Glitch, CRT, Invert, Flash, Zoom Pulse 등 15종 비디오 시각 이펙트
    • librosa 기반 64-band 멜 스펙트럼 비주얼라이저, 앨범아트 지배색 자동 추출, 가변 폰트(Pretendard JP Variable) 스크롤 효과

🏗 시스템 아키텍처 (Architecture)

LyricStudio Core Architecture
├── src/data/          # 프로젝트 데이터 모델, AI 연동, 가사 타임라인 규칙
│   ├── project.py     # project.json 메타데이터 및 스키마 보정
│   ├── ai_service.py  # Google Gemini API 비동기 워크플로
│   └── lyric_structure.py  # Intro/Outro/Move/Skip 구조화 타임라인 로직
│
├── src/gui/           # PySide6 Qt 기반 UI 컴포넌트
│   ├── main_window.py # 3단 메인 편집기 레이아웃
│   └── welcome_window.py # 프로젝트 선택 및 미디어 다운로더
│
└── src/render/        # WYSIWYG 장면 및 MP4 인코딩 파이프라인
    ├── scene_renderer.py  # QPainter 기반 16:9 프레임 렌더 엔진
    ├── video_renderer.py  # FFmpeg 프로세스 렌더 스레드
    └── turbo_pipeline.py  # Shared Memory BGRA Zero-Copy 인코더

🛠 기술 스택 & 구동 상세 (Tech Stack Details)

라이브러리 / 기술 적용 분야 핵심 구동 역할
Python 3.11 Core Architecture 애플리케이션 스키마, 타임라인 데이터 모델링 및 멀티프로세스 파이프라인 제어
PySide6 (Qt) Desktop GUI 3단 메인 편집 레이아웃, QPainter 프레임 렌더러, 커스텀 위젯 및 이벤트 루프
Google Gemini API AI Assistant 오디오 보컬 Onset 타임스탬프 자동 싱크, 다언어 레이아웃 매핑 및 가수 프로필 배정
librosa & NumPy Audio & Math 64-band 멜 스펙트럼 분석 데이터 추출 및 고속 수치 연산 처리
pygame Audio Engine 편집기 16:9 프리뷰와 연동되는 저지연 오디오 스트리밍 및 재생 모니터링
MoviePy & OpenCV Video & Image 비디오 프레임 추출, 앨범아트 오버레이 및 타임라인 미디어 클립 합성
Pillow (PIL) Image Processing 앨범아트 Center-Crop, 배경 블러 생성 및 지배색(Dominant Color) 자동 추출
FFmpeg Encoding Pipeline MP4 비디오 멀티프로세싱 내보내기 및 오디오 구간 슬라이싱
yt-dlp Media Downloader YouTube / SoundCloud URL 기반 320kbps MP3 음원 및 MP4 영상 가져오기

📄 저작권 및 비공개 안내 (Copyright & Notice)

Copyright © Project-Rmrf. All rights reserved.
본 프로젝트는 비공개 데스크톱 편집 프로그램으로, 프로그램 핵심 소스코드 및 알고리즘 구현체는 비공개(Closed Source)로 관리됩니다.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages