aeset 0.1.0__tar.gz

aeset-0.1.0/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: aeset
+Version: 0.1.0
+Summary: A macOS CLI tool for After Effects project scaffolding
+Author-email: Ahmed Alghali <a7medalghali777@gmail.com>
+Project-URL: Homepage, https://github.com/a7med7x7/aeset
+Project-URL: Bug Tracker, https://github.com/a7med7x7/aeset/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: click
+Requires-Dist: questionary
+
+# Aeset — After Effects Project Scaffolding Tool
+
+Every video editor or motion designer wastes 10–20 minutes at the start of every project doing the exact same thing: creating folders by hand, naming them consistently, opening After Effects, and setting up a new composition with the right resolution, framerate, and duration. It is not creative work. It is repetitive work. Multiply it by 50 projects a year and you have lost a full work week to folder creation and blank composition setup.
+
+Aeset is a tool built to solve this for After Effects on macOS. It takes the "scaffolding" logic used by software developers and applies it to the motion design world.
+
+## 1. What The Tool Does
+
+The user opens their terminal, navigates to where they want the project to live, and runs:
+
+```bash
+aeset
+```
+
+The tool then asks a series of interactive questions:
+- Project name (e.g., Nike_Ident_2026)
+- Project type (Commercial, Personal, etc.)
+- Resolution (Full HD, 4K, Vertical, etc.)
+- Frame rate (24, 25, 30, 60 fps)
+- Duration in seconds
+- Color space (sRGB, Rec. 709, ACES)
+
+After those answers, the tool:
+1. Creates a standardized folder tree inside a new project directory.
+2. Copies a blank .aep template file into the project folder.
+3. Generates a small ExtendScript .jsx file containing the user's specs.
+4. Opens After Effects with the project file via a macOS system call.
+5. Fires an AppleScript command that tells After Effects to run the .jsx, which creates the composition and internal project bins (folders) automatically.
+
+## 2. Folder Structure Generated
+
+Aeset generates a directory layout that follows conventions used by professional motion studios. The core principle is: never mix source files with outputs.
+
+### On Disk:
+```
+<ProjectName>/
+├── project/
+│   ├── <ProjectName>.aep       (copy of blank .aep template)
+│   └── setup.jsx               (temporary setup script)
+├── footage/
+│   ├── video/                  (raw video clips)
+│   ├── audio/                  (music, SFX, voiceover)
+│   └── renders/                (outputs from C4D, Blender, etc.)
+├── assets/
+│   ├── images/                 (static graphics, PNGs, PSDs, AI files)
+│   ├── fonts/                  (local fonts scoped to this project)
+│   └── documents/              (briefs, scripts, reference PDFs)
+├── exports/
+│   ├── drafts/                 (work-in-progress renders)
+│   └── final/                  (delivered, approved renders)
+└── README.md                   (auto-generated project notes)
+```
+
+### Inside After Effects:
+The tool also creates corresponding bins in the Project Panel to keep your workspace clean:
+- _COMPS (containing your main composition)
+- _FOOTAGE
+- _ASSETS
+- _AUDIO
+
+## 3. The Mechanism
+
+### The .aep file
+An .aep file is a binary format that cannot be easily generated by code. Because of this, Aeset ships with a hand-crafted blank .aep template. Every time the tool runs, it copies this template and renames it.
+
+### The .jsx file
+The tool generates a plain text ExtendScript file at runtime. This script has full programmatic access to After Effects. It uses the specs you provided in the terminal to build your composition and organize your project panel.
+
+### The AppleScript Trigger
+The .jsx is triggered explicitly after After Effects opens using a macOS AppleScript command (DoScript). This bridges the gap between the Python-based CLI and the Adobe environment.
+
+## 4. Installation and Requirements
+
+### Installation
+Aeset can be installed via pip:
+```bash
+pip install aeset
+```
+
+### Requirements
+- macOS: AppleScript and the 'open' command are macOS-specific.
+- Adobe After Effects 2025: The tool is currently configured to target the 2025 version.
+- Python 3.11+
+
+## 5. Constraints and Assumptions
+
+- No Adobe credentials required: The tool uses only local scripting.
+- After Effects must already be installed: The tool does not manage the AE installation itself.
+- Local execution: All files are generated and stored locally on your machine.

aeset-0.1.0/README.md

