How naeem5877/vibedownloader-desktop works
VibeDownloader is a local-first desktop media downloader with a React interface, an Electron main process, and a browser extension. The principal workflow is selecting or inspecting media, configuring a download, and saving the result; distinct capabilities include lyrics, subtitles, stories, Spotify metadata, trimming, and extension-triggered downloads. The graph also shows the yt-dlp/FFmpeg and file-organization layer. Some implementation files were not sampled, so unverified UI-to-handler and extension-to-desktop links are dashed.
Main entry points: infoHandler.ts Media info handler · downloadHandler.ts Download handler · main.ts Electron main · Downloader.tsx Downloader UI
Components 26
Desktop interface
- App shell
src/App.tsx - Downloader UI
src/components/Downloader.tsx - Cut timeline
src/components/CutTimeline.tsx - Lyrics panel
src/components/LyricsPanel.tsx - Settings UI
src/components/Settings.tsx - Onboarding
src/components/Onboarding.tsx
Electron orchestration
- Electron main
electron/main.ts - Preload bridge
electron/preload.ts
Media workflows
- Download handler
electron/handlers/downloadHandler.ts - Media info handler
electron/handlers/infoHandler.ts - Story retrieval
electron/utils/instagramStories.ts - Facebook stories
electron/utils/facebookStories.ts - Lyrics handler
electron/handlers/lyricsHandler.ts - Lyrics lookup
electron/utils/lyrics/index.ts - Lyrics formatting
electron/utils/lyrics/format.ts - Spotify metadata
electron/utils/spotify.ts - Subtitle handling
electron/utils/subtitles.ts
Local services
- Media binaries
electron/utils/binaries.ts - Settings and folders
electron/utils/paths.ts - Music tags
electron/utils/musicTags.ts - Extension setup
electron/utils/extensionInstaller.ts
Browser extension
- Browser extension
extension/background.js - Platform detectors
extension/platforms/shared.js
Other components
- User
- Supported platforms
- Local media files
Connections 31
- User → App shell: uses
README.md - App shell → Downloader UI: renders
src/App.tsx - App shell → Onboarding: renders
src/App.tsx - Downloader UI → Cut timeline: renders
src/components/Downloader.tsx - Downloader UI → Lyrics panel: renders
src/components/Downloader.tsx - Downloader UI → Settings UI: renders
src/components/Downloader.tsx - Downloader UI → Preload bridge: requests
- Electron main → Preload bridge: exposes bridge
- Electron main → Download handler: registers
electron/main.ts - Electron main → Media info handler: registers
electron/main.ts - Electron main → Settings and folders: loads settings
electron/main.ts - Electron main → Media binaries: prepares downloader
electron/main.ts - Download handler → Media binaries: prepares tools
electron/handlers/downloadHandler.ts - Download handler → Settings and folders: reads settings
electron/handlers/downloadHandler.ts - Download handler → Music tags: embeds tags
electron/handlers/downloadHandler.ts - Download handler → Local media files: writes downloads
- Media info handler → Media binaries: uses yt-dlp
electron/handlers/infoHandler.ts - Media info handler → Spotify metadata: fetches metadata
electron/handlers/infoHandler.ts - Media info handler → Facebook stories: fetches stories
electron/handlers/infoHandler.ts - Media info handler → Story retrieval: fetches stories
electron/handlers/infoHandler.ts - Media info handler → Subtitle handling: uses subtitles
electron/handlers/infoHandler.ts - Media info handler → Supported platforms: inspects media
README.md - Lyrics panel → Lyrics handler: requests lyrics
- Lyrics handler → Lyrics lookup: looks up lyrics
electron/handlers/lyricsHandler.ts - Lyrics handler → Lyrics formatting: formats export
electron/handlers/lyricsHandler.ts - Lyrics lookup → Lyrics formatting: normalizes results
electron/utils/lyrics/index.ts - Browser extension → Platform detectors: uses detectors
- User → Browser extension: installs extension
README.md - Browser extension → Download handler: sends download
- Extension setup → Browser extension: sets up extension
- Supported platforms → Browser extension: hosts controls
README.md