slidemovie 0.1.0__tar.gz

slidemovie-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Katsutoshi Seki (関 勝寿)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

slidemovie-0.1.0/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: slidemovie
+Version: 0.1.0
+Summary: Markdown and PowerPoint to narration video generator
+Author: Katsutoshi Seki
+License-Expression: MIT
+Project-URL: Homepage, https://sekika.github.io/slidemovie/
+Project-URL: Source, https://github.com/sekika/slidemovie
+Keywords: powerpoint,markdown,video,tts,presentation,automation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Office/Business :: Office Suites
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: multiai-tts
+Requires-Dist: pptxtoimages
+Dynamic: license-file
+
+# slidemovie
+
+[![PyPI version](https://badge.fury.io/py/slidemovie.svg)](https://badge.fury.io/py/slidemovie)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Documentation](https://img.shields.io/badge/docs-github.io-blue)](https://sekika.github.io/slidemovie/)
+
+**Markdown and PowerPoint to Narration Video Generator.**
+
+`slidemovie` is a Python tool that automates the creation of professional narration videos. By combining the structural simplicity of **Markdown**, the design capabilities of **PowerPoint**, and the power of **AI Text-to-Speech**, you can produce high-quality videos without any video editing software.
+
+---
+
+## 📚 Documentation
+
+**For full tutorials, installation guides, and configuration details, please visit:**
+
+👉 **[https://sekika.github.io/slidemovie/](https://sekika.github.io/slidemovie/)**
+
+---
+
+## ✨ Features
+
+*   **Markdown-Based**: Write your slide content and narration script in a single text file.
+*   **AI Narration**: Automatically generates natural voiceovers using **Google Gemini** or **OpenAI** (via `multiai-tts`).
+*   **PowerPoint Integration**: Use PowerPoint's AI "Designer" to create professional visuals instantly.
+*   **No Video Editing**: Audio and visuals are automatically synchronized.
+*   **Incremental Builds**: Only regenerates changed slides to save time and API costs.
+
+## 🎥 Demo
+
+**Watch a video generated entirely by slidemovie:**
+[https://www.youtube.com/watch?v=9ZscwE06Pbo](https://www.youtube.com/watch?v=9ZscwE06Pbo)
+
+## 🚀 Quick Start
+
+### 1. Install
+
+```bash
+pip install slidemovie
+```
+
+*Note: You also need to install **FFmpeg**, **Pandoc**, **LibreOffice**, and **Poppler**, and set up your **AI API Key** (Google or OpenAI). See the [documentation](https://sekika.github.io/slidemovie/installation.html) for details.*
+
+### 2. Create a Project
+
+Create a Markdown file (e.g., `demo.md`):
+
+```markdown
+# Slide Title
+
+- Bullet point 1
+- Bullet point 2
+
+::: notes
+This text will be read aloud by the AI narrator.
+:::
+```
+
+### 3. Generate Slides
+
+Convert Markdown to a draft PowerPoint file:
+
+```bash
+slidemovie demo -p
+```
+
+Open `demo.pptx` in PowerPoint, apply a design, and save it.
+
+### 4. Build Video
+
+Generate the final video with AI narration:
+
+```bash
+slidemovie demo -v
+```
+
+The output will be saved in `movie/demo/demo.mp4`.
+
+## 📄 License
+
+MIT License

slidemovie-0.1.0/README.md

@@ -0,0 +1,81 @@
+# slidemovie
+
+[![PyPI version](https://badge.fury.io/py/slidemovie.svg)](https://badge.fury.io/py/slidemovie)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Documentation](https://img.shields.io/badge/docs-github.io-blue)](https://sekika.github.io/slidemovie/)
+
+**Markdown and PowerPoint to Narration Video Generator.**
+
+`slidemovie` is a Python tool that automates the creation of professional narration videos. By combining the structural simplicity of **Markdown**, the design capabilities of **PowerPoint**, and the power of **AI Text-to-Speech**, you can produce high-quality videos without any video editing software.
+
+---
+
+## 📚 Documentation
+
+**For full tutorials, installation guides, and configuration details, please visit:**
+
+👉 **[https://sekika.github.io/slidemovie/](https://sekika.github.io/slidemovie/)**
+
+---
+
+## ✨ Features
+
+*   **Markdown-Based**: Write your slide content and narration script in a single text file.
+*   **AI Narration**: Automatically generates natural voiceovers using **Google Gemini** or **OpenAI** (via `multiai-tts`).
+*   **PowerPoint Integration**: Use PowerPoint's AI "Designer" to create professional visuals instantly.
+*   **No Video Editing**: Audio and visuals are automatically synchronized.
+*   **Incremental Builds**: Only regenerates changed slides to save time and API costs.
+
+## 🎥 Demo
+
+**Watch a video generated entirely by slidemovie:**
+[https://www.youtube.com/watch?v=9ZscwE06Pbo](https://www.youtube.com/watch?v=9ZscwE06Pbo)
+
+## 🚀 Quick Start
+
+### 1. Install
+
+```bash
+pip install slidemovie
+```
+
+*Note: You also need to install **FFmpeg**, **Pandoc**, **LibreOffice**, and **Poppler**, and set up your **AI API Key** (Google or OpenAI). See the [documentation](https://sekika.github.io/slidemovie/installation.html) for details.*
+
+### 2. Create a Project
+
+Create a Markdown file (e.g., `demo.md`):
+
+```markdown
+# Slide Title
+
+- Bullet point 1
+- Bullet point 2
+
+::: notes
+This text will be read aloud by the AI narrator.
+:::
+```
+
+### 3. Generate Slides
+
+Convert Markdown to a draft PowerPoint file:
+
+```bash
+slidemovie demo -p
+```
+
+Open `demo.pptx` in PowerPoint, apply a design, and save it.
+
+### 4. Build Video
+
+Generate the final video with AI narration:
+
+```bash
+slidemovie demo -v
+```
+
+The output will be saved in `movie/demo/demo.mp4`.
+
+## 📄 License
+
+MIT License

slidemovie-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "slidemovie"
+version = "0.1.0"
+description = "Markdown and PowerPoint to narration video generator"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+authors = [
+    {name = "Katsutoshi Seki"}
+]
+keywords = ["powerpoint", "markdown", "video", "tts", "presentation", "automation"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Education",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+    "Topic :: Office/Business :: Office Suites",
+]
+dependencies = [
+    "multiai-tts",
+    "pptxtoimages"
+]
+
+[project.urls]
+Homepage = "https://sekika.github.io/slidemovie/"
+Source = "https://github.com/sekika/slidemovie"
+
+[project.scripts]
+slidemovie = "slidemovie.cli:main"
+
+[tool.setuptools]
+packages = ["slidemovie"]

slidemovie-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

slidemovie-0.1.0/setup.py

@@ -0,0 +1,3 @@
+from setuptools import setup
+
+setup()

slidemovie-0.1.0/slidemovie/__init__.py

@@ -0,0 +1,3 @@
+from .core import Movie
+
+__all__ = ["Movie"]

slidemovie-0.1.0/slidemovie/cli.py

@@ -0,0 +1,171 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+import argparse
+import sys
+import logging
+import slidemovie
+
+# Logging configuration
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s [%(levelname)s] %(message)s',
+    datefmt='%Y-%m-%d %H:%M:%S'
+)
+logger = logging.getLogger(__name__)
+
+def main():
+    """
+    Entry point for the slidemovie command-line tool.
+
+    This function parses command-line arguments to control the `slidemovie.Movie` class,
+    which generates narration videos from Markdown and PowerPoint files.
+
+    Workflow:
+    1.  Parse arguments (project name, modes, options).
+    2.  Initialize the `Movie` class (loads default/config settings).
+    3.  Override settings based on CLI arguments (TTS options, debug mode).
+    4.  Configure project paths based on structure (flat or subproject).
+    5.  Execute the requested action:
+        - `--pptx`: Generates a draft PowerPoint from Markdown.
+        - `--video`: Generates the full narration video (TTS, images, stitching).
+
+    Usage:
+        slidemovie PROJECT_NAME [--pptx] [--video] [options...]
+    """
+    parser = argparse.ArgumentParser(
+        description="Automated tool to generate narration videos from Markdown and PowerPoint."
+    )
+
+    # --- Positional Arguments ---
+    parser.add_argument(
+        "project_name",
+        help="Project Name (ID). If in subproject mode (--sub), this is the parent project name."
+    )
+
+    # --- Action Control Options ---
+    parser.add_argument(
+        "-p", "--pptx",
+        action="store_true",
+        help="Generate PPTX from Markdown (Drafting mode)."
+    )
+    parser.add_argument(
+        "-v", "--video",
+        action="store_true",
+        help="Generate all video assets from Markdown and PPTX (Build mode)."
+    )
+
+    # --- Path & Project Structure Options ---
+    parser.add_argument(
+        "-s", "--source-dir",
+        default=".",
+        help="Directory containing source files (md, pptx). Default is current directory."
+    )
+    parser.add_argument(
+        "--sub",
+        metavar="SUB_NAME",
+        help="Subproject name (Child folder name). If specified, runs in hierarchical mode."
+    )
+    parser.add_argument(
+        "-o", "--output-root",
+        help="Root directory for video output. If not specified, determined automatically."
+    )
+    parser.add_argument(
+        "-f", "--filename",
+        help="Output video filename (without extension). Defaults to project ID."
+    )
+
+    # --- TTS Settings Options (CLI Overrides) ---
+    parser.add_argument("--tts-provider", help="TTS Provider (e.g., google, openai)")
+    parser.add_argument("--tts-model", help="TTS Model name")
+    parser.add_argument("--tts-voice", help="TTS Voice/Speaker setting")
+    parser.add_argument("--prompt", help="Override TTS system prompt")
+
+    # --- Other Options ---
+    parser.add_argument(
+        "--debug",
+        action="store_true",
+        help="Enable debug mode (Verbose logging, etc)."
+    )
+
+    args = parser.parse_args()
+
+    # Exit if no action is specified
+    if not args.pptx and not args.video:
+        parser.print_help()
+        sys.exit(1)
+
+    # 1. Initialize Movie instance (Load configuration files)
+    try:
+        movie = slidemovie.Movie()
+    except NameError:
+        logger.error("Movie class is not defined. Make sure to import it correctly.")
+        sys.exit(1)
+    except Exception as e:
+        logger.error(f"Failed to initialize Movie class: {e}")
+        sys.exit(1)
+
+    # 2. Override settings with CLI options
+    if args.tts_provider:
+        movie.tts_provider = args.tts_provider
+    if args.tts_model:
+        movie.tts_model = args.tts_model
+    if args.tts_voice:
+        movie.tts_voice = args.tts_voice
+    if args.prompt:
+        movie.prompt = args.prompt
+    
+    if args.debug:
+        movie.ffmpeg_loglevel = 'info'
+        movie.show_skip = True
+        logger.setLevel(logging.DEBUG)
+        logger.info("Debug mode enabled.")
+
+    # 3. Configure Path Settings
+    try:
+        if args.sub:
+            # Hierarchical Mode (Parent/Child)
+            logger.info(f"Configuring subproject paths: {args.project_name}/{args.sub}")
+            movie.configure_subproject_paths(
+                parent_project_name=args.project_name,
+                subproject_name=args.sub,
+                source_parent_dir=args.source_dir,
+                output_root_dir=args.output_root,
+                output_filename=args.filename
+            )
+        else:
+            # Standard Mode (Flat)
+            logger.info(f"Configuring project paths: {args.project_name}")
+            movie.configure_project_paths(
+                project_name=args.project_name,
+                source_dir=args.source_dir,
+                output_root_dir=args.output_root,
+                output_filename=args.filename
+            )
+    except Exception as e:
+        logger.error(f"Failed to configure paths: {e}")
+        sys.exit(1)
+
+    # 4. Execute Actions
+
+    # Generate PPTX (--pptx)
+    if args.pptx:
+        logger.info("=" * 60)
+        logger.info("MODE: Build Slide PPTX")
+        logger.info("=" * 60)
+        movie.build_slide_pptx()
+        logger.info("PPTX generation process finished.")
+        if not args.video:
+            logger.info("Please edit the generated PPTX file and run with --video to create the movie.")
+
+    # Generate Video (--video)
+    if args.video:
+        logger.info("=" * 60)
+        logger.info("MODE: Build All Video Assets")
+        logger.info("=" * 60)
+        movie.build_all()
+        
+        logger.info("All video processes finished.")
+
+if __name__ == "__main__":
+    main()