@@ -0,0 +1,89 @@
+# Aeset — After Effects Project Scaffolding Tool
+
+Every video editor or motion designer wastes 10–20 minutes at the start of every project doing the exact same thing: creating folders by hand, naming them consistently, opening After Effects, and setting up a new composition with the right resolution, framerate, and duration. It is not creative work. It is repetitive work. Multiply it by 50 projects a year and you have lost a full work week to folder creation and blank composition setup.
+
+Aeset is a tool built to solve this for After Effects on macOS. It takes the "scaffolding" logic used by software developers and applies it to the motion design world.
+
+## 1. What The Tool Does
+
+The user opens their terminal, navigates to where they want the project to live, and runs:
+
+```bash
+aeset
+```
+
+The tool then asks a series of interactive questions:
+- Project name (e.g., Nike_Ident_2026)
+- Project type (Commercial, Personal, etc.)
+- Resolution (Full HD, 4K, Vertical, etc.)
+- Frame rate (24, 25, 30, 60 fps)
+- Duration in seconds
+- Color space (sRGB, Rec. 709, ACES)
+
+After those answers, the tool:
+1. Creates a standardized folder tree inside a new project directory.
+2. Copies a blank .aep template file into the project folder.
+3. Generates a small ExtendScript .jsx file containing the user's specs.
+4. Opens After Effects with the project file via a macOS system call.
+5. Fires an AppleScript command that tells After Effects to run the .jsx, which creates the composition and internal project bins (folders) automatically.
+
+## 2. Folder Structure Generated
+
+Aeset generates a directory layout that follows conventions used by professional motion studios. The core principle is: never mix source files with outputs.
+
+### On Disk:
+```
+<ProjectName>/
+├── project/
+│   ├── <ProjectName>.aep       (copy of blank .aep template)
+│   └── setup.jsx               (temporary setup script)
+├── footage/
+│   ├── video/                  (raw video clips)
+│   ├── audio/                  (music, SFX, voiceover)
+│   └── renders/                (outputs from C4D, Blender, etc.)
+├── assets/
+│   ├── images/                 (static graphics, PNGs, PSDs, AI files)
+│   ├── fonts/                  (local fonts scoped to this project)
+│   └── documents/              (briefs, scripts, reference PDFs)
+├── exports/
+│   ├── drafts/                 (work-in-progress renders)
+│   └── final/                  (delivered, approved renders)
+└── README.md                   (auto-generated project notes)
+```
+
+### Inside After Effects:
+The tool also creates corresponding bins in the Project Panel to keep your workspace clean:
+- _COMPS (containing your main composition)
+- _FOOTAGE
+- _ASSETS
+- _AUDIO
+
+## 3. The Mechanism
+
+### The .aep file
+An .aep file is a binary format that cannot be easily generated by code. Because of this, Aeset ships with a hand-crafted blank .aep template. Every time the tool runs, it copies this template and renames it.
+
+### The .jsx file
+The tool generates a plain text ExtendScript file at runtime. This script has full programmatic access to After Effects. It uses the specs you provided in the terminal to build your composition and organize your project panel.
+
+### The AppleScript Trigger
+The .jsx is triggered explicitly after After Effects opens using a macOS AppleScript command (DoScript). This bridges the gap between the Python-based CLI and the Adobe environment.
+
+## 4. Installation and Requirements
+
+### Installation
+Aeset can be installed via pip:
+```bash
+pip install aeset
+```
+
+### Requirements
+- macOS: AppleScript and the 'open' command are macOS-specific.
+- Adobe After Effects 2025: The tool is currently configured to target the 2025 version.
+- Python 3.11+
+
+## 5. Constraints and Assumptions
+
+- No Adobe credentials required: The tool uses only local scripting.
+- After Effects must already be installed: The tool does not manage the AE installation itself.
+- Local execution: All files are generated and stored locally on your machine.

aeset-0.1.0/aeset/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

aeset-0.1.0/aeset/cli.py

