Remove unfinished collaboration system and introduce detailed, consistent tooltips across the UI - and made codebase more explorable by making it modular - and updated documentation as well

Author: programmersd21

.gitignore

@@ -4,3 +4,4 @@ __pycache__/
 local/
 *.pyc
 *.zip
+*.rar

README.md

@@ -1,203 +1,22 @@
-# 🌿 EfficientManim — The Ultimate Node-Based Manim IDE
-
-![Icon](icon/icon.ico)
-
-[![IdeaCred](https://ideacred.com/api/badge/pro-grammer-SD/EfficientManim?style=for-the-badge)](https://ideacred.com/submissions)
-
-**🌈 Create mathematical animations visually with the power of Python, AI, and real-time collaboration.**
-
----
-
-## 🚀 Key Features
-
-### 🎬 Node-Based Visual Workflow
-- **Visual Editor:** Drag-and-drop Mobjects and Animations with intuitive wiring
-- **Infinite Canvas:** Pan and zoom freely to manage large node graphs
-- **Live Preview:** Real-time static previews of individual nodes
-- **Smart Connections:** Automatic wire validation and scene synchronization
-
-### 🎬 Multiple Scenes
-- Manage multiple scenes per project in the **Scenes** tab
-- Create, rename, delete, and switch between scenes — each with its own node graph
-- Scene state auto-saved and restored when switching
-
-### 📦 VGroup Utility
-- Select Mobject nodes → click **Create VGroup** in the **VGroups** tab
-- VGroup code automatically generated: `group_1 = VGroup(circle_1, square_1)`
-- Groups shown in expandable tree view with source badges (canvas / AI / snippet / GitHub)
-- Full member management: add, remove, highlight on canvas, copy code
-
----
-
-## 🤝 Live Collaboration
-
-EfficientManim supports **real-time multi-user editing** over a local network or on the same machine — no cloud accounts, no third-party services.
-
-### What It Is
-Two or more EfficientManim windows share the same node graph live. Every node move, property change, wire add/delete, and scene switch is broadcast as a JSON delta and applied to all connected instances within milliseconds. A 6-digit **PIN** identifies the session — easy to read aloud or paste into chat.
-
-### Starting a Session
-1. Open your project in EfficientManim.
-2. Click **Collaboration → Start Live Collaboration**.
-3. A dialog shows your PIN in large, bold text. Share it with collaborators.
-4. The toolbar shows a green ● and the active PIN.
-
-### Joining a Session
-1. Click **Collaboration → Join Collaboration**.
-2. Enter the 6-digit PIN.
-3. Click **Connect** — your canvas loads the host's full graph and live sync begins.
-
-### Multi-Window (Same Machine)
-Run `python main.py` a second time, join via the same PIN — both windows stay in sync.
-
-### Network Requirements
-- **Same machine:** No setup needed.
-- **LAN:** Host firewall must allow the ephemeral TCP port shown in the session dialog.
-- **Internet:** Not supported out-of-the-box; use a reverse proxy (e.g. `ngrok`) on the host.
-
-📖 Full details: [docs/live_collaboration.md](docs/live_collaboration.md)
-
----
-
-## 🤖 Gemini AI Integration
-
-### Code Generation
-- Describe animations in plain English — AI generates a complete `Scene.construct()` block
-- AI code parsed into typed, editable nodes with correct wiring
-- Streaming responses with real-time feedback in the AI Assistant dock
-
-### MCP Agent Mode
-- Gemini reads the live scene state as JSON and issues typed commands executed directly against the running app
-- No merge step — Gemini edits the graph the same way a human would
-- Full action log: **Help → MCP Agent → Show Action Log**
-
-### Auto Voiceover Agent
-- Analyzes all nodes, writes per-node scripts, generates TTS, attaches audio automatically
-- At render time, all segments merge into a synchronized voiceover track
-
-📖 Full details: [docs/ai_features.md](docs/ai_features.md)
-
----
-
-## 🎙️ AI Voiceover Studio
-- Gemini TTS with six voices: Puck, Charon, Kore, Fenrir, Aoede, Zephyr
-- Built-in audio player with play/pause/stop/seek and time display
-- Attach audio to any node — duration auto-syncs `run_time=`
-
----
-
-## 🐙 GitHub Snippet Loader
-- Clone any GitHub repository and browse its `.py` files
-- Double-click to load into the AI panel as a snippet
-- VGroup definitions auto-detected and registered
-
----
-
-## ⭐ Recents Panel
-- Top-5 most-used Mobjects and Animations by actual insertion count
-- Persisted to `~/.efficientmanim/usage.json`
-- Double-click to instantly add to canvas
-
----
-
-## ⌨️ Editable Keybindings
-- **Help → Edit Keybindings…** — changes apply instantly, no restart
-- Duplicate detection; persisted to `QSettings`
-
----
-
-## 📦 Portable Project Format (.efp)
-- ZIP-based: graph JSON + compiled code + all bundled media
-- Cross-platform — one file contains everything
-📖 Full details: [docs/efp_format.md](docs/efp_format.md)
-
----
-
-## 🎨 Manim Class Browser
-- 60+ Manim classes in 8 categories with real-time search filter
-- Double-click or drag to add node to canvas
-
----
-
-## 🎬 Professional Video Rendering
-- Full scene export to MP4/WebM, up to 4K, 15–60 FPS, four quality presets
-- Integrated video player for instant review
-
----
-
-## ✒️ LaTeX Studio
-- Live LaTeX preview via MathPad API
-- One-click apply to any `MathTex` or `Tex` node
-
----
-
-## 🔌 Plugin / Extension System
-- Extensions in `~/.efficientmanim/ext/<author>/<name>/`
-- Permission-gated: nodes, UI panels, timeline tracks, MCP hooks
-📖 Full details: [docs/plugin_api.md](docs/plugin_api.md)
-
----
-
-## 🏠 Home Screen
-
-```bash
-python home.py   # Home screen with recent projects
-python main.py   # Open editor directly
-```
-
----
-
-## ⌨️ Keyboard Shortcuts
-
-| Action | Shortcut | Action | Shortcut |
-|--------|----------|--------|----------|
-| New Project | `Ctrl+N` | Fit View | `Ctrl+0` |
-| Open Project | `Ctrl+O` | Zoom In | `Ctrl+=` |
-| Save Project | `Ctrl+S` | Zoom Out | `Ctrl+-` |
-| Save As | `Ctrl+Shift+S` | Auto-Layout | `Ctrl+L` |
-| Exit | `Ctrl+Q` | Export Code | `Ctrl+E` |
-| Undo | `Ctrl+Z` | Copy Code | `Ctrl+Shift+C` |
-| Redo | `Ctrl+Y` | Render Video | `Ctrl+R` |
-| Delete Selected | `Del` | Add Play Node | `Ctrl+Shift+P` |
-| Select All | `Ctrl+A` | Add Wait Node | `Ctrl+Shift+W` |
-| Create VGroup | `Ctrl+G` | Edit Keybindings | `Ctrl+,` |
-
-📖 Full reference: [docs/shortcuts.md](docs/shortcuts.md)
-
----
-
-## 📚 Documentation
-
-| Document | Contents |
-|---|---|
-| [docs/overview.md](docs/overview.md) | Architecture, modules, data flow |
-| [docs/setup.md](docs/setup.md) | Installation, requirements, first launch |
-| [docs/live_collaboration.md](docs/live_collaboration.md) | PIN sessions, delta sync, network setup |
-| [docs/node_reference.md](docs/node_reference.md) | All node types and properties |
-| [docs/ai_features.md](docs/ai_features.md) | Code gen, MCP agent, voiceover, LaTeX |
-| [docs/shortcuts.md](docs/shortcuts.md) | Full keyboard shortcut reference |
-| [docs/efp_format.md](docs/efp_format.md) | Project file format internals |
-| [docs/plugin_api.md](docs/plugin_api.md) | Extension / plugin development guide |
-| [docs/contributing.md](docs/contributing.md) | Dev setup, code style, PR guide |
-
----
-
-## 🛠️ Installation
-
-```bash
-git clone https://github.com/pro-grammer-SD/EfficientManim.git
-cd EfficientManim
-pip install -r requirements.txt
-python main.py
-```
-
-**Requirements:** Python 3.10+, FFmpeg (on PATH), Git, LaTeX (for MathTex)
-
-Full guide: [docs/setup.md](docs/setup.md)
-
----
-
-## 🌿 About
-
-© 2026 — Soumalya Das (@pro-grammer-SD) · Co-authored with Bailey Beber  
-Built with PySide6 · Manim · Google Gemini
+# EfficientManim
+
+EfficientManim is a node-based Manim editor that helps you build mathematical animations visually, preview quickly, and export clean Python code.
+
+## Highlights
+- Visual graph editor for Mobjects and Animations
+- Live preview rendering for quick iteration
+- Video render pipeline with quality presets
+- Gemini-powered helpers for code generation and voiceover
+
+## Quick Start
+1. Install dependencies:
+   ```bash
+   pip install -r requirements.txt
+   ```
+2. Run the app:
+   ```bash
+   python main.py
+   ```
+
+## Documentation
+See `docs/README.md` for architecture, workflow, and developer guidance.

app/api/extension_registry.py

@@ -1,3 +1,6 @@
+# ruff: noqa: E402
+from PySide6.QtWidgets import QMainWindow
+
 """
 extension_registry.py — Central registry for extension-provided panels
 
@@ -82,7 +85,7 @@ def realize_panels(self, main_window: "QMainWindow") -> Dict[str, Any]:
         """
         Create and add all registered panels to the main window.
 
-        Called once after EfficientManimWindow.__init__() completes.
+        Called once after __import__('ui.main_window').main_window.EfficientManimWindow.__init__() completes.
 
         Returns:
             {panel_name: widget_instance} for all successfully created panels

app/app_window.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+# -*- coding: utf-8 -*-
+
+from core.project_manager import ProjectManager
+
+
+def create_main_window():
+    from ui.main_window import EfficientManimWindow
+    window = EfficientManimWindow()
+    window.project_manager = ProjectManager(window)
+    return window

app/autosave_manager.py

@@ -54,7 +54,7 @@ def __init__(self):
         self._last_assets_hash = ""
         self._last_keybindings_hash = ""
 
-        # Compute functions (will be set by EfficientManimWindow)
+        # Compute functions (will be set by __import__('ui.main_window').main_window.EfficientManimWindow)
         self._compute_code_hash: Optional[Callable[[], str]] = None
         self._compute_graph_hash: Optional[Callable[[], str]] = None
         self._compute_assets_hash: Optional[Callable[[], str]] = None

app/extensions/animation_presets.py

@@ -1,3 +1,6 @@
+# ruff: noqa: E402
+from __future__ import annotations
+
 """
 Animation Presets Extension — ✨ Quick Effects
 
@@ -17,8 +20,6 @@
 can execute immediately.
 """
 
-from __future__ import annotations
-
 import logging
 import textwrap
 from typing import TYPE_CHECKING
@@ -370,7 +371,7 @@ def _get_selected_object_name(self) -> str:
         """
         Return the Python variable name for the currently selected graph node.
 
-        Walks up the widget tree to find EfficientManimWindow and inspects its
+        Walks up the widget tree to find __import__('ui.main_window').main_window.EfficientManimWindow and inspects its
         `scene.selectedItems()`.  Falls back to self._selected_obj.
         """
         try:
@@ -456,21 +457,27 @@ def _inject_and_render(self, preset_name: str, snippet: str, obj_name: str) -> b
     # ── Window helpers ────────────────────────────────────────────────────────
 
     def _get_main_window(self):
-        """Walk widget tree to find EfficientManimWindow."""
+        """Walk widget tree to find __import__('ui.main_window').main_window.EfficientManimWindow."""
         if self._main_window is not None:
             return self._main_window
         widget = self
         while widget is not None:
             # Import lazily to avoid circular deps at module load time
-            if type(widget).__name__ == "EfficientManimWindow":
+            if (
+                type(widget).__name__
+                == "__import__('ui.main_window').main_window.EfficientManimWindow"
+            ):
                 self._main_window = widget
                 return widget
             widget = widget.parent()
         # Fallback: search QApplication top-level windows
         app = QApplication.instance()
         if app:
             for w in app.topLevelWidgets():
-                if type(w).__name__ == "EfficientManimWindow":
+                if (
+                    type(w).__name__
+                    == "__import__('ui.main_window').main_window.EfficientManimWindow"
+                ):
                     self._main_window = w
                     return w
         return None

app/extensions/color_palette.py

@@ -284,7 +284,7 @@ def _darken_color(hex_color: str, factor: float = 0.8) -> str:
                 color.alpha(),
             )
             return color.name()
-        except:
+        except Exception:
             return "#1d4ed8"  # Default dark blue
 
     @staticmethod
@@ -299,7 +299,7 @@ def _lighten_color(hex_color: str, factor: float = 0.3) -> str:
                 color.alpha(),
             )
             return color.name()
-        except:
+        except Exception:
             return "#dbeafe"  # Default light blue
 
     def get_palette(self, name: str) -> list:

app/extensions/math_symbols.py

@@ -54,7 +54,7 @@ def setup(api):
 
 
 try:
-    from manim import Tex, VGroup
+    from manim import Tex
 
     MANIM_AVAILABLE = True
 except ImportError:

app/keybinding_registry.py

@@ -34,8 +34,8 @@
 from dataclasses import dataclass
 
 try:
-    from PySide6.QtCore import QObject, Signal, QSettings
-    from PySide6.QtGui import QKeySequence
+    from PySide6.QtCore import QObject, Signal
+    
 
     HAS_PYSIDE = True
 except ImportError:

app/layout_persistence.py

@@ -18,7 +18,7 @@
 import json
 import logging
 from pathlib import Path
-from typing import Dict, Any, Optional
+from typing import Dict, Any, Optional, Tuple
 
 LOGGER = logging.getLogger("layout_persistence")