Skip to content

chatman-media/timeline-studio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3,539 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Timeline Studio

🎬 AI-Powered Video Editor β€’ πŸš€ Multi-Platform Export β€’ ⚑ GPU Acceleration

🎬 About the Project

What is Timeline Studio?

Timeline Studio is a next-generation professional video editor with AI integration that automates content creation for social media. Built on modern technologies (Tauri + Next.js), it combines the power of desktop applications with the convenience of web interfaces.

🎯 Key Advantages

  • πŸ€– 100+ AI Tools - complete video production automation with multi-provider support
  • ⚑ GPU Acceleration - hardware encoding NVENC, QuickSync, VideoToolbox
  • πŸ”Œ Plugin System - extend functionality without changing code
  • 🌐 15 Language Interface - complete localization for global audience with RTL support
  • πŸ”’ Local Processing - your content stays private
  • πŸ“Š 80%+ Test Coverage - professional-level reliability

πŸš€ Problems We Solve

One upload β†’ dozens of ready versions:

  • πŸ“± TikTok - vertical shorts with trending effects (direct upload)
  • πŸ“Ί YouTube - full movies, short clips, Shorts (direct upload)
  • 🎬 Vimeo - high-quality cinematic versions (direct upload)
  • ✈️ Telegram - optimized versions for channels and chats (direct upload)
  • πŸ“Έ Instagram - Reels, Stories, posts optimized for manual upload

πŸ’‘ How It Works

"Create a video about my trip to Asia for all social media" - and in minutes you have ready variants: dynamic shorts for TikTok, atmospheric vlog for YouTube, bright Stories for Instagram. AI selects the best moments, syncs with music and adapts for each platform.

⚑ Why This Changes Everything

  • 10x Time Savings - no more manual adaptation for each video
  • AI Understands Trends - knows what works on each social network
  • Professional Quality - using the same tools as major studios
  • Modular Architecture - easily add new features through plugins
  • Open Source - transparency and ability to participate in development

Timeline Interface #1

πŸ—οΈ Architecture

Timeline Studio is built on modern modular architecture:

Frontend (Next.js 15 + React 19)

  • Feature-based organization - each function in /src/features/ is self-contained
  • State Management - XState v5 for complex states
  • UI Components - shadcn/ui + Radix UI + Tailwind CSS v4
  • TypeScript - strict typing and safety