@@ -0,0 +1,100 @@
+import click
+import questionary
+import pathlib
+from datetime import datetime
+from .scaffold import create_project_folders, generate_jsx, copy_template_aep, generate_readme
+from .launcher import launch_after_effects, run_jsx_via_applescript
+
+@click.command()
+@click.option('--no-launch', is_flag=True, help="Create the project but do not launch After Effects.")
+def main(no_launch):
+    """Aeset — After Effects Project Scaffolding Tool."""
+    
+    click.echo(click.style("\n🚀 Aeset — After Effects Project Scaffolder\n", fg="cyan", bold=True))
+
+    # 1. Collect inputs
+    project_name = questionary.text(
+        "Project name",
+        validate=lambda text: len(text) > 0 or "Project name cannot be empty."
+    ).ask()
+    
+    if not project_name:
+        return
+
+    project_type = questionary.select(
+        "Project type",
+        choices=["Commercial", "Personal", "Motion Test", "Music Video"]
+    ).ask()
+
+    resolution = questionary.select(
+        "Resolution",
+        choices=[
+            "1920×1080 (Full HD)",
+            "3840×2160 (4K)",
+            "1080×1080 (Square / Instagram)",
+            "1080×1920 (Vertical / Reels)"
+        ]
+    ).ask()
+    # Clean up resolution choice
+    resolution = resolution.split(" ")[0]
+
+    fps = questionary.select(
+        "Frame rate",
+        choices=["24", "25", "30", "60"]
+    ).ask()
+    fps = int(fps)
+
+    duration = questionary.text(
+        "Duration (seconds)",
+        default="10",
+        validate=lambda text: text.isdigit() or "Duration must be an integer."
+    ).ask()
+    duration = int(duration)
+
+    color_space = questionary.select(
+        "Color space",
+        choices=["sRGB", "Rec. 709", "ACES"]
+    ).ask()
+
+    # Create project directory
+    project_path = pathlib.Path.cwd() / project_name
+    if project_path.exists():
+        if not questionary.confirm(f"Directory {project_name} already exists. Overwrite?").ask():
+            click.echo("Aborted.")
+            return
+
+    # 2. Scaffolding
+    config = {
+        "type": project_type,
+        "resolution": resolution,
+        "fps": fps,
+        "duration": duration,
+        "color_space": color_space,
+        "date": datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+    }
+
+    click.echo(f"✔ Creating {project_name}/...")
+    create_project_folders(project_path)
+    
+    click.echo("✔ Copying project template...")
+    aep_path = copy_template_aep(project_path, project_name)
+    
+    click.echo("✔ Generating composition config...")
+    jsx_path = generate_jsx(project_path, project_name, config)
+    
+    click.echo("✔ Generating README.md...")
+    generate_readme(project_path, project_name, config)
+
+    # 3. Launch
+    if not no_launch:
+        click.echo("✔ Opening After Effects...")
+        if launch_after_effects(aep_path):
+            click.echo("✔ Triggering setup script...")
+            run_jsx_via_applescript(jsx_path)
+        else:
+            click.echo(click.style("✘ Could not launch After Effects automatically.", fg="red"))
+    
+    click.echo(click.style(f"\n🎉 Done! Project {project_name} is ready.\n", fg="green", bold=True))
+
+if __name__ == "__main__":
+    main()

aeset-0.1.0/aeset/launcher.py

@@ -0,0 +1,33 @@
+import subprocess
+import time
+import pathlib
+
+def launch_after_effects(aep_path: pathlib.Path, ae_version: str = "Adobe After Effects 2025"):
+    """Launches After Effects and opens the specified .aep file."""
+    abs_path = str(aep_path.resolve())
+    
+    # Use 'open' command which is usually most reliable for launching with a file
+    try:
+        subprocess.run(["open", abs_path, "-a", ae_version], check=True)
+        return True
+    except Exception as e:
+        print(f"Error opening project: {e}")
+        return False
+
+def run_jsx_via_applescript(jsx_path: pathlib.Path, ae_version: str = "Adobe After Effects 2025"):
+    """Triggers a .jsx script in After Effects using AppleScript DoScript."""
+    # Use absolute path and ensure it's escaped for JavaScript
+    script_path = str(jsx_path.absolute())
+    
+    # We send a piece of JavaScript code to AE: $.evalFile("/path/to/script.jsx");
+    js_to_run = f"$.evalFile('{script_path}');"
+    applescript = f'tell application "{ae_version}" to DoScript "{js_to_run}"'
+    
+    try:
+        # Give AE a moment to open/load the project before sending the command
+        time.sleep(10) 
+        subprocess.run(["osascript", "-e", applescript], check=True)
+        return True
+    except subprocess.CalledProcessError as e:
+        print(f"Error running AppleScript: {e}")
+        return False

aeset-0.1.0/aeset/scaffold.py

