📸 Snappie

[Logo/Cover Image]

📆 2025. 06 - 진행 중

완성도 있는 숏폼 영상을 쉽고 간편하게 만들고 싶은 사용자가,
반복 촬영에서도 여백과 구도를 일관되게 유지할 수 있도록,
직전 프레임 윤곽선와 위치 및 각도 맞춤 피드백을 제공해 영상을 완성하도록 도와주자.

• 가이드 기반 촬영: 기존 영상 편집 앱과 달리 촬영 단계부터 가이드 제공
• 원터치 완성: 복잡한 편집 과정 없이 촬영만으로 완성도 높은 영상 제작
• 실시간 피드백: 촬영 중 실시간으로 구도 및 포즈 가이드 제공
• 직관적 UX: 전문 지식 없이도 누구나 쉽게 사용할 수 있는 인터페이스있는 인터페이스

🎆 Screenshots

🖼️ Demo

클립 촬영	클립 편집	가이드 생성	가이드로 촬영 및 피드백

영상 합치기 및 내보내기	프로젝트 편집
	(추가 예정)

📌 Features

📹 스마트 가이드 기반 촬영 시스템

• 실루엣 오버레이 가이드: 이전 영상의 사람 윤곽선을 반투명 오버레이로 표시하여 정확한 동작 연결 촬영 지원
• 바운딩 박스 가이드: Vision 프레임워크 기반 실시간 사람 감지 및 위치 가이드 제공
• 기울기 가이드: CoreMotion 프레임워크 기반 자이로스코프 센서를 활용한 실시간 카메라 각도 측정 및 기록
• 실시간 피드백: 가이드와 현재 샷이 일치할 때 시각적 신호로 완벽한 촬영 타이밍 안내
  • 오버레이 가이드 위치와 가이드 시점의 기울기가 현재 프레임과 일치할 때

🎥 카메라 기능

• 카메라 전환: 전면/후면 카메라 전환
• 줌 조절: 핀치제스처 확대/축소 (0.5x~6.0x)
• 플래시: 자동/켜기/끄기 선택 가능
• 타이머: 3초, 5초, 10초 타이머 기능
• 격자선: 구도 잡기를 도와주는 3분할 가이드
• 터치 포커스: 화면 터치로 초점 조정 기능
• 고해상도 지원: 1080p, 4K 영상 지원
• 클립 병합기능 : 여러 클립을 하나의 영상으로 자동 결합
• 갤러리 저장: 완성된 영상을 바로 사진 앱에 저장

✂️ 영상 편집

• 타임라인 편집기 : 시작과 끝 지점 조정으로 간단한 편집 인터렉션 제공
• 프레임 정확도: 드래그 핸들로 시작/끝점을 프레임 단위로 조정
• 구간 반복 재생: 선택된 구간만 미리보기로 간단한 편집 확인

🎬 효율적인 멀티플로우로 프로젝트 관리

• 통합 프로젝트: 여러 클립을 하나의 프로젝트로 체계적 관리
• 자동 메타데이터: 촬영 시간 기반 제목 생성 및 첫 프레임 커버 이미지
• 시각적 프로젝트 목록: 커버, 제목, 길이, 생성일로 빠른 프로젝트 식별
• 신규 알림 시스템: 확인하지 않은 프로젝트 뱃지로 놓치지 않기

🎨 방해없는 몰입형 촬영 인터페이스

• 미니멀 UI: 투명도를 활용해 촬영 화면을 가리지 않는 인터페이스
• 말차 테마: 눈에 편안한 녹색 계열의 세련된 디자인
• 다크 모드: 저조도 촬영 환경 대응 다크 테마 적용
• KronaOne 타이포: 명확한 가독성의 커스텀 폰트 시스템

🛠 기술 스택

개발 환경

• UI 프레임워크: SwiftUI 5.0
• 최소 iOS 버전: 17.0+
• Swift 버전: 5.9
• 아키텍처: MVVM 패턴
• Navigation: Navigation Path 관리
• 데이터 지속성: SwiftData
• 프레임워크: AVFoundation, PhotoKit, CoreImage, Vision, CoreMotion

정확한 촬영을 위한 가이드 기술

• Vision 프레임워크: 사람 윤곽선 추출 및 실시간 사람 감지
• CoreImage: 인물 윤곽선 추출에 활용
• CoreMotion: 자이로스코프 센서 데이터 활용 기울기 감지

데이터 관리

• SwiftData: 로컬 데이터베이스로 프로젝트/클립 정보 관리
• UserDefaults: 사용자 설정 및 상태 정보 저장
• 파일 시스템: 영상 파일의 효율적인 로컬 저장 및 관리

🌳 Folder

📱 Snappie
├── 🏗️ App
│   ├── ChalkakApp.swift
│   └── Coordinator.swift
├── 🔧 Common
│   ├── Component
│   ├── DesignSystem
│   ├── Extension
│   └── Util
├── ⚡ Core
│   ├── CameraKit
│   ├── Guide
│   └── VideoEditor
├── 💾 Data
│   ├── Model
│   └── SwiftDataManager.swift
├── 🎨 Presentation
│   ├── Camera
│   ├── ClipEdit
│   ├── Guide
│   ├── ProjectEdit
│   ├── ProjectList
│   └── ProjectPreview
└── 📦 Resource
    ├── Assets.xcassets
    ├── Fonts
    └── sample-video.mov

🫂 Contributors

@alice0047	@bishoe01	@msseock	@pearhyunjin	@JM0307	@hemging
- 영상 첫 프레임에서 윤곽선 추출 및 저장 - 클립 트리밍 기능 구현 - 개별 클립 편집 뷰 구현	- 카메라 촬영 기능 구현 - 공통 Alert 컴포넌트 구현	- 디자인시스템 구현 - 기울기 관련 기능 - 영상 병합 기능	- 프로젝트 기본 셋팅 - Navigation 흐름 관리 - Vision 이용한 위치/거리 피드백 - 프로젝트 편집 기능	- 유저 플로우 - 화면·컴포넌트 디자인 - 앱 컨셉 기획 및 디자인 - 디자인 스타일 정의	- 앱 컨셉 및 핵심 기능 기획 - 유저 플로우 및 와이어프레임 설계 - 화면별 기능·인터랙션 정의 - UX 문구 작성