Backend and Headless Runtime

  • Rust workspace - crates/* owns schema, render, media analysis, montage, publish and the timeline CLI
  • TypeScript workspaces - packages/core, packages/domains, packages/adapters, packages/ui
  • Desktop host - Tauri v2 remains the desktop shell over the shared runtime
  • Headless entrypoints - render-job, bot-workflow, bot-worker and Rust timeline

πŸ“š Detailed Frontend Architecture β†’ πŸ“š Detailed Backend Architecture β†’ πŸ“š Plugin System β†’ πŸ› οΈ Technical Stack Details β†’

πŸ€– AI Integration

Timeline Studio features comprehensive AI integration with 100+ specialized tools:

AI Providers

  • Claude (Anthropic) - Primary AI with advanced reasoning
  • OpenAI - GPT-4 models for diverse tasks
  • DeepSeek - Specialized reasoning models
  • Ollama - Local models for offline operation

AI Tool Categories

  • Timeline Tools (50) - Intelligent project creation and editing
  • Media Analysis (27) - Scene detection, quality analysis, content intelligence
  • Audio Processing (12) - Transcription, noise removal, music sync
  • Export Optimization (12) - Platform-specific adaptations
  • Effects & Filters (10) - AI-powered visual enhancements
  • And 40+ more specialized tools

πŸ“š AI Chat Documentation β†’ πŸ› οΈ AI Tools Reference β†’

πŸ“š Runtime Documentation

Timeline Studio uses a modular Rust + TypeScript workspace architecture. Desktop, CLI and bot/headless workflows share the same contracts where possible.

Headless and Contracts

πŸ“š External Headless Contracts - supported ProjectSchema, Rust timeline, render-job, bot-workflow, bot-worker and bot-cleanup entrypoints πŸ€– Bot-First Production Contract - Telegram AI review state, restart, retry, cleanup and Rust publish boundary πŸ§ͺ Telegram AI Review Sandbox Smoke - mocked and real sandbox validation path

Architecture

🧱 Package Boundaries - workspace ownership and import boundaries πŸ” Root Compatibility Shims - temporary root paths and migration criteria πŸ¦€ Rust Backend Architecture - Rust/Tauri architecture and technology overview

src-tauri remains a desktop host/glue layer. External consumers should use the documented headless entrypoints instead of importing desktop internals.

πŸ—οΈ Project Status

πŸš€ Alpha version: 97.5% ready 🎯

βœ… Completed: modular Rust workspace, TypeScript workspaces and bot-first/headless contract hardening πŸ“‹ Recently Completed:

  • πŸ“¦ Phase F TypeScript Workspaces - core, domains, adapters, ui, apps/desktop and apps/cli
  • πŸ€– Bot-first Telegram AI Review - upload, preview, text/voice/video-note revisions, approval and publish
  • 🧱 Phase G Headless Contracts - supported external entrypoints, package boundaries and root shim migration path
  • βœ… Green main CI - build, frontend tests, bot/AI headless tests and Node lint after Phase G merge

β†’ Detailed Roadmap

Getting Started

Quick Setup

# Clone and install
git clone https://github.com/chatman-media/timeline-studio.git
cd timeline-studio
bun install

# Run development mode
bun run tauri dev

Requirements

  • Node.js v24+, Rust, Bun, FFmpeg

πŸš‘ Troubleshooting Common Issues

FFmpeg Not Found

# macOS
brew install ffmpeg
export ORT_DYLIB_PATH=/opt/homebrew/lib/libonnxruntime.dylib

# Windows - use setup script
./scripts/setup-rust-env-windows.ps1

# Linux
sudo apt-get install ffmpeg libavcodec-dev libavformat-dev

Build Failures

  • Windows: Ensure Visual Studio 2022 with C++ tools is installed
  • macOS: Install Xcode Command Line Tools: xcode-select --install
  • Linux: Install build essentials: sudo apt-get install build-essential

πŸ“š Complete Installation Guide β†’ πŸͺŸ Windows Setup β†’ πŸŽ₯ Video Tutorial β†’ πŸ“– Full Documentation β†’ - Complete documentation with 18+ sections

Development

Quick Start

# Development mode
bun run tauri dev

# Run tests
bun run test && bun run test:rust

# Check code quality
bun run check:all

πŸ“š Complete Development Guide β†’

CI/CD & Code Quality

Automated Workflows

  • βœ… Linting: ESLint, Stylelint, Clippy
  • βœ… Testing: Frontend (Vitest), Backend (Rust), E2E (Playwright)
  • βœ… Coverage: Codecov integration
  • βœ… Build: Cross-platform builds

πŸ“š Detailed CI/CD Guide β†’ πŸ”§ Linting & Formatting β†’

πŸ‘¨β€πŸ’» Developer Resources

Contributing to Timeline Studio

Plugin Development

Testing & Quality

🌐 Community & Support

Join Our Community

Telegram Discord X YouTube

Get Help

Project Roadmap

Support the Project

🀝 Contributors

Thank you to all the amazing people who have contributed to Timeline Studio:

πŸ’Ž Sponsors

Timeline Studio is supported by these amazing sponsors:

🌟 Gold Sponsors

alagiz alexk984 andreypeulskiy gerusm

Special thanks to our generous crypto sponsors who have contributed $1,000+ to the project development!

Support πŸ’πŸš€

Support the development via crypto donations:

BTC
BTC QR Code
14s9Y9Rb2CUWHSAatiQMhfkpx1MWXofUzw
ETH
ETH QR Code
0x286D65151b622dCC16624cEd8463FDa45585fd60
TON
TON QR Code
UQD1M80nPyzph5ZW1vfp_r19XI5MaerNhDq4dWXbXCo96WFj
NOT
NOT QR Code
UQD1M80nPyzph5ZW1vfp_r19XI5MaerNhDq4dWXbXCo96WFj

Star History

Star History Chart

Repo Activity

Alt

License

MIT License with Commons Clause - free for personal use, commercial use requires agreement.

πŸ“„ Full License Details β†’ | πŸ“§ Commercial License: ak.chatman.media@gmail.com