CinePrompt Studio - Cinematography Edition (v3.3)

Overview

CinePrompt Studio is a sophisticated AI-powered cinematography prompt generation tool designed for professional filmmakers, directors of photography, and visual artists. It generates highly detailed, technically accurate prompts for text-to-image AI systems, emphasizing deep texture, atmospheric quality, and cinematic lighting.

The application leverages Google's Gemini AI to transform creative concepts into comprehensive cinematography descriptions that incorporate:

• Professional camera bodies and cinema lenses
• Film stock characteristics and texture engines
• Advanced lighting techniques
• Atmospheric and environmental details
• Deep material and surface textures

Key Features

🎬 Professional Cinematography Tools

• 6 Cinema Cameras: ARRI ALEXA 65, RED V-RAPTOR 8K VV, Sony FX9, ARRI ALEXA Mini LF, Blackmagic URSA Mini Pro 12K, Panasonic Varicam Pure
• 7 Cinema Lenses: Panavision Primo 70, ARRI Master Prime, Cooke S7/i Full Frame Plus, Zeiss Supreme Prime, Canon CN-E Primes, Sigma Cine FF High Speed, Panavision C-Series Anamorphic
• Camera/Lens Compatibility Matrix: Intelligent filtering based on sensor formats

🎨 27 Application Presets Including:

• Documentary Styles: Ken Burns, Frederick Wiseman, Herzog, Errol Morris
• Drama Styles: Prestige Drama, Psychological Thriller, Period Piece
• Auteur Styles: Symmetrical Whimsy, IMAX Scale Epic, Clinical Thriller, Gothic Fantasy, Dreamlike Memory, Neon Noir, Raw Documentary, Mythic Western, Surreal Drama
• Commercial Styles: Product Beauty, Fashion Editorial, Automotive, Music Video

🎭 Advanced Features

• Film Stock & Texture Engine: Deep texture generation for photorealistic materials
• Smart Fill System: Contextual detail generation with Creative Freedom slider (0.0-1.0)
• Focus Physics Toggle: Switch between Realism and Stylistic rendering
• Master System Prompt: Emphasis on TEXTURE, ATMOSPHERE, and LIGHT

🔧 Technical Capabilities

• Real-time prompt preview with syntax highlighting
• Copy-to-clipboard functionality
• Responsive dark theme UI
• Comprehensive tooltip information for all equipment
• AI-optimized prompt generation via Gemini API

Installation

Prerequisites

• Node.js 18.0 or higher
• npm or yarn package manager
• Google Gemini API key

Setup Instructions

1. Clone the repository

git clone git@bitbucket.org:zlalani/sb-prompt-studio.git
cd sb-prompt-studio

2. Install dependencies

npm install
# or
yarn install

3. Configure environment variables Create a .env file in the root directory:

VITE_GEMINI_API_KEY=your_gemini_api_key_here

4. Start the development server

npm run dev
# or
yarn dev

5. Build for production

npm run build
# or
yarn build

Configuration

Gemini API Setup

1. Visit Google AI Studio
2. Generate an API key
3. Add the key to your .env file
4. Ensure the key has proper permissions for generative AI requests

Camera/Lens Compatibility

The application enforces sensor format compatibility:

• Full Frame: Compatible with all lenses
• Super 35: Limited to S35-compatible lenses
• Large Format: Requires large format lenses
• Vista Vision: Specific lens requirements

Usage Guide

Basic Workflow

1. Enter Creative Concept: Describe your scene or vision
2. Select Application: Choose from 27 preset styles
3. Choose Camera & Lens: System filters compatible options
4. Configure Settings:
   • Film Stock & Texture (if applicable)
   • Focus Physics (Realism vs Stylistic)
   • Creative Freedom (0.0-1.0 slider)
5. Generate Prompt: Click to create AI-optimized description
6. Copy & Use: Copy the generated prompt for your AI image generator

Advanced Tips

• Texture Emphasis: Version 3.0+ focuses heavily on material textures
• Lighting Details: Each application includes specific lighting setups
• Smart Fill: Higher Creative Freedom values add more contextual details
• Auteur Styles: Pre-configured with specific camera/lens pairings for consistency

Technical Architecture

Technology Stack

• Frontend Framework: React 18.3 with Hooks
• Build Tool: Vite 6.0
• Styling: Tailwind CSS
• AI Integration: Google Generative AI (Gemini)
• Icons: Lucide React
• State Management: React useState/useEffect

Component Structure

src/
├── components/
│   └── CinePromptStudio.jsx  # Main application component
├── main.jsx                   # Application entry point
├── index.css                  # Global styles
└── App.jsx                    # Root component wrapper

Key Functions

• generateOptimizedPrompt(): Core AI prompt generation
• getSmartFillContext(): Contextual detail generation
• getCameraTextureKeywords(): Camera-specific texture mapping
• getAspectRatioProse(): Format-specific descriptions
• getNegativeConstraints(): Quality control parameters

Version History

v3.3 (Current)

• Updated camera/lens pairings based on stress testing
• Symmetrical Whimsy now uses Cooke S7/i
• Gothic Fantasy now uses Panavision C-Series

v3.1

• Added 9 new Auteur Style applications
• Expanded Smart Fill context system
• Enhanced texture descriptions

v3.0

• Major pivot to pure text-to-image generation
• Removed all image reference features
• Added Film Stock & Texture Engine
• Deep emphasis on TEXTURE, ATMOSPHERE, and LIGHT

v2.0

• Initial refactor with Master Logic document
• Camera/lens compatibility matrix
• Creative Freedom slider
• Reference image support (removed in v3.0)

Development

Local Development

# Install dependencies
npm install

# Start dev server
npm run dev

# Run build
npm run build

# Preview production build
npm run preview

Project Structure

CinePrompt_Studio/
├── src/               # Source code
├── public/            # Static assets
├── LOGO/             # Logo files
├── TESTS/            # Test files (gitignored)
├── .env              # Environment variables (gitignored)
├── package.json      # Dependencies
├── vite.config.js    # Vite configuration
└── README.md         # This file

License

Proprietary - All rights reserved

Support

For issues, feature requests, or questions, please contact the development team or submit an issue to the Bitbucket repository.

---

CinePrompt Studio - Bringing cinematic vision to AI-generated imagery through the power of professional cinematography knowledge.