@@ -0,0 +1,96 @@
+import pathlib
+import shutil
+from typing import Dict, Any
+
+def create_project_folders(project_path: pathlib.Path):
+    """Creates the standard folder structure for an After Effects project."""
+    folders = [
+        "project",
+        "footage/video",
+        "footage/audio",
+        "footage/renders",
+        "assets/images",
+        "assets/fonts",
+        "assets/documents",
+        "exports/drafts",
+        "exports/final",
+    ]
+    for folder in folders:
+        (project_path / folder).mkdir(parents=True, exist_ok=True)
+
+def generate_jsx(project_path: pathlib.Path, project_name: str, config: Dict[str, Any]):
+    """Generates an ExtendScript .jsx file with the project configuration."""
+    # resolution is "1920×1080"
+    res_parts = config["resolution"].split("×")
+    width = int(res_parts[0])
+    height = int(res_parts[1])
+    
+    fps = config["fps"]
+    duration = config["duration"]
+    
+    jsx_content = f"""// Auto-generated by aeset — do not edit manually
+var projectName = "{project_name}";
+var width       = {width};
+var height      = {height};
+var fps         = {fps};
+var duration    = {duration};
+
+app.beginUndoGroup("Scaffold Project");
+
+// 1. Create Folder Structure in AE Project Panel
+var compFolder    = app.project.items.addFolder("_COMPS");
+var footageFolder = app.project.items.addFolder("_FOOTAGE");
+var assetsFolder  = app.project.items.addFolder("_ASSETS");
+var audioFolder   = app.project.items.addFolder("_AUDIO");
+
+// 2. Create the main Composition
+var comp = app.project.items.addComp(
+    projectName,
+    width,
+    height,
+    1.0,
+    duration,
+    fps
+);
+
+// 3. Move comp into the COMPS folder
+comp.parentFolder = compFolder;
+
+comp.openInViewer();
+app.endUndoGroup();
+
+app.project.save();
+"""
+    jsx_path = project_path / "project" / "setup.jsx"
+    jsx_path.write_text(jsx_content)
+    return jsx_path
+
+def copy_template_aep(project_path: pathlib.Path, project_name: str):
+    """Copies the blank .aep template to the new project directory."""
+    # it finds the template relative to this file
+    template_path = pathlib.Path(__file__).parent / "templates" / "blank.aep"
+    dest_path = project_path / "project" / f"{project_name}.aep"
+    
+    if not template_path.exists():
+        # For development, if blank.aep isn't there, it create a placeholder
+        template_path.parent.mkdir(parents=True, exist_ok=True)
+        template_path.write_text("DUMMY AEP BINARY CONTENT")
+        
+    shutil.copy2(template_path, dest_path)
+    return dest_path
+
+def generate_readme(project_path: pathlib.Path, project_name: str, config: Dict[str, Any]):
+    """Generates a README.md for the project with metadata."""
+    readme_content = f"""# {project_name}
+
+**Project Type:** {config["type"]}
+**Resolution:** {config["resolution"]}
+**Frame Rate:** {config["fps"]} fps
+**Duration:** {config["duration"]} seconds
+**Color Space:** {config["color_space"]}
+**Created:** {config["date"]}
+
+---
+Auto-generated by aeset.
+"""
+    (project_path / "README.md").write_text(readme_content)

