SoraPlanner

A native macOS application for creating and managing AI-generated videos using OpenAI's Sora-2 video generation API.

Overview

SoraPlanner provides an intuitive, native macOS interface for working with OpenAI's Sora-2 video generation platform. Create videos from text prompts, monitor generation progress in real-time, and manage your video library all from a clean, modern SwiftUI application.

Features

• Prompt Library Management: Create, edit, and organize reusable video generation prompts with persistent storage
• Modal Video Generation: Launch video generation from prompts or create new videos on-demand
• Model Selection: Choose between Sora-2 (0.10/s) or Sora-2 Pro (0.30-0.50/s) models with different quality levels
• Flexible Duration Options: Choose between 4, 8, or 12-second videos with real-time cost estimation
• Configurable Output Resolution: Select from multiple resolution presets including standard (720x1280, 1280x720) and high-resolution options (1024x1792, 1792x1024) for Pro model
• Advanced Options UI: Collapsible advanced settings section for model and resolution configuration
• Real-Time Progress Tracking: Monitor your video generation with live status updates
• Video Library Management: View all your generated videos with detailed metadata
• Integrated Video Playback: Watch your videos directly within the app with seamless looping
• Secure API Key Management: Store your OpenAI API key securely in macOS Keychain via Settings tab

Setup

Requirements

• macOS 26.0 or later
• Xcode 14.0 or later
• OpenAI API key with Video API access

Installation

1. Clone the repository

   git clone https://github.com/yourusername/SoraPlanner.git
   cd SoraPlanner

2. Build and Run

   • Open SoraPlanner.xcodeproj in Xcode
   • Press Cmd+R to build and run

3. Configure API Key

   The application requires an OpenAI API key for authentication.

   Preferred Method: Settings Tab (Secure Keychain Storage)

   • Launch the application
   • Navigate to the Settings tab
   • Enter your OpenAI API key in the secure field
   • Click "Save API Key"
   • The key is encrypted and stored in macOS Keychain
   • Persists between app launches

   Alternative Method: Environment Variable (Legacy)

   For development or backward compatibility, you can use an environment variable:

   • Via Xcode Scheme: Go to Product > Scheme > Edit Scheme... > Run > Arguments tab > Environment Variables, add OPENAI_API_KEY with your key
   • Via Shell Profile: Add export OPENAI_API_KEY="your-api-key-here" to ~/.zshrc or ~/.bash_profile and restart Xcode

   Note: Keychain storage takes precedence if both methods are configured.

Pricing: Video generation costs vary by model:

• Sora-2: $0.10 per second
• Sora-2 Pro (standard resolutions): $0.30 per second
• Sora-2 Pro (high-resolution): $0.50 per second

Real-time cost estimates are displayed in the generation interface based on your selected options.