v3.4.0: Enhanced Navigation & Smart Shot Management

What's New in v3.4.0 🎬

Get ready for the ultimate media browsing experience! This release supercharges your workflow with some seriously cool features:

✨ Key Highlights

• 🎯 Smart Shot Numbering - No more wasted numbers! Our new gap-filling system keeps your sequences tidy
• 🎮 Enhanced Drag & Drop - Fancy new visual handles make reorganizing shots a breeze
• 🔁 Video Loops - Watch your creations on repeat without lifting a finger
• 🎥 Modal Navigation - Arrow keys + buttons = seamless browsing between shots
• 🔍 Version Detection - Smarter tracking that actually understands your existing assets

🚀 The Story Behind This Release

We noticed that navigating between media and managing shot sequences could be smoother. So we went all in on making your creative workflow more intuitive and enjoyable!

From the moment you open a modal to when you're organizing your project timeline, every interaction has been thoughtfully enhanced.

🧪 Testing Notes

Try these workflows to experience the magic:

1. Create multiple shots and watch the smart numbering in action
2. Drag shots around using the new visual handles
3. Open any media modal and use arrow keys to navigate
4. Upload multiple versions of assets and see the improved detection

This release was powered by Deepseek v3.1 with Cline's Plan/Act workflow, with all changes manually reviewed and refined for quality.

Breaking Changes: None - everything's backward compatible! 🎉

What's Changed

• v3.4.0: Enhanced Navigation & Smart Shot Management by @taruma in #11

Full Changelog: v3.3.0...v3.4.0

v3.3.0: Enhanced Media Serving & UI Responsiveness

This minor release introduces enhanced media serving capabilities, improved UI responsiveness, and code quality refinements for better user experience and maintainability.

🚀 Key Features

Media Serving Enhancements:

• Direct Media Endpoints: Added new routes /image/<shot_name> and /video/<shot_name> to serve promoted media files from latest_images and latest_videos directories
• Cache-Busting Parameters: Added timestamp query parameters to media URLs to prevent browser caching issues
• Enhanced Media Modal UI: Improved modal interfaces for both images and videos with responsive design and light theme support

Code Quality & Performance:

• CSS Restructuring: Reorganized main stylesheet with improved organization and maintainability
• Shot Order Persistence: Extracted shot order loading/saving into dedicated methods with improved error handling (close #7 )
• Server Reload Integration: Replaced local shot updates with server reloads for fresh data display

🔧 Technical Improvements

• UI Consistency: Enhanced TOC auto-refresh after saving shot order changes
• Code Formatting: Improved code readability by removing excessive whitespace
• Integration Fix: Fixed shot order persistence when creating new shots between existing ones

🎯 Impact

This release enhances media viewing capabilities and code maintainability while improving overall user experience for AI filmmaking workflows.

Full Changelog: v3.2.0...v3.3.0

v3.2.0

Hey ShotBuddy community! 🎥 This minor update polishes the app with better code hygiene, tighter security, and smoother interactions for uploading and exporting your AI filmmaking assets. No big disruptions—just enhancements to make your workflow feel snappier and safer. Let's dive in!

✨ What's New

• Ruff Linting Setup 🛡️: We've added a smart code checker (Ruff) to keep things clean and secure. It catches style slips and potential issues early, so your projects stay robust without extra effort from you.

🔄 What's Improved

• Local-Only Server Access 🔒: The app now runs securely on your machine only (bound to localhost). Perfect for dev work—keeps things private and reduces risks.
• Cleaner Code Organization 📂: Imports are tidied up across the app, making it easier to maintain and extend for future features.

🐛 Bugs Fixed & Tweaks

• Linting & Security Cleanups ✅: Squashed formatting quirks, empty error handlers, and safe subprocess calls. Your code runs smoother and more securely now.
• Faster Upload Feedback ⚡ (Fixes #5): When uploading shots, you'll see loading spinners and instant updates—no more staring at a blank screen! Makes asset handling feel quicker.
• Richer Export Summaries 📊 (Fixes #4): Exports now pack in project details like title and version. Get better context in your files for reviews or backups.

💡 Why This Matters

These tweaks boost development quality behind the scenes while making everyday tasks like uploads and exports more intuitive. Whether you're storyboarding AI scenes or managing project assets, v3.2.0 keeps things professional and hassle-free. Backward-compatible, so your existing projects are untouched!

Pro Tip: Run uv run ruff check . to lint your setup, or just enjoy the improved flows in the browser.

Developed with AI help via Cline (Grok-4-Fast), but hand-reviewed for top-notch quality. Thanks for using ShotBuddy—drop feedback on GitHub! 🌟

Full Changelog: CHANGELOG.md

v3.1.0

What's Changed

• feat: Update to v3.1.0 - Project Timestamp Preservation & macOS Folder Support by @taruma in #3

New Contributors

• @taruma made their first contribution in #3

Full Changelog: v3.0.0...v3.1.0

v3.0.0

This major release overhauls project management with comprehensive metadata, powerful new export options, and a suite of UI/UX refinements designed to streamline professional AI filmmaking workflows.

Key Features

📝 Advanced Project Information

• Full Project Metadata: Manage essential project details including title, version, short description, and notes directly within the app.
• Enhanced UI Display: The project header now displays the version and subtitle for at-a-glance context.
• Automatic Timestamps: Projects are now automatically timestamped on any significant change, making it easy to track recent activity.

📤 Powerful Export Capabilities

• Selective Asset Export: A new export modal allows you to choose whether to export the latest images, videos, or both.
• Structured Exports: Assets are exported into a named directory with ordered prefixes, perfect for backup or use in other applications.
• Metadata Generation: Optionally generate a metadata file alongside your exported assets for better documentation.

✨ Streamlined Project Access & Workflow

• Native Folder Picker: Easily create or open projects using your system's native file dialog.
• Smarter Project Memory: The app now remembers your last-used project location and improves how recent projects are displayed.
• Improved Navigation: Added "Back to Menu" and "Back to Top" buttons for a smoother user experience.

🎨 UI & UX Refinements

• Modernized Interface: Replaced emojis with crisp SVG icons and added helpful tooltips for shot prompts.
• Better Organization: The archived shots section is now collapsible to reduce clutter, and the shot grid layout has been improved for readability.
• Polished Theming: Implemented major fixes for the Light Theme, ensuring better contrast and visual consistency across all components.

Technical Details

• Performance: Optimized UI rendering with targeted DOM updates and improved caching mechanisms.
• Code Quality: Refactored project routes and event handling for better maintainability.
• Compatibility: All changes maintain backward compatibility with existing projects. Note the updated Python version requirement.

Installation

This version requires Python >=3.13.1. Please ensure your environment is updated before installation. Otherwise, no special migration steps are required.

Attribution

This release was developed with AI assistance using various tools including Qwen Code, GPT-5, Grok Code Fast 1, and Code Supernova. All generated changes were manually reviewed, tested, and refined by the maintainer, Taruma Sakti, to ensure quality and alignment with project goals.

---

For a detailed list of all changes, see CHANGELOG.md

v2.1.0

This minor release introduces enhanced backend performance and new reordering capabilities for improved project management workflows.

Key Features

🚀 Enhanced Shot Reordering

• New modal interface with filtering and drag support
• Improved project organization workflow
• Better user experience for managing shot sequences

🔧 Backend Improvements

• Refactored thumbnail cache to per-project directories
• Optimized file handling and caching mechanisms
• Enhanced service layer architecture

🎨 UI Enhancements

• Improved thumbnail aspect ratio handling
• Updated grid layout and header styles
• Better visual consistency across themes

📱 Progressive Web App Support

• Added favicon and manifest files
• Improved web app experience
• Better mobile and desktop integration

Technical Details

• Performance: Optimized caching and file handling
• Code Quality: Enhanced architecture and route handling
• Compatibility: All changes maintain backward compatibility

Installation

No special installation steps required. The update maintains full compatibility with existing projects.

Attribution

Developed with AI assistance using Cline's Plan/Act workflow, powered by GPT-5 and Qwen3 Coder models. All changes reviewed and tested by maintainer Taruma Sakti.

---

For detailed changelog, see CHANGELOG.md

v2.0.0: Navigate, Reorder, Illuminate

This major release extends the original Shotbuddy v1.0.0 by Albert Bozesan with new features focused on enhanced navigation, asset management, and usability for AI filmmaking workflows. All changes are backward-compatible, preserving legacy single-image support while adding project-scoped metadata and modern UI elements.

Added

• Table of Shots (TOC) Panel: Responsive side panel for project overviews in docked or drawer modes. Supports shot filtering, quick navigation, active/archived separation, and highlighting. Integrates with reordering and themes.

• Drag-and-Drop Shot Reordering: Reorder shots in the grid with persistent per-project saving. Inline insertion points with "New Shot +" buttons.

• Shot Archiving: Toggle shots to hide inactive ones from the main grid while retaining assets. Dedicated archived section with one-click restore.

• Human-Readable Display Names: Custom titles for shots (e.g., "Opening Scene" for SH010), editable in grid/TOC. Stored in project-scoped meta.json for multi-project support.

• Action Column with Icon Buttons: Leftmost grid column for quick actions like archive/unarchive, using accessible SVG icons and tooltips.

• First/Last Image Variants: Separate slots for opening/closing frames per shot. Independent versioning, prompts, thumbnails, and promotion; legacy images map to first variant.

• Asset Version Promotion and Cycling: Click version badges to cycle/promote finals. Supports images/videos; auto-updates thumbnails and markers for up to 999 versions.

• Asset Captions: Editable text under media previews (first/last images, videos). Auto-saves to per-shot captions.json for notes or feedback.

• Auto-Resizing Notes: Dynamic textarea expansion for shot notes, removing scrollbars for better editing.

• Light/Dark Theme Toggle: Header button to switch themes, persisted in localStorage. Full UI overrides for contrast and readability.

• Refined Header and Menu Layout: Container-based structure with improved spacing, shadows, and borders.

• uv Dependency Management: Support for uv and pyproject.toml for reproducible environments, replacing manual venv/pip setup.

• Expanded Documentation: Detailed README with feature guides and GIF demos (reordering, archiving, TOC, display names, versions, variants, captions, notes, themes). Comprehensive AGENTS.md contributor guide (setup, config, layout, PEP8, testing).

Changed

• Project-Scoped Metadata: Shot meta (display names, captions) now stored per-project for robust multi-project handling. Removed legacy app-level files.

• Footer and Attribution: Updated index.html footer with maintainer credit, GitHub link, and Cline attribution. Dual copyright in LICENSE.txt (Taruma Sakti / Albert Bozesan).

• README Structure: New "New Features in This Fork" section with summarized enhancements and visuals. Updated pyproject.toml authors/URLs.

• Cursor Styles and Interactions: Default cursors for non-clickable thumbnails; removed unintended handlers. Pointer cursors for interactive elements.

Technical Updates

• API Endpoints: Added /reorder, /archive, /display-name, /caption, /promote for new features.
• File Structure: New .shot_order.json and .archived_shots.json per project; image variants use _first/_last prefixes.
• Dependencies: Flask, Flask-CORS, Pillow via pyproject.toml/requirements.txt.
• No Breaking Changes: Legacy workflows intact.

AI Development Attribution

This release was developed with AI assistance using Cline's Plan/Act workflow, powered by a mix of GPT-5 and Qwen3 Coder models. All generated changes were manually reviewed, tested, and refined by the maintainer, Taruma Sakti, to ensure quality and alignment with project goals.

This version streamlines storyboard management for larger projects. For full details and demos, see README.md.