aeset-0.1.0/aeset.egg-info/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: aeset
+Version: 0.1.0
+Summary: A macOS CLI tool for After Effects project scaffolding
+Author-email: Ahmed Alghali <a7medalghali777@gmail.com>
+Project-URL: Homepage, https://github.com/a7med7x7/aeset
+Project-URL: Bug Tracker, https://github.com/a7med7x7/aeset/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: click
+Requires-Dist: questionary
+
+# Aeset — After Effects Project Scaffolding Tool
+
+Every video editor or motion designer wastes 10–20 minutes at the start of every project doing the exact same thing: creating folders by hand, naming them consistently, opening After Effects, and setting up a new composition with the right resolution, framerate, and duration. It is not creative work. It is repetitive work. Multiply it by 50 projects a year and you have lost a full work week to folder creation and blank composition setup.
+
+Aeset is a tool built to solve this for After Effects on macOS. It takes the "scaffolding" logic used by software developers and applies it to the motion design world.
+
+## 1. What The Tool Does
+
+The user opens their terminal, navigates to where they want the project to live, and runs:
+
+```bash
+aeset
+```
+
+The tool then asks a series of interactive questions:
+- Project name (e.g., Nike_Ident_2026)
+- Project type (Commercial, Personal, etc.)
+- Resolution (Full HD, 4K, Vertical, etc.)
+- Frame rate (24, 25, 30, 60 fps)
+- Duration in seconds
+- Color space (sRGB, Rec. 709, ACES)
+
+After those answers, the tool:
+1. Creates a standardized folder tree inside a new project directory.
+2. Copies a blank .aep template file into the project folder.
+3. Generates a small ExtendScript .jsx file containing the user's specs.
+4. Opens After Effects with the project file via a macOS system call.
+5. Fires an AppleScript command that tells After Effects to run the .jsx, which creates the composition and internal project bins (folders) automatically.
+
+## 2. Folder Structure Generated
+
+Aeset generates a directory layout that follows conventions used by professional motion studios. The core principle is: never mix source files with outputs.
+
+### On Disk:
+```
+<ProjectName>/
+├── project/
+│   ├── <ProjectName>.aep       (copy of blank .aep template)
+│   └── setup.jsx               (temporary setup script)
+├── footage/
+│   ├── video/                  (raw video clips)
+│   ├── audio/                  (music, SFX, voiceover)
+│   └── renders/                (outputs from C4D, Blender, etc.)
+├── assets/
+│   ├── images/                 (static graphics, PNGs, PSDs, AI files)
+│   ├── fonts/                  (local fonts scoped to this project)
+│   └── documents/              (briefs, scripts, reference PDFs)
+├── exports/
+│   ├── drafts/                 (work-in-progress renders)
+│   └── final/                  (delivered, approved renders)
+└── README.md                   (auto-generated project notes)
+```
+
+### Inside After Effects:
+The tool also creates corresponding bins in the Project Panel to keep your workspace clean:
+- _COMPS (containing your main composition)
+- _FOOTAGE
+- _ASSETS
+- _AUDIO
+
+## 3. The Mechanism
+
+### The .aep file
+An .aep file is a binary format that cannot be easily generated by code. Because of this, Aeset ships with a hand-crafted blank .aep template. Every time the tool runs, it copies this template and renames it.
+
+### The .jsx file
+The tool generates a plain text ExtendScript file at runtime. This script has full programmatic access to After Effects. It uses the specs you provided in the terminal to build your composition and organize your project panel.
+
+### The AppleScript Trigger
+The .jsx is triggered explicitly after After Effects opens using a macOS AppleScript command (DoScript). This bridges the gap between the Python-based CLI and the Adobe environment.
+
+## 4. Installation and Requirements
+
+### Installation
+Aeset can be installed via pip:
+```bash
+pip install aeset
+```
+
+### Requirements
+- macOS: AppleScript and the 'open' command are macOS-specific.
+- Adobe After Effects 2025: The tool is currently configured to target the 2025 version.
+- Python 3.11+
+
+## 5. Constraints and Assumptions
+
+- No Adobe credentials required: The tool uses only local scripting.
+- After Effects must already be installed: The tool does not manage the AE installation itself.
+- Local execution: All files are generated and stored locally on your machine.

aeset-0.1.0/aeset.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+aeset/__init__.py
+aeset/cli.py
+aeset/launcher.py
+aeset/scaffold.py
+aeset.egg-info/PKG-INFO
+aeset.egg-info/SOURCES.txt
+aeset.egg-info/dependency_links.txt
+aeset.egg-info/entry_points.txt
+aeset.egg-info/requires.txt
+aeset.egg-info/top_level.txt
+aeset/templates/blank.aep

aeset-0.1.0/aeset.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aeset-0.1.0/aeset.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+aeset = aeset.cli:main

aeset-0.1.0/aeset.egg-info/requires.txt

@@ -0,0 +1,2 @@
+click
+questionary

aeset-0.1.0/aeset.egg-info/top_level.txt

@@ -0,0 +1 @@
+aeset

aeset-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "aeset"
+version = "0.1.0"
+description = "A macOS CLI tool for After Effects project scaffolding"
+readme = "README.md"
+authors = [
+    { name = "Ahmed Alghali", email = "a7medalghali777@gmail.com" }
+]
+requires-python = ">=3.11"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS :: MacOS X",
+    "Topic :: Multimedia :: Video",
+]
+dependencies = [
+    "click",
+    "questionary",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/a7med7x7/aeset"
+"Bug Tracker" = "https://github.com/a7med7x7/aeset/issues"
+
+[project.scripts]
+aeset = "aeset.cli:main"
+
+[tool.setuptools]
+packages = ["aeset"]
+
+[tool.setuptools.package-data]
+aeset = ["templates/*.aep"]

aeset-0.1.0/setup.cfg

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