How nathanmbr/telegram-videos-uploader works
This is a Node.js/TypeScript CLI for uploading videos to Telegram. Its main workflow loads settings, lets the user choose a preset, initializes that preset’s database, then presents actions; uploading checks Telegram connectivity, prepares video files and metadata, uploads video segments, and records results. The README also documents both official and self-hosted Bot API use. Edges reflect the shown boot and upload calls, repository database operations, and Telegram API requests; unsampled use-case internals are represented without inferred call flows.
Main entry points: boot.ts Application boot · UploadVideosUsecase.ts Video upload · VideoUploadsRepository.ts Upload records · VideosRepository.ts Video records
Components 21
CLI entry and control
- Application boot
src/main/boot.ts
Video workflows
- Action menu
src/usecases/MenuUsecase.ts - Preset details
src/usecases/PrintPresetInfoUsecase.ts - Video details
src/usecases/PrintVideoInfoUsecase.ts - Availability listing
src/usecases/PrintVideosByAvailabilityUsecase.ts - Video upload
src/usecases/UploadVideosUsecase.ts - Video editing
src/usecases/EditVideoUsecase.ts - Video deletion
src/usecases/DeleteVideoUsecase.ts
Services and integrations
- Settings loader
src/services/resources/SettingsService.ts - Interactive CLI
src/services/resources/cli/ClackCLIService.ts - Video processing
src/services/resources/VideosService.ts - Telegram operations
src/services/resources/TelegramService.ts
Domain and persistence
- Preset model
src/domain/Preset.ts - Video metadata
src/domain/VideoMetadata.ts - Video records
src/repositories/VideosRepository.ts - Upload records
src/repositories/VideoUploadsRepository.ts - Database connection
src/db/DrizzleConnection.ts - Video tables
src/db/schemas/videosTable.ts - Upload tables
src/db/schemas/videoUploadsTable.ts
Other components
- CLI user
- Telegram Bot API
Connections 23
- CLI user → Application boot: starts
README.md - Application boot → Settings loader: loads settings
src/main/boot.ts - Application boot → Interactive CLI: selects preset
src/main/boot.ts - Application boot → Database connection: runs migrations
src/main/boot.ts - Application boot → Action menu: executes menu
src/main/boot.ts - Application boot → Preset details: registers action
src/main/boot.ts - Application boot → Video details: registers action
src/main/boot.ts - Application boot → Availability listing: registers action
src/main/boot.ts - Application boot → Video upload: registers action
src/main/boot.ts - Application boot → Video editing: registers action
src/main/boot.ts - Application boot → Video deletion: registers action
src/main/boot.ts - Video upload → Telegram operations: checks and uploads
src/usecases/UploadVideosUsecase.ts - Video upload → Video processing: processes videos
src/usecases/UploadVideosUsecase.ts - Video upload → Video records: reads and updates
src/usecases/UploadVideosUsecase.ts - Video upload → Upload records: records uploads
src/usecases/UploadVideosUsecase.ts - Telegram operations → Telegram Bot API: calls Bot API
src/services/resources/TelegramService.ts - Video records → Database connection: queries through
src/repositories/VideosRepository.ts - Video records → Video tables: reads and writes
src/repositories/VideosRepository.ts - Upload records → Database connection: queries through
src/repositories/VideoUploadsRepository.ts - Upload records → Upload tables: reads and writes
src/repositories/VideoUploadsRepository.ts - Upload records → Video tables: joins
src/repositories/VideoUploadsRepository.ts - Video upload → Video metadata: uses metadata
src/usecases/UploadVideosUsecase.ts - Application boot → Preset model: selects configured preset
src/main/boot.ts