Dashclip-Delivery
Notice
Starting with v4.0, this project follows a Domain-Driven Design (DDD) light architecture.
Learn more about Domain-Driven Design:
https://domainlanguage.com/ddd/
Project Description
Dashclip-Delivery is a neutral, multi-channel submission and distribution system for dashcam and other
user-generated video content.
It is designed for people who regularly submit the same videos to multiple YouTube channels and need a reliable,
automated workflow for managing, tracking, and distributing their content.
Instead of acting as an upload portal for a single channel, Dashclip-Delivery provides an independent,
automated delivery pipeline that serves both submitters and channel operators:
- Videos are ingested from a local folder or Dropbox and automatically deduplicated.
- All clips are processed, previewed, and stored on a configurable storage backend.
- Content is then fairly distributed to participating channels based on quotas, weighting, and availability.
- Channels receive signed, time-limited offer links and can download clips individually or as ZIP bundles.
- All downloads, returns, expirations, and interactions are logged for full transparency.
Dashclip-Delivery is ideal for multi-channel submitters, YouTube channel operators, and anyone who needs a
structured, automated, and privacy-conscious distribution workflow.
A public API is planned to enable external automations and custom integrations.
Features
-
Ingest & Deduplication
Recursive scanning (local or Dropbox) with SHA-256 hashing to prevent duplicate video entries.
-
Fair Distribution Engine
Weighted round-robin assignment with optional weekly quotas to ensure balanced distribution across all channels.
-
Offer & Notification System
Automatic emails with signed offer links, reminder notifications, and detailed logging of all mail events.
-
Offer Page & Downloads
Channels can preview clips, download individual videos, or generate ZIP packages including a metadata info.csv.
-
Preview Generation
Automatic MP4 preview creation via FFmpeg with configurable compression and scaling.
-
Dropbox Integration
OAuth-based linking with automatic token refresh and support for large uploads.
-
Return Workflow
Channels can decline or return unwanted clips; the system logs all decisions and redistributes clips if necessary.
-
Full Audit Logging
Every action—from ingest to distribution, downloads, returns, and mail events—is recorded for complete transparency.
Prerequisites
- PHP 8.4
- Composer
- Node.js & npm (for building assets)
- ffmpeg
- A Laravel-supported database (e.g., SQLite)
- Optional: Dropbox app with Client ID and Secret
Installation
cp .env.example .env
composer install
npm install
php artisan key:generate
php artisan storage:link --relative
php artisan migrate
storage:link publishes uploaded files such as channel logos. Without it they are stored
but never reachable over the web.
Useful Commands
| Command | Description |
|---|
php artisan assign:distribute | Distributes videos to channels. |
php artisan notify:offers | Sends offer links via email. |
php artisan assign:expire | Marks expired assignments and temporarily blocks channels. |
php artisan dropbox:refresh-token | Refreshes the Dropbox token. |
php artisan weekly:run | Executes Expire → Distribute → Notify in sequence. |
Documentation
Detailed explanations of structure and usage can be found in the docs directory:
Tests
This project is tested with BrowserStack.
Local unit and feature tests:
composer test
License
This project is dual-licensed:
See the respective license files for details.
Contact for commercial licensing: [email protected]
Copyright
Copyright (c) 2025 Ilya Beliaev
This project includes code licensed under AGPL-3.0.
