How billy1030/downloader works
Omnidrop is a cross-platform social-media downloader with both a Wails desktop UI and a CLI. Its main workflow is to inspect a submitted URL, let the user choose download options, enqueue work, and report progress and completed-file actions. The README documents platform extraction, authentication, settings, engine updates, and media playback. The sampled queue code confirms that the queue invokes the download engine; other backend wiring is not shown, so those relationships are left unverified rather than inferred.
Main entry points: app.go Desktop app API · main.go CLI · manager.go Download queue · downloader.go Media download
Components 24
Desktop interface
- React renderer
frontend/src/main.tsx - Downloader UI
frontend/src/App.tsx - Theme definitions
frontend/src/themes.ts - Wails bridge
frontend/src/wailsBridge.ts - Generated app bindings
frontend/wailsjs/go/main/App.js - Wails runtime
frontend/wailsjs/runtime/runtime.js
Application services
- Desktop app API
app.go - CLI
cmd/omnidrop-cli/main.go
Media engine
- Media data models
pkg/models/models.go - Binary detection
pkg/engine/detector.go - Platform detection
pkg/engine/platform.go - URL inspection
pkg/engine/inspector.go - Format handling
pkg/engine/formats.go - Media download
pkg/engine/downloader.go - Engine updater
pkg/engine/updater.go - Media playback
pkg/engine/player.go
Settings and queue
- Settings store
pkg/config/settings.go - Download queue
pkg/queue/manager.go - Task and event types
pkg/queue/types.go - File reveal
pkg/queue/reveal.go
Other components
- User
- Social platforms
- yt-dlp and FFmpeg
- Node.js
Connections 27
- User → React renderer: uses
README.md - React renderer → Downloader UI: renders
frontend/src/main.tsx - Downloader UI → Wails bridge: calls
frontend/src/App.tsx - Downloader UI → Theme definitions: uses
frontend/src/App.tsx - Wails bridge → Generated app bindings: invokes
frontend/src/wailsBridge.ts - Wails bridge → Wails runtime: uses
frontend/src/wailsBridge.ts - Generated app bindings → Desktop app API: dispatches to
- Desktop app API → Download queue: delegates to
- Desktop app API → URL inspection: delegates to
- Desktop app API → Settings store: reads settings
- CLI → Binary detection: detects tools
cmd/omnidrop-cli/main.go - CLI → Platform detection: detects platform
cmd/omnidrop-cli/main.go - CLI → URL inspection: inspects URL
cmd/omnidrop-cli/main.go - CLI → Media download: starts download
cmd/omnidrop-cli/main.go - CLI → Settings store: reads cookies
cmd/omnidrop-cli/main.go - Download queue → Platform detection: detects platform
pkg/queue/manager.go - Download queue → Media download: runs download
pkg/queue/manager.go - Download queue → Task and event types: manages tasks
- Download queue → Media data models: uses options and progress
pkg/queue/manager.go - URL inspection → Format handling: uses formats
- Media download → yt-dlp and FFmpeg: uses
- URL inspection → Social platforms: extracts metadata
- Media download → Social platforms: downloads from
- Media download → Node.js: solves challenges with
- Desktop app API → Engine updater: requests updates
- Desktop app API → Media playback: requests playback
- Desktop app API → File reveal: requests file reveal