How duixcom/duix-avatar works
Duix.Avatar is an Electron desktop app for managing avatar models and creating synthesized videos. The main user flow is to choose or create a model, prepare text or uploaded media and voice settings, then preview or produce a video. The renderer, main-process services, and local database are visible in sampled code; the README describes offline cloning and synthesis capabilities, but implementation details for several stages were not sampled. FFmpeg headers are included as a bundled media API surface, not evidence of specific application calls.
Main entry points: service/index.js Service Registry · VideoEditView.vue Video Editor · ffmpeg.js FFmpeg Utility · main/index.js Electron Main
Components 25
Desktop Interface
- App Shell
src/renderer/src/App.vue - Home & Models
src/renderer/src/views/home/index.vue - Model Creation
src/renderer/src/components/model-create/ModelCreateView.vue - Video Editor
src/renderer/src/views/video-edit/VideoEditView.vue - Text & Voice
src/renderer/src/views/video-edit/edit/EditText.vue - Media Upload
src/renderer/src/views/video-edit/edit/EditUpload.vue - Video Preview
src/renderer/src/views/video-edit/preview/PreviewView.vue - Renderer API
src/renderer/src/api/index.js
Main Process
- Electron Main
src/main/index.js - IPC Handlers
src/main/handlers/index.js - Service Registry
src/main/service/index.js - Context Service
src/main/service/context.js
Media Capabilities
- Video Synthesis
src/main/service/video.js - Model Management
src/main/service/model.js - Voice Services
src/main/service/voice.js - TTS API
src/main/api/tts.js - FFmpeg Utility
src/main/util/ffmpeg.js - Codec API
resources/ffmpeg/win-amd64/include/libavcodec/avcodec.h - Format & I/O API
resources/ffmpeg/win-amd64/include/libavformat/avio.h - Media Utility API
resources/ffmpeg/win-amd64/include/libavutil/avutil.h
Local State
- SQLite Database
src/main/db/index.js - Context DAO
src/main/dao/context.js - Schema & Migrations
src/main/db/sql.js
Other components
- Creator
- Local Inference
Connections 25
- Creator → Home & Models: browses
README.md - Creator → Model Creation: creates model
README.md - Creator → Video Editor: prepares video
README.md - Video Editor → Text & Voice: edits script
- Video Editor → Media Upload: adds media
- Video Editor → Video Preview: previews result
- App Shell → Renderer API: loads context
src/renderer/src/App.vue - Electron Main → SQLite Database: initializes
src/main/index.js - Electron Main → Service Registry: registers services
src/main/index.js - Electron Main → IPC Handlers: registers handlers
src/main/index.js - IPC Handlers → Service Registry: routes requests
- Service Registry → Video Synthesis: registers
- Service Registry → Model Management: registers
- Service Registry → Voice Services: registers
- Service Registry → Context Service: registers
- Context Service → Context DAO: uses
src/main/service/context.js - Context DAO → SQLite Database: queries
src/main/dao/context.js - SQLite Database → Schema & Migrations: applies migrations
src/main/db/index.js - Video Synthesis → Local Inference: invokes synthesis
README.md - Model Management → Local Inference: uses model runtime
README.md - Voice Services → TTS API: uses speech
- Video Synthesis → FFmpeg Utility: processes media
- FFmpeg Utility → Codec API: uses codec API
- FFmpeg Utility → Format & I/O API: uses format API
- FFmpeg Utility → Media Utility API: uses utility API