How toannguyen-exe/autocut works
AutoCut is a video-editing studio for turning lecture recordings into transcript-based sections, topics, and exportable clips. The user workflow runs from the studio interface through video APIs to transcript/segment operations, then cutting and export; persistence and cloud storage support those operations. A separate Python AI workflow transcribes and refines speech. The README is empty, and frontend-to-backend wiring is not shown in the sampled files, so that connection is marked unverified; unsampled UI capabilities are represented by their source paths.
Main entry points: page.tsx Studio workspace · VideoController.java Video endpoints · cli.py AI processing CLI · VideoRepository.java Video repositories
Components 29
Studio interface
- Studio workspace
frontend/src/app/page.tsx - Video library
frontend/src/components/VideoLibraryColumn.tsx - Transcript and scenes
frontend/src/components/TranscriptScenesPanel.tsx - Studio timeline
frontend/src/components/StudioTimeline.tsx - Segment review
frontend/src/components/ReviewTable.tsx - Video preview
frontend/src/components/VideoPlayerPreview.tsx - Export progress
frontend/src/components/ExportProgressModal.tsx - AI assistant
frontend/src/components/AiAssistantChatPanel.tsx - Frontend API client
frontend/src/lib/api.ts - Assistant chat routes
frontend/src/app/api/chat/route.ts
Video API
- Video endpoints
backend/src/main/java/com/autocut/controller/VideoController.java
Transcript and segmentation
- Cut-point analysis
backend/src/main/java/com/autocut/service/CutPointService.java - Segment persistence
backend/src/main/java/com/autocut/service/SegmentPersistenceService.java - Transcript and segment models
backend/src/main/java/com/autocut/dto/Models.java - Video repositories
backend/src/main/java/com/autocut/repository/VideoRepository.java - Video and transcript records
backend/src/main/java/com/autocut/entity/VideoEntity.java
Cutting and storage
- Batch cut jobs
backend/src/main/java/com/autocut/service/BatchVideoCutService.java - Video cutter
backend/src/main/java/com/autocut/video/VideoCutter.java - R2 object storage
backend/src/main/java/com/autocut/service/CloudflareR2Service.java
AI transcription
- AI processing CLI
backend/ai/cli.py - Whisper transcription
backend/ai/whisper_service.py - Groq transcription
backend/ai/groq_service.py - Transcript refinement
backend/ai/transcript_refiner.py - Transcript cleanup
backend/ai/post_processor.py - AI transcript models
backend/ai/models.py - Gemini transcription
backend/ai/gemini_transcriber.py
Other components
- Studio user
- Application database
- Cloudflare R2
Connections 28
- Studio user → Studio workspace: uses
- Studio workspace → Video library: presents
- Studio workspace → Transcript and scenes: presents
- Studio workspace → Studio timeline: presents
- Studio workspace → Segment review: presents
- Studio workspace → Video preview: presents
- Studio workspace → Export progress: presents
- Studio workspace → Frontend API client: requests data
- Frontend API client → Video endpoints: calls endpoints
- AI assistant → Assistant chat routes: uses
- Video endpoints → Cut-point analysis: calls
backend/src/main/java/com/autocut/controller/VideoController.java - Video endpoints → Segment persistence: persists segments
backend/src/main/java/com/autocut/controller/VideoController.java - Video endpoints → Batch cut jobs: starts cut jobs
backend/src/main/java/com/autocut/controller/VideoController.java - Video endpoints → Transcript and segment models: uses DTOs
backend/src/main/java/com/autocut/controller/VideoController.java - Video endpoints → Video repositories: reads videos
backend/src/main/java/com/autocut/controller/VideoController.java - Segment persistence → Video repositories: reads and writes
backend/src/main/java/com/autocut/service/SegmentPersistenceService.java - Video repositories → Video and transcript records: stores
backend/src/main/java/com/autocut/repository/VideoRepository.java - Video repositories → Application database: queries
- Batch cut jobs → Video cutter: cuts clips
backend/src/main/java/com/autocut/service/BatchVideoCutService.java - Batch cut jobs → R2 object storage: uploads exports
backend/src/main/java/com/autocut/service/BatchVideoCutService.java - R2 object storage → Cloudflare R2: stores objects
backend/src/main/java/com/autocut/service/CloudflareR2Service.java - AI processing CLI → Whisper transcription: transcribes audio
backend/ai/cli.py - AI processing CLI → Transcript refinement: refines transcript
backend/ai/cli.py - AI processing CLI → Transcript cleanup: cleans transcript
backend/ai/cli.py - Whisper transcription → Groq transcription: uses cloud fallback
backend/ai/whisper_service.py - Transcript refinement → Transcript cleanup: uses cleanup
backend/ai/transcript_refiner.py - Transcript refinement → AI transcript models: uses models
backend/ai/transcript_refiner.py - AI processing CLI → Gemini transcription: supports transcription
backend/ai/cli.py