System Requirements Document (SRD)

Project Name: magma-media

1. Introduction

The magma-media project is a cutting-edge platform designed to revolutionize the creation of short, engaging video reels. This system is tailored to meet the needs of both businesses and individual creators, with a special focus on the Indian market. By leveraging Python for backend processing and HTML for front-end interactivity, magma-media aims to deliver a seamless, user-friendly experience for generating high-quality video content.

This document outlines the system requirements for the magma-media project, with a specific focus on the "Auto Video Reel Generator" module. The platform will integrate advanced features such as multi-language voiceovers, customizable templates, and social sharing capabilities to cater to a diverse user base.

2. System Overview

The magma-media system is a modular platform that simplifies the process of creating professional-grade video reels. Users can upload media, select templates, add overlays, and export videos in various formats. The system is designed to be intuitive and accessible, with built-in automation for rendering and customization.

Key features include:

• Media upload and template selection.
• Advanced video rendering with 2D, 3D, and animation support.
• Multi-language voiceovers tailored for the Indian market.
• Export options for popular reel formats (9s, 15s, 30s).
• Social sharing capabilities for platforms like WhatsApp, Facebook, and Instagram.

The system will be built using Python for backend processing and HTML for the front-end interface, ensuring a robust and scalable architecture.

3. Functional Requirements

• As a User, I should be able to upload images and videos for reel creation.
• As a User, I should be able to select templates for both images and videos (e.g., car-themed templates).
• As a User, I should be able to add text and price overlays to my video reels.
• As a User, I should be able to add music and voiceovers, including built-in music, custom music, and a music library similar to InShot.
• As a User, I should be able to use multi-language voiceovers, supporting all Indian languages.
• As a User, I should be able to export reels in 9s, 15s, and 30s formats.
• As a User, I should be able to share my reels on WhatsApp, Facebook, and Instagram.
• As an Admin, I should be able to manage templates and music through a dedicated admin panel.

4. User Personas

1. Individual Creators

   • Goal: Create personalized video reels for social media.
   • Needs: Easy-to-use templates, multi-language voiceovers, and quick export options.

2. Small Businesses

   • Goal: Create promotional video reels for marketing.
   • Needs: Customizable overlays, professional templates, and social sharing capabilities.

3. Admins

   • Goal: Manage templates, music, and system configurations.
   • Needs: A dedicated admin panel for efficient management.

5. Visuals Colors and Theme

The visual identity of magma-media will be vibrant and dynamic, reflecting the energy of short video reels.

Color Palette:

• Background: #1A1A2E (Deep Midnight Blue)
• Surface: #16213E (Dark Navy)
• Text: #E94560 (Vivid Coral Red)
• Accent: #0F3460 (Steel Blue)
• Muted: #53354A (Muted Plum)

6. Signature Design Concept

The magma-media homepage will feature an interactive storyboard interface.

Concept Details:

• Visuals: The homepage will resemble a dynamic film reel, with each "frame" representing a feature or module. Users can scroll horizontally through the reel to explore different sections.
• Animations: Each frame will animate into view with a smooth sliding effect, accompanied by subtle sound effects resembling a film projector.
• Interactions: Hovering over a frame will expand it slightly, revealing more details about the feature. Clicking on a frame will transition the user to the corresponding module.
• Background: A subtle, animated gradient will shift colors based on the time of day, creating a dynamic and immersive experience.
• Micro-interactions: Buttons and icons will have playful, bounce-like animations to enhance user engagement.

This design will make the homepage unforgettable and set the tone for the rest of the platform.

7. Non-Functional Requirements

• The system must support high-performance video rendering for 2D, 3D, and animation.
• The platform should be optimized for mobile and desktop browsers.
• The system must support multi-language voiceovers with minimal latency.
• The admin panel should be secure and accessible only to authorized users.

8. Tech Stack

• Frontend:

  • React for Web

• Backend:

  • Python
  • FastAPI

• Database (RDBMS):

  • MySQL with Alembic for migrations

• AI Models:

  • Google Nano Banana for image generation
  • GPT 5.4 for user-friendly responses

• AI Tools:

  • Langchain
  • Litellm for LLM Routing

• Local Orchestration:

  • Docker
  • docker-compose

9. Assumptions and Constraints

• The system assumes users have a stable internet connection for uploading media and exporting reels.
• The platform will primarily target the Indian market, with multi-language support for Indian languages.
• The system will be web-based, accessible via modern browsers.
• Video rendering may require significant server resources, necessitating scalable cloud infrastructure.

10. Glossary

• Reel: A short video, typically used for social media platforms.
• Overlay: Text or graphics added on top of a video.
• Multi-language Voiceovers: Audio narration available in multiple languages.
• Admin Panel: A backend interface for managing system configurations.